MCP Tools

Guia

Dica

Ao instalar uma integração, uma MCP Tool e automaticamente registrada no Prodgy, permitindo que agentes de IA interajam com a ferramenta conectada de forma autônoma.

O que é uma MCP Tool?

MCP (Model Context Protocol) é o protocolo utilizado pelo Prodgy para conectar agentes de IA a ferramentas externas. Cada integração instalada registra automaticamente uma MCP Tool — uma configuração estruturada que descreve:

• Ações disponíveis — o que a ferramenta pode fazer (ex: criar issue, enviar mensagem, buscar dados)
• Parâmetros aceitos — quais informações a ferramenta precisa para executar cada ação
• Formatos de resposta — como os resultados são retornados

---

Como Funciona na Prática

Quando você conversa no Playground ou interage com um agente, o orquestrador MCP analisa sua mensagem e:

1. Identifica a intenção — entende o que você deseja realizar (ex: “crie uma issue no GitHub para corrigir o bug X”)
2. Seleciona a MCP Tool adequada — localiza a integração correspondente entre as ferramentas disponíveis
3. Executa a ação — invoca a ferramenta com os parâmetros corretos, de forma automática
4. Retorna o resultado — apresenta a resposta da ferramenta diretamente na conversa

Nota

Todo o processo acontece de forma transparente. Você não precisa configurar nada além de instalar a integração — a MCP Tool já fica registrada e disponível para uso pelos agentes.

---

Exemplos de Uso

Intenção no Chat	MCP Tool Acionada	Ação Executada
”Crie uma issue no GitHub”	GitHub	Cria issue no repositório configurado
”Envie uma mensagem no Slack”	Slack	Envia mensagem no canal especificado
”Liste os PRs abertos”	GitHub / GitLab	Consulta pull requests em aberto
”Qual o status do deploy?”	Azure DevOps	Consulta pipeline de CI/CD
”Crie uma tarefa no Jira”	Jira	Cria tarefa no projeto configurado

---

Orquestrador MCP

O orquestrador MCP é o componente responsável por coordenar as chamadas as ferramentas. Ele atua como intermediario entre o agente de IA e as integrações instaladas:

• Roteamento inteligente — direciona cada solicitação para a MCP Tool correta com base no contexto da conversa
• Múltiplas ferramentas — pode acionar mais de uma ferramenta em uma única interação, se necessário
• Contexto preservado — mantem o histórico da conversa para chamadas mais precisas
• Tratamento de erros — informa ao usuário caso a ferramenta não esteja disponível ou ocorra uma falha

Cuidado

Para que uma MCP Tool funcione no chat, a integração correspondente deve estar com status Ativo e com credenciais válidas. Integrações com status Falha ou Desconectado não serão acionadas pelo orquestrador.

---

Relação com Integrações

Aspecto	Integração	MCP Tool
O que é	Conexão configurada com ferramenta externa	Configuração de acionamento por IA
Quando é criada	Ao instalar a integração	Automaticamente, junto com a integração
Quem usa	Workflows, dashboards, agentes	Agentes de IA e orquestrador MCP
Configuração	Credenciais e parâmetros de conexão	Automática — nenhuma configuração adicional