Como configurar servidores MCP para os agentes da ClaudIA

Quando usar

• Você quer conectar agentes ClaudIA a múltiplos servidores MCP para usar ferramentas externas
• 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
• URL do servidor MCP que vai 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 para identificar o servidor

   • 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. Clique em Add Server

Etapa 3 — Criar um agente com ferramentas dos servidores MCP

Criando um 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 do agente

5. Role até a seção Agent Tools — você verá 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.

6. Clique em Create Agent

O agente aparece na lista com o badge MCP Tools:

Editando um agente existente

1. Clique em Edit no card do agente

2. Role até Agent Tools

3. Ative/desative ferramentas conforme necessário

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 e faça uma pergunta que exija uma das ferramentas

Editando ou removendo um servidor

Servidores que você adicionou podem ser editados ou removidos:

• 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 de servidores MCP por tenant.

Minhas credenciais estão seguras?

Sim. As credenciais são criptografadas antes de serem armazenadas. Só são descriptografadas no momento em que o agente precisa se conectar ao servidor.

Os servidores são compartilhados entre tenants?

Não. Cada tenant tem seus próprios servidores MCP. Servidores adicionados no tenant "Acme" não aparecem no tenant "Widgets Inc".

Preciso reselecionar as ferramentas ao editar um agente?

Não. As ferramentas selecionadas são salvas junto com o agente. Quando você edita, elas já aparecem ativadas.

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 normalmente.

Observações

• Para entender o ecossistema de agentes da ClaudIA: Funcionalidades da ClaudIA

• Para conhecer o servidor MCP padrão (Eddie): O que é o Eddie e como ele se diferencia da ClaudIA