Dando acesso de MCP a um agente

Cadastrar um servidor MCP no workspace não é suficiente para o agente usar. Você decide, agente por agente, quais servidores estão disponíveis e quais ferramentas daquele servidor ele pode chamar.

Isso protege você de dois cenários: (1) agente errado usando tool cara ou perigosa por descuido; (2) agente "super-poderoso" que sabe tudo, mas é fácil de manipular.

Passo 1: abrir o editor do agente

Dashboard → Meus Agentes → [seu agente]. Vá na aba Integração.

Passo 2: seção MCP Servers

Role para baixo até encontrar o bloco MCP Servers. Você vê a lista dos servidores do workspace, cada um com:

• Ícone de health (verde = saudável, vermelho = offline, amarelo = degradado).
• Nome e descrição curta.
• Toggle para habilitar no agente.

Passo 3: habilitar o servidor

Clique no toggle ao lado do servidor que você quer usar neste agente. A linha fica destacada em roxo indicando que está ativa.

Por padrão, todas as ferramentas daquele servidor ficam disponíveis para o agente. Se quer limitar, continue para o Passo 4.

Passo 4: controle fino por ferramenta

Clique na setinha para expandir o servidor. Aparece a lista de tools com:

• Toggle on/off por tool — o agente só enxerga as tools ligadas.
• Ícone de escudo (amarelo) — clique para marcar a tool como "requer aprovação humana".

O que "requer aprovação humana" faz

Quando o agente tenta chamar uma tool com esse marcador, em vez de executar direto, a chamada vai para a Inbox como um card amarelo. Um operador humano vê o que o agente quer fazer (tool + argumentos) e decide:

• Aprovar — executa a tool na hora, o resultado volta para o agente.
• Rejeitar — a tool não executa, o agente recebe um "ação negada".

Use para ações sensíveis: deletar dados, enviar email em massa, fazer cobrança, qualquer coisa irreversível.

Passo 5: salvar

As mudanças são persistidas no ato — não precisa clicar "Salvar". Se rolar a tela para cima, você vê o agente sendo atualizado ao vivo.

Testar

Abra um chat com o agente (Chat IA no menu) e mande uma mensagem que deveria disparar uma das tools. Exemplos:

• Agente com MCP do Context7: "Me mostra como usar useState do React 19."
• Agente com MCP do GitHub: "Liste as últimas 5 issues abertas no repo X."

Se o indicador mostra "A executar ferramenta...", a tool está sendo chamada. O resultado aparece na resposta final.

Observabilidade

Cada chamada de tool vira uma linha no audit. Veja em MCP Servers → Ver logs:

• Filtre por servidor, status (OK, erro, timeout), janela temporal.
• Clique na linha para ver input e output completos, além do trace ID.
• Use o trace ID para correlacionar com os logs do chat, se precisar investigar um turno específico.

Remover binding

Desligue o toggle do servidor na aba Integração do agente. O binding é removido, mas o audit log histórico é preservado.