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:
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:
{
"mcpServers": {
"quantika-hub": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://quantikahub.com/api/mcp?clientToken=SEU_CLIENT_TOKEN"
]
}
}
}Como conectar no Cursor IDE
- Abra o Cursor e vá em Settings > Features > MCP Servers.
- Clique em + Add New MCP Server.
- Defina o Nome como
Quantika Hub. - Defina o Type como
commandousse. - 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:
Dispara uma mensagem de WhatsApp real para um número de telefone ou contato do CRM através do canal ativo da organização.
message (string), phone (opcional), contactId (opcional)Retorna o histórico cronológico de mensagens trocadas com um cliente específico, permitindo ao agente entender o contexto da conversa.
contactId (string), limit (número, padrão 30)Busca contatos por nome, telefone ou e-mail com paginação no CRM do Hub.
query (opcional), limit (opcional)Cria uma nova negociação ou oportunidade no Kanban do CRM, associada a um contato e a um estágio do funil.
title (string), contactId (string), value (opcional), pipelineId (opcional), stageId (opcional)Lista as negociações abertas ou fechadas no funil de vendas, com valores e dados de contato associados.
pipelineId (opcional), stageId (opcional), query (opcional)Lista todos os funis de vendas cadastrados e suas etapas (stages), útil para o agente saber para onde mover um negócio.