convez.ai
MCP ServerIntegração & APIsIntermediário
vergamini65-boop

Kinbox MCP Server

vergamini65-boop/kinbox-mcp

Integre atendimento Kinbox (WhatsApp/Instagram) ao Claude com 40+ tools

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para integração com a plataforma Kinbox de atendimento omnichannel (WhatsApp, Instagram e outros canais). Expõe 40+ ferramentas para gerenciar contatos, sessões, campanhas, deals CRM, tags, pipelines e envio de mensagens direto do Claude.

Instalação

$npx convez-ai vergamini65-boop/kinbox-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar atendimento ao cliente via WhatsApp/Instagram integrado com CRM
  • Criar e gerenciar campanhas de mensagem em massa com segmentação por tags
  • Sincronizar contatos e deals entre Kinbox e workflows de IA

Veredito

MCP bem estruturado para quem usa Kinbox em produção. Cobertura completa de endpoints (40+ tools), documentação técnica sólida com notas de integração. Requer API key válida e ambiente Node 18+; ideal para equipes de atendimento que querem ampliar automações via Claude.

README

A tradução para o português deste README ainda está na fila.

kinbox-mcp

MCP Server para integração com a API Kinbox — atendimento via WhatsApp, Instagram e outros canais.

Ferramentas disponíveis

CategoriaTools
Contatoskinbox_list_contacts, kinbox_get_contact, kinbox_create_contact, kinbox_update_contact
Sessõeskinbox_list_sessions, kinbox_get_session
Tagskinbox_list_tags, kinbox_add_tag, kinbox_remove_tag, kinbox_create_tag
Campanhaskinbox_list_campaigns, kinbox_get_campaign, kinbox_create_campaign, kinbox_send_campaign, kinbox_cancel_campaign
Deals (CRM)kinbox_list_deals, kinbox_get_deal, kinbox_create_deal, kinbox_update_deal
Pipelineskinbox_list_pipelines, kinbox_get_pipeline
Produtoskinbox_list_products, kinbox_get_product
Campos personalizadoskinbox_list_custom_fields
Envio de mensagemkinbox_send_message
Escape hatchkinbox_raw_request

Configuração

1. Instalar dependências

npm install

2. Obter API Key

No Kinbox: Configurações → Integrações → API → criar token.

3. Configurar variável de ambiente

export KINBOX_API_KEY=kb_live_seu_token_aqui

4. Adicionar ao Claude Code

Copie .mcp.json para a raiz do seu projeto (ou ~/.claude/mcp.json para global) e defina KINBOX_API_KEY no ambiente:

{
  "mcpServers": {
    "kinbox": {
      "type": "stdio",
      "command": "node",
      "args": ["/caminho/para/kinbox-mcp.js"],
      "env": {
        "KINBOX_API_KEY": "kb_live_seu_token"
      }
    }
  }
}

Notas de integração

Conhecimento acumulado sobre a plataforma (webhook inbound, payload ideal para cenários, nó "Buscar contato", canais oficial × não-oficial, API v3 de workflows/logs, doc oficial) em NOTAS-INTEGRACAO.md.

n8n — recriar a API como HTTP nodes

N8N-HTTP-NODES.md lista os 315 endpoints da API (de docs/openapi-oficial.json) com método, rota, params e campos de body, mais instruções para um agente criar um HTTP Request node por endpoint no n8n. Spec completo da doc oficial em docs/openapi-oficial.json.

Base URL

https://api4.kinbox.com.br (API v1)

Dependências

  • Node.js 18+
  • @modelcontextprotocol/sdk
  • zod
Ver o original no GitHub

Bom para

Relacionados