Desenvolvedores
Três portas, uma chave. MCP para agentes de IA conversarem com o escritório, API REST para ler e gravar dados, webhooks para receber eventos. A chave é criada em Organização > API.
Disponível nos planos Pro e Premium. Chaves de teste não gravam nada.
O caminho mais comum. No fim, você pergunta "como está a Maria?" no Claude Desktop e ele responde com o que está no cadastro.
Em Organização > API, crie uma chave com escopo mcp. Ela começa com xam_. Para escrever (criar tarefa, registrar fato), inclua também o escopo write.
Abra o arquivo claude_desktop_config.json e adicione o servidor abaixo. O pacote @xamann/mcp-bridge faz a ponte entre o Claude e o escritório; XAMANN_OPERATOR_ID é o seu código de operador, para as escritas saírem com o seu nome.
{
"mcpServers": {
"advogue": {
"command": "npx",
"args": ["-y", "@xamann/mcp-bridge"],
"env": {
"XAMANN_MCP_TOKEN": "xam_SUA_CHAVE",
"XAMANN_OPERATOR_ID": "123"
}
}
}
}Reinicie o Claude Desktop e pergunte: "Como está a Maria Silva?", "O que vence esta semana?", "Quem está aguardando resposta no WhatsApp?". Para o Cursor ou qualquer cliente HTTP, use a URL direta em vez da ponte.
{
"mcpServers": {
"advogue": {
"url": "https://app.xamann.com.br/api/mcp",
"headers": { "Authorization": "Bearer xam_SUA_CHAVE" }
}
}
}Um agente (Claude, Cursor, o seu próprio) consulta e opera o escritório com ferramentas prontas: buscar pessoa, situação do cliente, prazos, financeiro, histórico do WhatsApp, criar tarefa, registrar fato.
Como: POST https://app.xamann.com.br/api/mcp com JSON-RPC, ou GET na mesma URL para descobrir as ferramentas.
Seu site, CRM ou BI lê leads, pessoas, processos, entrevistas, tarefas e prazos, e cria leads. Superfície pequena de propósito; agentes usam MCP.
Como: GET e POST em https://app.xamann.com.br/api/v1/… com Authorization: Bearer xam_SUA_CHAVE. Especificação em /openapi.yaml.
Quando algo acontece no escritório, seu sistema recebe um POST: lead criado ou convertido, tarefa concluída, audiência criada, prazo próximo, documento assinado, novo andamento.
Como: Cadastre a URL de destino e um segredo em Organização > API. Entrega com retry automático e reenvio manual.
Toda ferramenta tem um nível. Leitura só precisa do escopo mcp. Escrita leve, como criar tarefa, criar lead ou atualizar o status de um lead, precisa do escopo write e acontece sem confirmação. Escrita sensível, como enviar uma mensagem de WhatsApp, enviar e-mail ou arquivar um prazo, exige o escopo write, o parâmetro confirm igual a true e um operador identificado. Sem esses três, a chamada é recusada.
Chaves de teste liberam leitura e MCP em modo somente leitura e bloqueiam qualquer escrita. Use uma para homologar sem medo. Mensagens de WhatsApp em texto livre ainda dependem da janela de 24 horas da Meta e de a organização ter esse recurso ligado.
Uma chamada autenticada. Escopos: read para consultas, write para criar leads e para escritas via MCP, mcp para agentes. Especificação completa em /openapi.yaml.
curl -H "Authorization: Bearer xam_SUA_CHAVE" \ https://app.xamann.com.br/api/v1/leads
Cadastre a URL e um segredo em Organização > API, ou pela chamada abaixo. Cada evento chega como um POST assinado; falhas são reentregues automaticamente e podem ser reenviadas à mão.
POST /api/organizacao/webhooks
{ "event_type": "lead.criado", "target_url": "https://seu-sistema/webhook", "secret": "…" }Protocolo xamann-mcp/1.0, servidor v1.0.0, JSON-RPC 2024-11-05. Versões menores acrescentam ferramentas sem quebrar clientes. Descoberta em tempo real com GET na URL do servidor.
curl -H "Authorization: Bearer xam_SUA_CHAVE" \ https://app.xamann.com.br/api/mcp
O plano Pro inclui MCP, API e webhooks, Datajud para auditoria e RAG completo em petições, além de tudo do Starter. O Premium amplia os limites e inclui suporte técnico.