MCP Gateway — Como Usar

Desenvolvedor

Pré-requisitos

Antes de conectar ao MCP Gateway, certifique-se de ter:

1. Acesso ao seu workspace Prodgy
2. Um API Token ou uma aplicação que suporte OAuth 2.1

Existem duas formas de conectar:

Método	Ideal para	Gerenciamento do token
API Token	CLIs e ferramentas locais (Claude Code, Cursor, Windsurf)	Manual — você gera e cola o token
OAuth 2.1	Aplicações web e plataformas	Automático — a aplicação cuida de tudo

---

Método 1: API Token (configuração manual)

Gere um API Token em Configurações do Workspace > Tokens de API, e configure sua ferramenta.

Opção A — Via CLI (recomendado para Claude Code)

claude mcp add --transport http prodgy https://sua-url-do-prodgy/mcp \
  --header "Authorization: Bearer prodgy_seu_token_aqui"

Isso grava automaticamente a configuração correta no seu arquivo .mcp.json.

Opção B — Configuração manual

Adicione o seguinte ao arquivo de configuração MCP da sua ferramenta de IA:

{
  "mcpServers": {
    "prodgy": {
      "type": "http",
      "url": "https://sua-url-do-prodgy/mcp",
      "headers": {
        "Authorization": "Bearer prodgy_seu_token_aqui"
      }
    }
  }
}

Cuidado

O campo "type": "http" é obrigatório ao editar o arquivo de configuração manualmente. Sem ele, o Claude Code não sabe como conectar ao servidor remoto. Se você usou o CLI (Opção A), esse campo é adicionado automaticamente.

Onde salvar

Ferramenta	Arquivo de configuração
Claude Code	.mcp.json (raiz do projeto) ou ~/.claude/mcp.json (global)
Cursor	.cursor/mcp.json (raiz do projeto)
Windsurf	~/.codeium/windsurf/mcp_config.json
Claude Desktop	Configurações MCP do Claude Desktop

Após salvar, reinicie sua ferramenta de IA. Você deverá ver as ferramentas do Prodgy listadas no painel de ferramentas MCP.

Nota

Use a mesma URL do seu workspace Prodgy, com o path /mcp.

---

Método 2: OAuth 2.1 (para aplicações que suportam)

Se a aplicação que você está usando suporta OAuth 2.1 (por exemplo, plataformas web, ferramentas de automação ou integrações customizadas), você pode conectá-la ao Prodgy sem gerar tokens manualmente.

O que você precisa fazer:

1. Na aplicação terceira, procure uma opção para adicionar um servidor MCP ou conexão externa
2. Informe a URL do MCP do Prodgy: https://sua-url-do-prodgy/mcp
3. A aplicação iniciará o fluxo OAuth automaticamente — você será redirecionado para o Prodgy
4. Faça login (se ainda não estiver), selecione a organização, o workspace e as permissões que deseja conceder
5. Clique em Autorizar — a aplicação está conectada

Pronto. A aplicação gerencia os tokens automaticamente — sem copiar/colar, sem se preocupar com expiração.

Nota

Nem todas as ferramentas suportam OAuth ainda. Ferramentas CLI como Claude Code, Cursor e Windsurf atualmente usam API Tokens (Método 1). Consulte a documentação da sua aplicação para verificar se ela suporta OAuth 2.1 para conexões MCP.

Após conectar, você pode gerenciar a aplicação em Configurações do Workspace > Apps — visualizar permissões, último uso e revogar acesso se necessário.

---

Verificando a Conexão

Uma vez configurado, você pode verificar a conexão pedindo à sua ferramenta de IA para:

1. Listar ferramentas — pergunte “Quais ferramentas do Prodgy estão disponíveis?” e verifique se as ferramentas da plataforma aparecem.
2. Obter contexto do projeto — pergunte “Obtenha o contexto do meu projeto Prodgy” para verificar a conectividade.
3. Buscar conhecimento — pergunte “Busque por [tópico] na base de conhecimento” para testar a busca RAG.

Solução de Problemas

Problema	Solução
Nenhuma ferramenta listada	Verifique se a URL na config está correta
Não conecta / sem resposta	Adicione "type": "http" na config MCP (obrigatório para servidores remotos)
Erro “Unauthorized”	Verifique se seu API Token é válido e tem as permissões corretas
”Connection refused”	Verifique a URL do Gateway com seu administrador
”Forbidden” em ferramentas restritas	Seu API Token deve pertencer a um usuário com role SUPERADMIN ou ADMIN

---

Usando as Ferramentas do Prodgy

Uma vez conectado, seu assistente de codificação tem acesso a todas as ferramentas do Prodgy. Aqui estão alguns casos de uso comuns:

Obter Contexto do Workspace

Peça à sua ferramenta de IA: “Obtenha o contexto do projeto Prodgy” — retorna visão do workspace, OKRs, público-alvo e integrações ativas.

Buscar na Base de Conhecimento

Pergunte: “Busque na base de conhecimento sobre fluxo de autenticação” — executa busca semântica (RAG) em todos os documentos indexados.

Gerenciar Itens de Trabalho

• “Crie um PBI para melhorias na autenticação de usuários”
• “Busque bugs abertos atribuídos a mim”
• “Atualize o item de trabalho #123 para status Done”

Executar Agentes

Pergunte: “Liste os agentes Prodgy disponíveis” e depois “Execute o agente de priorização de backlog” — aciona um agente de IA do Prodgy com suas próprias ferramentas e system prompt.

Instalar Integrações

Pergunte: “Mostre o catálogo de integrações” e depois “Instale a integração Azure DevOps com meu PAT token” — a IA usará install_integration para provisionar a integração com suas credenciais. Sem necessidade de acessar a UI do Prodgy.

Gerenciar Templates de Integração (apenas SUPERADMIN/ADMIN)

Pergunte: “Crie um template de integração para Zendesk” — a IA usará as regras configuradas para gerar um template válido, e depois oferecerá instalá-lo imediatamente.

---

Próximos Passos

• Visão Geral — modos de transporte e ferramentas disponíveis
• Como Funciona — descoberta de ferramentas, fluxo de execução e controle de acesso