Como Conectar um Novo MCP

Este guia mostra, passo a passo, como adicionar um Managed Connection Provider (MCP) do catálogo e disponibilizar suas tools para seus Agentes e Workflows.

Para o servidor MCP do próprio workspace, use Como Cadastrar um MCP Customizado.

Passo a passo

1) Abra a área de MCPs

Vá em Builder → MCPs e clique em Nova MCP.

2) Escolha a integração

Em Selecionar Tipo de MCP, o card Custom MCP aparece primeiro — esse fluxo está em Como Cadastrar um MCP Customizado.

Para uma integração do catálogo, selecione o card correspondente (por exemplo, Google Calendar, Notion, Slack).

3) Nomeie e descreva

Preencha:

MCP Name – um nome interno claro (por exemplo, “Google Calendar – Sales”).
Description (opcional) – para que serve essa integração (ajuda você e seus colegas de equipe no futuro).

4) Crie uma Connection (autenticação)

As Connections são a camada de autenticação compartilhada por todas as tools dentro do MCP.

Clique em + Add Connection.
Dê à connection um Name e (opcionalmente) uma Description.
Complete a autenticação (login via OAuth, API key, etc.).
Assim que for concluída com sucesso, a connection vai aparecer na lista.

Dica: use connections diferentes para equipes ou contas diferentes, para que as permissões permaneçam separadas.

5) Ative as tools que você precisa

Todas as tools começam desativadas. Clique para ativar apenas aquelas que seu Agente deve usar.
Passar o mouse sobre uma tool mostra o que ela faz (por exemplo, no Google Calendar: criar evento, encontrar horários livres, atualizar evento).

6) Escolha os Agentes (opcional)

No final do formulário, o campo Quais agentes devem usar isto? liga o MCP aos Agentes no mesmo envio.

Sem Agentes, o MCP entra só no catálogo. O toast de sucesso oferece Vincular a agentes.

7) Crie o MCP

Salve o MCP. Com Agentes selecionados, o toast é MCP criado e vinculado aos agentes selecionados.

A connection autenticada também pode disparar automações de Evento externo com Origem = Composio, na tela Builder → Recursos → Automações. A lista de eventos vem dessa conexão. Guia: Automações.

Disponibilize as tools do MCP para um Agente

Diferente de tools personalizadas ou tables, você não precisa adicionar cada tool individualmente.

Na criação ou na edição do MCP, use Quais agentes devem usar isto? — ver Vincular a Agentes.

Você também pode fazer isso pelo Agente:

Abra Agentes → Seu Agente → MCPs.
Ative o MCP que você acabou de criar.
Pronto — as tools selecionadas dentro desse MCP ficam disponíveis para o Agente.

Teste internamente (recomendado)

Use o internal chat na página do Agente:

Exemplo para o MCP do Google Calendar:
- “Encontre 3 horários livres de 30 minutos esta semana.”
- “Marque uma reunião com o John amanhã às 10h.”

O Agente vai reunir os detalhes que faltarem (data, participantes, duração) e então acionar a tool correta.

Solução de problemas

MCP criado, mas nenhuma tool disponível?
Certifique-se de ter ativado ao menos uma tool antes de salvar.
Autenticação concluída, mas as chamadas falham?
Verifique as credenciais da connection.

👉 Com isso, agora você sabe como criar um MCP, conectá-lo, ativar suas tools e disponibilizá-las para o seu Agente no mesmo formulário.