convez.ai
MCP ServerIntegração & APIsIntermediário
instantKOM

instantKOM MCP Server

instantKOM/mcp-server

MCP server para automação completa da plataforma instantKOM via Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor Model Context Protocol que integra a API REST da instantKOM ao Claude e assistentes IA. Oferece 230+ ferramentas para gerenciar canais, contatos, mensagens, newsletters, bots, fluxos e análises diretamente via chamadas estruturadas e type-safe.

Instalação

$npx convez-ai instantKOM/mcp-server

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
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Automação de campanhas de newsletter para segmentos específicos
  • Gerenciamento de contatos e canais multicanal via Claude
  • Criação e execução de fluxos de automação e bots conversacionais
  • Consulta de KPIs e analytics de broadcasts em tempo real

Veredito

MCP server maduro e bem documentado que expõe a plataforma instantKOM de forma completa ao ecossistema Claude. Ideal para empresas que usam instantKOM e querem delegar automação de comunicação a assistentes IA, com autenticação segura e cobertura abrangente de recursos.

README

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

instantKOM MCP-Server

npm version License: MIT API Documentation

Model Context Protocol (MCP) server for the instantKOM REST API. Lets AI assistants like Claude Code and Claude Desktop drive your instantKOM messengerzentrale through structured, type-safe tool calls.

Features

  • 230+ tools covering full CRUD for Channels, Contacts, Messages, Newsletters, Bots, Flows, Analytics and more
  • Type-safe — written in TypeScript, runs on Node.js 18+
  • Bearer-token auth via your instantKOM API key
  • Standardized — implements the official Model Context Protocol
  • MIT-licensed — self-hosted use is welcome

Quick start

1. Get an API key

  1. Sign up at instantkom.app
  2. Settings → API Keys → create a new key
  3. Copy the key (format: ik_live_...)

2. Configure your MCP client

Add to your Claude Code / Claude Desktop config:

Claude Code: project-local .mcp.json or ~/.config/claude/claude_desktop_config.json Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "instantkom": {
      "command": "npx",
      "args": ["-y", "@instantkom/mcp-server"],
      "env": {
        "INSTANTKOM_API_KEY": "ik_live_..."
      }
    }
  }
}

3. Restart your client

Claude will now see the instantkom MCP server with all available tools.

Configuration

Environment variableDescriptionDefault
INSTANTKOM_API_KEYBearer token for the instantKOM API (required)—
INSTANTKOM_API_URLOverride API base URLhttps://api.instantkom.app
LOG_LEVELerror / warn / info / debuginfo

Tool overview

Tools are grouped by resource type. Each REST endpoint at api.instantkom.app/api-docs has a corresponding MCP tool.

CategoryExamplesTools
Channelslist_channels, create_channel, update_channel7
Contactslist_contacts, create_contact, update_contact5
Messagingsend_message, list_messages, get_message10
Newsletters / Broadcastslist_broadcasts, create_broadcast, send_broadcast6
Bots & Flowsbot CRUD, flow nodes, flow edges38
Templates & Tagstemplate + tag CRUD, tag assignment21
Analyticsdashboard, broadcast, contact, message KPIs5
Segmentation & QRsegmentation CRUD, QR codes, shortlinks13
Tickets / Webhooks / Polls / Events / Media / Custom Fields / ...full CRUD100+

Examples

Once configured, you can prompt Claude in natural language:

> Send a newsletter to all "Premium" segment contacts.

⏺ I'll create the newsletter via WhatsApp.
   ⤷ create_broadcast(channel: "whatsapp", segment: "premium")
   ↳ 247 recipients · sending now.

⏺ Done. Sent to 247 Premium contacts. Show live analytics?

Development

git clone https://github.com/instantKOM/mcp-server.git
cd mcp-server
npm install
npm run build
INSTANTKOM_API_KEY=ik_live_... node dist/index.public.js

To wire up your local build with Claude Code instead of npm:

{
  "mcpServers": {
    "instantkom": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.public.js"],
      "env": {
        "INSTANTKOM_API_KEY": "ik_live_..."
      }
    }
  }
}

Security

  • API keys are passed as Bearer tokens. Treat them as secrets.
  • All API calls go over HTTPS to api.instantkom.app by default.
  • The MCP server runs locally on your machine — no instantKOM data passes through any third-party host.
  • Audit log of every tool call is recorded server-side in your instantKOM account.

Resources

License

MIT — see LICENSE.

About instantKOM

instantKOM is a multi-channel messenger platform for B2B marketing and customer communication. WhatsApp, Telegram, Signal, Threema, SMS — DSGVO-compliant, hosted in Germany. Learn more at instantkom.app.

Ver o original no GitHub

Bom para

Relacionados