MCP Gateway — Visão Geral

Desenvolvedor

O que é o MCP Gateway?

O MCP Gateway é um componente do Prodgy que expõe as integrações, base de conhecimento e agentes de IA da sua organização como ferramentas MCP — o protocolo padrão usado por assistentes de codificação modernos.

Isso significa que ferramentas como Claude Code, Cursor, Windsurf e Claude Desktop podem interagir diretamente com seu workspace Prodgy: criando itens de trabalho, consultando a base de conhecimento, executando agentes e gerenciando integrações — tudo de dentro da IDE do desenvolvedor.

Ferramentas Disponíveis

Ferramentas da Plataforma

Estas ferramentas estão sempre disponíveis:

Ferramenta	Descrição
`get_my_profile`	Retorna identidade do usuário autenticado, dados da organização e preferências pessoais de IA. Injetado automaticamente no início da sessão.
`get_workspace_info`	Retorna contexto do workspace — visão, público-alvo, OKRs, integrações ativas. Injetado automaticamente no início da sessão.
`update_my_ai_preferences`	Atualiza a diretiva pessoal de IA (markdown) do usuário e o flag de confirmação para ações destrutivas
`search_knowledge`	Busca semântica (RAG) na base de conhecimento do workspace
`list_agents`	Lista agentes de IA configurados para o workspace
`invoke_agent`	Executa um agente Prodgy (com seu próprio LLM, ferramentas e system prompt)
`list_integration_catalog`	Lista templates de integração disponíveis
`get_integration`	Obtém detalhes de um template de integração
`list_installed_integrations`	Lista integrações instaladas na organização
`install_integration`	Instala uma integração na organização com credenciais
`create_integration`	Cria um template de integração (role SUPERADMIN/ADMIN)
`update_integration`	Atualiza um template de integração (role SUPERADMIN/ADMIN)
`delete_integration`	Exclui um template de integração (role SUPERADMIN/ADMIN)
`get_active_integrations`	Lista integrações ativas da organização
`get_mcp_settings`	Obtém configuração do MCP Server (role SUPERADMIN/ADMIN)
`update_mcp_settings`	Atualiza instruções e regras do MCP Server (role SUPERADMIN/ADMIN)

Ferramentas de Integração

Além das ferramentas da plataforma, o MCP Gateway expõe dinamicamente ferramentas das integrações ativas da sua organização. Cada integração configurada no Prodgy (Azure DevOps, Jira, Slack, GitHub, etc.) adiciona automaticamente suas próprias ferramentas ao Gateway — sem necessidade de alteração de código.

Isso significa que o conjunto de ferramentas disponíveis cresce conforme você adiciona integrações, e seu assistente de IA pode interagir com todas elas através de uma única conexão MCP.

Instruções Dinâmicas

O MCP Gateway suporta instruções customizáveis que definem como os clientes de IA devem se comportar ao interagir com seu workspace. Você pode gerenciar essas instruções através de:

UI do Prodgy: Configurações > MCP Server
Ferramenta MCP: chamar update_mcp_settings (requer role SUPERADMIN)

As instruções permitem definir comportamentos como sempre carregar o contexto do projeto primeiro, como lidar com erros de integração, e as regras para criar novos templates de integração.

Segurança de Credenciais

O MCP Gateway suporta múltiplos padrões de credenciais para integrações, todos resolvidos no servidor:

Header-based — ex: Bearer {token}
Query parameter — credenciais injetadas nas URLs de endpoint
Request body — credenciais injetadas no corpo da requisição
OAuth2 client_credentials — troca automática de token antes de cada requisição
Multi-step session — login + aquisição de token de sessão antes de cada requisição

Próximos Passos

Como Funciona — descoberta de ferramentas, fluxo de execução e controle de acesso
Como Usar — configuração passo a passo para Claude Code, Cursor, Windsurf e Claude Desktop