MMCPMarkets
MK

miguelgbastos/kommo-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

16 stars 16 forks 质量 85 趋势 41MIT
Repository Install

Servidor MCP open source para integrar Cursor, Claude e outros clientes ao Kommo CRM.

概览

Servidor MCP (Model Context Protocol) para integração com o Kommo CRM. Expõe , e para clientes MCP (Cursor, Claude Desktop, etc.). - : revisão 2026-07-28 pelo SDK oficial, com compatibilidade stateless para clientes da família 2025 - : Streamable HTTP para serviços remotos e stdio para clientes locais - : leads, contatos, empresas, tarefas, pipelines, notas, relatórios, dashboard, Salesbot, motivos de perda - : relatório de vendas, pipelines, motivos de perda, dashboard, conta - : templates para análise de vendas, leads, pipelines e motivos de perda - : interface conversacional em linguagem natural - : código organizado em módulos (kommo-api, mcp/, ask-kommo) - : validação de Origin, validação dos argumentos das tools e autenticação obrigatória fora de localhost - Node.js - Docker (opcional) - Token de acesso do Kommo (integração privada ou OAuth2) — ver documentação do Kommo O servidor sobe em http://127.0.0.1:3001/mcp. 1. Copie o arquivo de exemplo: 2. Configure no .

README

以下为原文 README 节选，完整内容请查看原文。

Kommo MCP Server

English documentation

Servidor MCP (Model Context Protocol) para integração com o Kommo CRM. Expõe tools, resources e prompts para clientes MCP (Cursor, Claude Desktop, etc.).

Sumário

Funcionalidades

  • MCP moderno e compatível: revisão 2026-07-28 pelo SDK oficial, com compatibilidade stateless para clientes da família 2025
  • Dois transportes oficiais: Streamable HTTP para serviços remotos e stdio para clientes locais
  • 23 tools: leads, contatos, empresas, tarefas, pipelines, notas, relatórios, dashboard, Salesbot, motivos de perda
  • 5 resources: relatório de vendas, pipelines, motivos de perda, dashboard, conta
  • 4 prompts: templates para análise de vendas, leads, pipelines e motivos de perda
  • ask_kommo: interface conversacional em linguagem natural
  • Arquitetura modular: código organizado em módulos (kommo-api, mcp/, ask-kommo)
  • Segurança: validação de Origin, validação dos argumentos das tools e autenticação obrigatória fora de localhost

Pré-requisitos

  • Node.js 22.13+
  • Docker (opcional)
  • Token de acesso do Kommo (integração privada ou OAuth2) — ver documentação do Kommo

Início rápido

git clone https://github.com/Miguelgbastos/Kommo-MCP.git
cd Kommo-MCP
npm install
cp env.example .env
# edite .env com KOMMO_BASE_URL e KOMMO_ACCESS_TOKEN
npm run build
npm start
在 GitHub 查看完整 README

安装

docker run -d -p 3001:3001 \
新手？先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "kommo": { "command": "node", "args": ["/caminho/absoluto/Kommo-MCP/dist/stdio.js"], "env": { "KOMMO_BASE_URL": "https://seu-dominio.kommo.com", "KOMMO_ACCESS_TOKEN": "seu-token-aqui" } } } }