Conectar um cliente MCP

A conexão é sempre por usuário: o assistente passa a agir em nome de quem autorizou.

Antes de começar

1. Você precisa estar logado no app com o perfil que quer usar.
2. O seu administrador precisa ter habilitado os recursos que você pretende usar (contas, oportunidades, campanhas).

Fluxo de autorização

1. No cliente MCP, adicione um servidor remoto e informe https://api.agents2.me/mcp.
2. O cliente descobre os metadados em /.well-known/oauth-protected-resource e abre o navegador.
3. Faça login no agents2.me (se ainda não estiver logado).
4. O app abre a tela de consentimento mostrando o nome do cliente que está pedindo acesso.
5. Aprove ou recuse.
6. O cliente recebe os tokens e passa a listar as ferramentas.

Clientes conhecidos

Cliente	Como adicionar
Claude	Configurações → Conectores → Adicionar conector personalizado → cole a URL do endpoint
ChatGPT	Configurações → Conectores → Criar → URL do endpoint MCP
Cursor / VS Code	Arquivo de configuração MCP do editor, tipo http, URL do endpoint
n8n e automações	Nó de cliente MCP genérico, tipo Streamable HTTP, com OAuth

O cliente precisa suportar MCP remoto sobre HTTP com OAuth. Clientes que só falam MCP local (stdio) exigem um adaptador.

Verificar se funcionou

1. No app, abra Configurações → Apps conectados.
2. A conexão deve aparecer com o nome do cliente, a data do último uso e o usuário responsável.
3. No assistente, peça algo simples — "liste minhas conversas aguardando resposta".

Exemplos de uso

Pedido ao assistente	Ferramentas acionadas
"O que está aguardando resposta agora?"	list_open_conversations
"Resuma a conversa da Maria"	search_inbox + get_conversation_history
"Assuma a conversa dela e responda X"	take_conversation + send_message
"Quais oportunidades fecharam este mês?"	search_opportunities + run_report
"Monte a campanha de reengajamento para os contatos sem contato há 30 dias"	create_campaign + list_campaign_templates + update_campaign

Revogar o acesso

Em Configurações → Apps conectados, use a lixeira na linha da conexão. A revogação é imediata: os tokens daquela conexão param de funcionar e o assistente precisa autorizar de novo para voltar.

Limites

• 120 chamadas por minuto por conexão. Ao passar disso a resposta é 429 e basta aguardar.
• 30 dias de validade do refresh token. Depois disso, autorize novamente.
• A conexão é pessoal: dois usuários apontando o mesmo assistente têm conexões distintas, com permissões distintas.

Veja OAuth e segurança para os detalhes técnicos.