Salomão Docs

Model Context Protocol

MCP Salomão

Ferramentas estruturadas para agentes de IA integrarem com o Salomão. 20 tools disponíveis.

Integrar no agente

O cliente MCP (Cursor, Claude ou outro) fala JSON-RPC nesta URL. O token slm_ sai da tela Tokens do dashboard.

  1. Crie um token de API em Tokens e copie o valor que começa com slm_.
  2. Cole a configuração abaixo no cliente, trocando slm_SEU_TOKEN pelo token.
  3. O cliente descobre as tools com tools/list. Não é preciso listar cada uma à mão.
  4. Cole a instrução no prompt do agente para ele seguir as skills e as regras de uso.

Configuração do cliente

{
  "mcpServers": {
    "salomao": {
      "url": "https://salomao.ia.br/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer slm_SEU_TOKEN"
      }
    }
  }
}

Instrução para o prompt do agente

Use o servidor MCP Salomão para consultar e alterar dados da loja. Não invente valores: chame as tools.

Antes de agir, leia as skills do servidor:
- skill://agente-whatsapp/SKILL.md
- skill://tesouraria/SKILL.md

Siga o campo "quando usar" de cada tool. No WhatsApp, comece por identificar_irmao. Se autorizado for falso, não chame outras tools. Em gerar_link_extrato e gerar_link_mensalidade, envie ao irmão somente o campo mensagem. Nunca exponha CPF, dados bancários, UUIDs ou nomes de tools. No WhatsApp use *negrito* e _itálico_, nunca Markdown **.

Streamable HTTP

POST https://salomao.ia.br/api/v1/mcp

Protocolo MCP oficial (JSON-RPC 2.0). Use esta URL no cliente MCP com Authorization Bearer.

REST (compatibilidade)

POST https://salomao.ia.br/api/v1/mcp

Corpo: { "tool": "<nome>", "arguments": { ... } } — para n8n/WhatsApp sem cliente MCP.

Streamable HTTP

Clientes MCP falam JSON-RPC em POST https://salomao.ia.br/api/v1/mcp. REST { "tool", "arguments" } permanece como compatibilidade.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "identificar_irmao",
    "arguments": {
      "telefone": "5511999887766"
    }
  }
}