Quantika API Docs
v1.0 (Public API)
Model Context Protocol (Anthropic)

Servidor MCP

Conecte agentes de IA externos (Claude Desktop, Cursor IDE, n8n, LangChain) diretamente à infraestrutura do Quantika Hub para ler históricos, enviar WhatsApp e fechar negócios no CRM via chat.

O que é o Servidor MCP?

O Model Context Protocol (MCP) é o padrão da indústria criado pela Anthropic para permitir que Modelos de Linguagem (LLMs) executem ferramentas com segurança em sistemas reais.

O Quantika Hub expõe um servidor MCP nativo e multi-tenant compatível com JSON-RPC 2.0 e Server-Sent Events (SSE). Quando conectado, o seu agente de IA ganha "superpoderes" para operar a sua conta sem intervenção humana.

URL do Endpoint

O servidor MCP responde em requisições POST para a URL abaixo. Você pode autenticar via query parameter ?clientToken=... ou pelo cabeçalho Authorization: Bearer seu_token:

https://quantikahub.com/api/mcp?clientToken=SEU_CLIENT_TOKEN

Como conectar no Claude Desktop

Abra o arquivo de configuração do Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json no Windows ou ~/Library/Application Support/Claude/claude_desktop_config.json no Mac) e adicione o servidor:

claude_desktop_config.json
{
  "mcpServers": {
    "quantika-hub": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://quantikahub.com/api/mcp?clientToken=SEU_CLIENT_TOKEN"
      ]
    }
  }
}

Como conectar no Cursor IDE

  1. Abra o Cursor e vá em Settings > Features > MCP Servers.
  2. Clique em + Add New MCP Server.
  3. Defina o Nome como Quantika Hub.
  4. Defina o Type como command ou sse.
  5. Cole o comando: npx -y mcp-remote https://quantikahub.com/api/mcp?clientToken=SEU_CLIENT_TOKEN.

Ferramentas Disponíveis (Tools)

O servidor MCP expõe automaticamente 6 ferramentas operacionais prontas para uso pelos agentes:

send_whatsapp_messageMensageria

Dispara uma mensagem de WhatsApp real para um número de telefone ou contato do CRM através do canal ativo da organização.

Parâmetros: message (string), phone (opcional), contactId (opcional)
get_conversation_historyInbox

Retorna o histórico cronológico de mensagens trocadas com um cliente específico, permitindo ao agente entender o contexto da conversa.

Parâmetros: contactId (string), limit (número, padrão 30)
list_contactsCRM

Busca contatos por nome, telefone ou e-mail com paginação no CRM do Hub.

Parâmetros: query (opcional), limit (opcional)
create_crm_dealVendas

Cria uma nova negociação ou oportunidade no Kanban do CRM, associada a um contato e a um estágio do funil.

Parâmetros: title (string), contactId (string), value (opcional), pipelineId (opcional), stageId (opcional)
list_dealsVendas

Lista as negociações abertas ou fechadas no funil de vendas, com valores e dados de contato associados.

Parâmetros: pipelineId (opcional), stageId (opcional), query (opcional)
list_pipelinesCRM

Lista todos os funis de vendas cadastrados e suas etapas (stages), útil para o agente saber para onde mover um negócio.