Intelligence Hub MCP

Servidor MCP que dá ao Claude Code / Claude Desktop / Cursor acesso ao Intelligence Hub da Fan — o chat conversacional, o radar de tendências e a base interna (RAG) — como ferramentas nativas do seu agente, passando pela sua conta do hub.

Toda chamada roteia pelo backend do hub e herda automaticamente: o vínculo com o seu usuário, o escopo de dados e o log de auditoria no perfil. A chave dos providers de IA nunca toca a sua máquina.

Como funciona

Claude Code/Desktop/Cursor  ──stdio──▶  intelligence-hub-mcp  ──HTTPS (Bearer ih_mcp_…)──▶  Hub /mcp

Você se autentica com uma chave MCP gerada no seu perfil do hub. O MCP só age em nome da sua conta.

1. Gere sua chave MCP

No app do hub → Perfil → Conexão MCP → Gerar chave. Copie a chave (ih_mcp_…) — ela só aparece uma vez.

2. Configure no seu cliente

Claude Code (CLI)

claude mcp add intelligence-hub \
  --env IH_API_TOKEN=ih_mcp_sua_chave \
  --env IH_API_URL=https://seu-backend \
  -- npx -y intelligence-hub-mcp

Claude Desktop (claude_desktop_config.json) / Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "intelligence-hub": {
      "command": "npx",
      "args": ["-y", "intelligence-hub-mcp"],
      "env": {
        "IH_API_URL": "https://seu-backend",
        "IH_API_TOKEN": "ih_mcp_sua_chave"
      }
    }
  }
}

IH_API_URL é a origin do backend do hub (sem /mcp no fim — o servidor acrescenta).

Tools

| Tool | O que faz | |------|-----------| | whoami | Confirma a conta vinculada à chave. | | chat | Pergunta ao hub (cruza RAG + radar + web, como o chat da plataforma). | | radar_search | Tendências do hub (Radar Geral + Radar do cliente citado). | | rag_search | Busca semântica na base interna (cases, propostas, OneDrive). | | list_clients | Clientes ativos da agência. |

Todas read-only nesta versão.

Variáveis de ambiente

| Var | Obrigatória | Descrição | |-----|-------------|-----------| | IH_API_TOKEN | sim | Sua chave MCP (ih_mcp_…), gerada no perfil. | | IH_API_URL | sim | Origin do backend do hub (ex: https://seu-backend). | | IH_VERIFY_ON_START | não | 1 pra logar a conta vinculada no boot. |

Segurança

• A chave é pessoal e revogável (Perfil → Conexão MCP → revogar). Quem revoga corta o acesso na hora.
• Cada requisição é logada e vinculada à sua conta (auditoria no perfil).
• Read-only: nenhuma tool muta dados nem dispara jobs.
• Nunca commite a chave. Ela vive só no config do seu host MCP.

Desenvolvimento

npm install
npm run typecheck   # tsc --noEmit
npm run build       # tsup → dist/index.js
IH_API_TOKEN=ih_mcp_... IH_API_URL=http://localhost:4000 npm run dev