Conecte uma IA ao seu CRM (MCP)

O MCP é um padrão aberto (o "USB-C das integrações de IA"): o Syncro expõe um único endereço e qualquer assistente compatível se conecta, sem precisar de código.

Depois de conectada, a IA opera o seu CRM através de comandos em linguagem natural. Alguns exemplos do que você pode pedir:

• "Liste os leads do funil Vendas que estão parados há mais de 7 dias."
• "Crie um lead para a Maria Silva, telefone +55 11 99999-0000, no funil Vendas, etapa Novo."
• "Mova o lead #4821 para a etapa Proposta enviada."
• "Marque o lead #4821 como ganho, com valor de R$ 3.500."
• "Crie uma tarefa de ligação para amanhã de manhã para cada lead sem contato há 3 dias."
• "Envie uma mensagem de WhatsApp para o lead #4821 confirmando a reunião."
• "Quais são os meus funis e etapas?"

Recursos disponíveis:

Recurso	O que a IA pode fazer
Leads	Listar, buscar, criar, atualizar, mover de etapa, marcar como ganho/perdido, gerenciar tags e inscrever em sequências de nutrição
Tarefas	Listar, criar, atualizar e concluir
WhatsApp	Enviar mensagens de texto e templates aprovados para o telefone do lead
Automações	Listar, detalhar, criar, alterar, ativar/desativar e excluir automações
Chatbots	Listar, detalhar, criar, alterar, ativar/desativar e excluir fluxos
Catálogo	Consultar funis, etapas, campos personalizados, usuários e números de WhatsApp conectados
Webhooks	Gerenciar assinaturas de eventos

Além de leads, tarefas e WhatsApp, a IA conectada via MCP também lê, cria, altera, ativa e exclui automações e fluxos de chatbot — são 11 tools novas (total de 32). Elas são cascas finas sobre a API v1 (/automations/* e /chatbots/*), então valem as mesmas permissões da chave (automations:read/write, chatbots:read/write).

Tools de automação: list_automations, get_automation, save_automation, toggle_automation, delete_automation, install_automation_template.

Tools de chatbot: list_chatbot_flows, get_chatbot_flow, save_chatbot_flow, toggle_chatbot_flow, delete_chatbot_flow.

Fluxo recomendado (a IA segue automaticamente):

1. Descobrir o que é válido — get_crm_catalog (recursos automation_capabilities / chatbot_capabilities) ou os endpoints /capabilities.
2. Simular — save_* com validate_only:true corrige cada erro apontado antes de gravar.
3. Salvar — save_* cria/atualiza. Tudo nasce inativo.
4. Ativar — toggle_* é um passo à parte e exige confirmação do usuário (ao ativar, a automação dispara mensagens reais e o bot passa a responder conversas ao vivo).

Exclusões (delete_*) exigem confirm: true. A validação é rígida: qualquer spec inválido é recusado com o caminho exato do erro para a IA se autocorrigir.

Referência completa: Automações e Chatbots.

1. Verifique se o recurso está liberado. Em Configurações → Integrações, procure o card "MCP — Agentes de IA". Se ele não aparecer, fale com o suporte para habilitar na sua conta.

2. Gere uma API Key dedicada. Em Configurações → API Keys, clique em Nova API Key, dê um nome (ex.: "MCP – Claude") e copie a chave — ela é exibida uma única vez. Recomendamos usar uma chave só para o MCP, para poder revogar sem afetar outras integrações.

3. Anote o endereço do servidor:

https://app.syncro.chat/mcp

A IA usa a sua API Key para se autenticar e fica restrita à sua conta, com as mesmas permissões e limites da chave.

Escolha o cliente que você usa. Em todos, substitua SUA_API_KEY pela chave gerada no passo anterior.

Claude Code (terminal)

claude mcp add --transport http syncro https://app.syncro.chat/mcp --header "X-API-Key: SUA_API_KEY"

Depois é só conversar: "liste meus leads do funil Vendas".

Cursor / Windsurf

Adicione o servidor ao arquivo de configuração de MCP (mcp.json no Cursor):

{
  "mcpServers": {
    "syncro": {
      "url": "https://app.syncro.chat/mcp",
      "headers": { "X-API-Key": "SUA_API_KEY" }
    }
  }
}

No Windsurf a estrutura é equivalente (o campo da URL costuma se chamar serverUrl).

ChatGPT (modo desenvolvedor)

Nas configurações de Conectores, adicione um servidor MCP com a URL https://app.syncro.chat/mcp e autenticação por API key (o ChatGPT a envia no cabeçalho Authorization: Bearer — o Syncro aceita as duas formas). O modo desenvolvedor/conectores pode depender do seu plano do ChatGPT.

Claude.ai e Claude Desktop (conectores)

Em Configurações → Conectores → Adicionar conector personalizado, informe a URL https://app.syncro.chat/mcp.

• Se a sua conta já tiver o campo de cabeçalhos (headers), use X-API-Key com a sua chave.
• Se ainda não tiver esse campo (está em liberação gradual pela Anthropic), use a URL secreta: em Configurações → API Keys, clique em "URL MCP" na chave desejada para gerar um endereço no formato https://app.syncro.chat/mcp/t/SEU_TOKEN e cole-o como URL do conector — nesse caso não é preciso informar cabeçalho.

API da OpenAI (Responses / Agents)

{
  "type": "mcp",
  "server_label": "syncro",
  "server_url": "https://app.syncro.chat/mcp",
  "headers": { "X-API-Key": "SUA_API_KEY" }
}

• A IA age com as permissões da sua API Key e fica restrita exclusivamente à sua conta — nunca acessa dados de outras empresas.
• Ações que apagam ou enviam mensagens (excluir um lead, enviar um WhatsApp) exigem confirmação antes de serem executadas. O servidor nunca executa esse tipo de ação sozinho.
• Trate a API Key e a URL secreta como uma senha: não compartilhe, não publique em prints ou mensagens. Qualquer pessoa com elas consegue operar o seu CRM.
• Você pode revogar o acesso a qualquer momento (veja abaixo).

O servidor MCP do Syncro não consome créditos de IA do seu plano — ele apenas expõe as ações do CRM. O custo do modelo de linguagem é do lado do cliente que você usa (a sua assinatura do Claude/ChatGPT ou a sua conta de API).

As chamadas compartilham o limite da API do Syncro: 60 requisições por minuto por chave. Se você usar a mesma chave em outras integrações (como n8n ou WordPress), considere criar uma chave separada para o MCP.

• Para desconectar tudo: em Configurações → API Keys, revogue a API Key usada. Qualquer cliente que a utilizava perde o acesso na hora.
• Para desativar só a URL secreta (mantendo a API Key): na mesma tela, clique em revogar a URL MCP daquela chave.

A IA vê os dados de outras empresas? Não. O acesso é isolado por conta e limitado às permissões da sua API Key.

Preciso saber programar? Não. No Claude.ai e no ChatGPT a conexão é feita pela interface. O comando de terminal é apenas para quem usa o Claude Code.

Funciona com o meu WhatsApp? Sim. A IA envia mensagens pelos números de WhatsApp já conectados na sua conta (texto e, nos números oficiais, templates aprovados). Fora da janela de 24 horas dos números oficiais, use um template.

A IA pode apagar algo sem eu querer? Não sem confirmação. Ações destrutivas sempre pedem sua aprovação no próprio assistente antes de rodar.

Não aparece o card de MCP nas Integrações. E agora? O recurso é liberado por conta. Fale com o suporte para habilitar.