Como conectar ferramentas externas via MCP Servers na ClaudIA Agêntica

Quando usar

• Você quer conectar agentes da Agêntica a ferramentas externas via Model Context Protocol (MCP)

• Você precisa adicionar um servidor MCP customizado (além do Eddie default)

• Você quer entender autenticação, segurança e limites dos servidores MCP

Pré-requisitos

• Acesso de administrador à plataforma ClaudIA Agêntica

• URL do servidor MCP que será adicionado

• (Se aplicável) credenciais de autenticação (Bearer Token ou API Key)

Sobre este artigo

Servidores MCP (Model Context Protocol) são serviços que disponibilizam ferramentas (tools) para os agentes usarem durante as conversas. Por exemplo: "Consultar status do pedido", "Agendar reunião", "Buscar boleto por CPF".

Com a funcionalidade multi-MCP, é possível conectar agentes a vários servidores MCP simultaneamente, combinando ferramentas de diferentes fontes.

Passo a passo

Etapa 1 — Acessar as configurações

1. Faça login na plataforma

2. Clique no seu nome no canto inferior esquerdo

3. Selecione Settings

Etapa 2 — Adicionar um novo servidor MCP

1. Vá até a seção MCP Servers

2. Clique em Add Server

3. Preencha:

   • Name — nome amigável

   • URL — endpoint do servidor MCP

   • Authentication — escolha o tipo:

     • None — sem autenticação

     • Bearer Token — usa token de acesso

     • API Key — usa chave de API

4. Se escolher Bearer Token ou API Key, preencha o campo extra com a credencial

5. (Opcional) Custom headers — bloco onde você cadastra pares chave/valor de headers HTTP adicionais enviados em todas as chamadas àquele servidor. Útil quando o MCP exige headers além da autenticação (ex: X-Tenant-Id, X-Source, headers de versionamento). Adicione quantos pares precisar; chaves vazias são descartadas no salvamento

1. Clique em Add Server

Etapa 3 — Criar agente com ferramentas dos servidores MCP

Criando novo agente

1. Vá até Agents no menu lateral

2. Expanda o template react-agent

3. Clique em + New Agent

4. Preencha nome e descrição

1. Role até Agent Tools — você vê todos os servidores MCP disponíveis como grupos expansíveis

Selecionando ferramentas de múltiplos servidores

• Expanda cada servidor clicando no nome

• Use o toggle Select all para ativar todas as ferramentas de uma vez

• Ou ative individualmente cada ferramenta

O badge mostra quantas ferramentas estão selecionadas em cada servidor.

1. Clique em Create Agent

Editando agente existente

1. Clique em Edit no card do agente

2. Role até Agent Tools

3. Ative/desative ferramentas

4. Clique em Save Changes

Etapa 4 — Testar o agente

1. Vá até Chat no menu lateral

2. Selecione o agente configurado

3. Inicie uma conversa que exija uma das ferramentas

Editando ou removendo um servidor

• Clique no menu de três pontos ao lado do servidor

• Edit — alterar nome, URL ou autenticação

• Delete — remover

Perguntas frequentes

Posso adicionar quantos servidores quiser?

Sim — não há limite por tenant.

Minhas credenciais estão seguras?

Sim. As credenciais são criptografadas antes de armazenadas. Só são descriptografadas no momento da conexão.

Os servidores são compartilhados entre tenants?

Não. Cada tenant tem seus próprios servidores MCP.

Preciso reselecionar as ferramentas ao editar um agente?

Não. As ferramentas selecionadas são salvas junto com o agente.

O que acontece se um servidor MCP ficar fora do ar?

O agente continua funcionando, mas não conseguirá usar as ferramentas daquele servidor. As ferramentas de outros servidores continuam disponíveis.

Observações

• Para entender Sub-agentes: Como criar Sub-agentes na ClaudIA Agêntica

• Para o Supervisor: Como configurar o Supervisor

• Para criar tools via Companion: Como criar agentes com linguagem natural (AI Companion)

• Para navegar pela interface: Como navegar pela interface de agentes

• Para servidores MCP no contexto da ClaudIA padrão: Como configurar servidores MCP para os agentes da ClaudIA