Assistentes de IA
MCP (Claude, Cursor)
O servidor MCP deixa assistentes de IA operarem o CRM em linguagem natural: buscar clientes, etiquetar, mandar mensagens e iniciar chatbots — com o mesmo token e as mesmas regras desta API.
Endereço#
Transporte Streamable HTTP (sem sessão), autenticado pelo cabeçalho Authorization: Bearer sk_...:
https://api.seudominio.com.br/integrations/v1/mcp
Crie um token só para o assistente em Ajustes › Integrações › API: dá para ver quando ele foi usado e excluí-lo a qualquer momento sem afetar outras integrações.
Conectar#
claude mcp add --transport http solaria https://api.seudominio.com.br/integrations/v1/mcp \
--header "Authorization: Bearer sk_SEU_TOKEN"Qualquer cliente MCP que aceite um cabeçalho de autorização funciona do mesmo jeito.
Ferramentas#
| Ferramenta | O que faz |
|---|---|
get_account | Confere o token e mostra o workspace |
list_channels | Canais de WhatsApp |
list_contacts · get_contact | Busca e dados de contatos |
create_contact · update_contact | Cria (sem duplicar telefone) e altera contatos |
opt_out_contact · opt_in_contact | Descadastra e recadastra contatos (pelo id ou telefone) |
list_tags · add_contact_tag · remove_contact_tag | Etiquetas (adicionar dispara os chatbots de etiqueta) |
send_message | Envia texto ou modelo pelo WhatsApp |
list_templates | Modelos de mensagem |
list_conversations · update_conversation | Lista conversas e muda a situação |
list_sequences · enroll_in_sequence | Sequências de mensagens |
list_chatbots · start_chatbot | Chatbots de automação liberados para a API |
Cada ferramenta chama o endpoint correspondente da referência: valem as mesmas validações, os webhooks, os gatilhos de chatbot e o limite de 120 chamadas por minuto (cada ferramenta conta como uma chamada). Erros da API voltam para o assistente como resultado com erro, para ele corrigir e tentar de novo. Um lote JSON-RPC aceita até 20 mensagens e o corpo até 1 MB.
As mensagens saem de verdade
send_message e start_chatbot falam com seus clientes pelo WhatsApp. Deixe o cliente MCP pedir confirmação antes das ferramentas que alteram dados — elas vêm marcadas como não somente leitura.