Talkix MCP

Servidor MCP (Model Context Protocol) do Talkix — expõe os indicadores do dashboard em modo somente-leitura para consumo via Claude Code (ou qualquer cliente MCP).

Stack

• Node.js 20+ (ESM)
• @modelcontextprotocol/sdk
• Express 5 (modo HTTP)
• Zod

Como funciona

O servidor autentica com uma API key de usuário do Talkix (pk_..., gerada em Configurações → API Keys no app) e chama a Talkix API em modo leitura. Dois modos de transporte:

• stdio — local, para Claude Code. A chave vem da env TALKIX_API_KEY.
• HTTP — remoto. Cada requisição envia a chave como Authorization: Bearer pk_.... Porta padrão 3110, com /health e /mcp.

Setup

npm install
npm run build

Modo stdio (local / Claude Code)

export TALKIX_API_KEY=pk_sua_chave
export TALKIX_BASE_URL=http://localhost:3001   # opcional; default aponta pra produção
npm run start:stdio

Registrar no Claude Code:

claude mcp add talkix \
  -e TALKIX_API_KEY=pk_sua_chave \
  -- node /caminho/para/talkix-mcp/dist/index.js

Modo HTTP (remoto)

npm start           # sobe em http://0.0.0.0:3110
# health check:
curl http://localhost:3110/health

Variáveis de ambiente

Variável	Obrigatória	Default
TALKIX_API_KEY	sim (modo stdio)	—
TALKIX_BASE_URL	não	https://api.chat.talkix.online
PORT	não (modo HTTP)	3110

Scripts

Comando	O que faz
npm run build	Compila TS → dist/
npm run dev	tsc --watch
npm start	Servidor HTTP
npm run start:stdio	Servidor stdio

Ferramentas expostas

Todas read-only:

• me — dados do usuário/organização da API key.
• Indicadores do dashboard — conversas, tempos de resposta, SLA, CSAT, funil e demais métricas.

Estrutura

src/
├── index.ts        # bootstrap (stdio + HTTP), auth Bearer
├── config.ts       # baseUrl + apiKey via env
├── api-client.ts   # cliente HTTP da Talkix API (TalkixClient)
└── tools/          # me.ts, dashboard.ts (definições das tools)

Licença

Proprietário — Talkix.