Documentação / Ferramentas MCP
Ferramentas MCP
Conecte seu agente às ferramentas oferecidas por um servidor MCP externo.
Uma ferramenta MCP permite que o agente use ações oferecidas por um servidor externo.
Antes de começar
Tenha a URL HTTP/HTTPS do servidor, permissão para criar ferramentas e as credenciais exigidas por esse servidor. Confira quais ações ele oferece e escolha as necessárias para seu agente.
Conecte o servidor
- Na área Ferramentas, crie uma ferramenta da categoria MCP.
- Abra a configuração e informe a URL completa do servidor.
- Se o servidor exigir autenticação, selecione uma credencial.
- Configure o filtro de ferramentas quando quiser restringir o catálogo utilizado.
- Salve e use a atualização de catálogo para conferir as ferramentas descobertas.
- Associe a ferramenta ao agente ou à etapa em que ela será usada.
Oriente o agente
Explique nas instruções quando consultar a ferramenta e o que fazer se ela falhar. Não peça uma ação que o catálogo do servidor não oferece.
Por exemplo, para consultar um pedido, o servidor precisa oferecer uma ferramenta de consulta e o agente precisa obter os dados exigidos por ela antes de executar.
Teste a conexão
Faça uma pergunta que necessite da ferramenta. Confira a resposta, os parâmetros e o resultado da execução. Se o servidor mudou seu catálogo, atualize-o antes de testar novamente.
| Problema | O que verificar |
|---|---|
| Não conecta | URL, disponibilidade e acesso do backend ao servidor |
| Recusa autenticação | Credencial selecionada e acesso autorizado no servidor |
| Ferramenta ausente | Catálogo atualizado e filtro configurado |
| Ação incorreta | Descrição, parâmetros e instruções do agente |
Uma chamada pode alterar dados externos. Use permissões adequadas no servidor e credenciais de teste ao validar ações de escrita. O filtro do catálogo não substitui autorização no sistema externo.
