Kommo CRM MCP Server

🚀 Servidor MCP do Kommo CRM

Servidor MCP (Model Context Protocol) personalizado para integração com o Kommo CRM.

✅ Status: FUNCIONANDO COM FUNCIONALIDADES AVANÇADAS

O servidor MCP do Kommo foi criado com sucesso e está configurado com suas credenciais:

URL do Cliente: https://your-subdomain.kommo.com
Token de Acesso: Configurado e funcionando
Imagem Docker: Construída e testada
Novas Funcionalidades: Implementadas e prontas para uso

🛠️ Ferramentas Disponíveis

📊 Leads

get_leads - Listar leads
get_lead - Obter lead específico
create_lead - Criar novo lead

👥 Contatos

get_contacts - Listar contatos
get_contact - Obter contato específico
create_contact - Criar novo contato

🏢 Empresas

get_companies - Listar empresas
get_company - Obter empresa específica
create_company - Criar nova empresa

📋 Tarefas

get_tasks - Listar tarefas
create_task - Criar nova tarefa

🔄 Pipelines

get_pipelines - Listar pipelines

👤 Usuários

get_users - Listar usuários

⚙️ Conta

get_account_info - Informações da conta

🆕 NOVAS FUNCIONALIDADES IMPLEMENTADAS

📅 Gestão de Eventos e Atividades

get_lead_events - Obter eventos de um lead específico
create_lead_event - Criar novo evento para um lead
get_contact_activities - Obter atividades de um contato específico
create_contact_activity - Criar nova atividade para um contato

🎯 Gestão de Status e Pipelines

get_lead_statuses - Obter status de um pipeline específico
create_lead_status - Criar novo status para um pipeline
move_lead_to_status - Mover lead para um status específico
move_lead_to_pipeline - Mover lead para um pipeline específico

📈 Relatórios e Analytics

get_sales_report - Relatório de vendas por período
get_lead_conversion_report - Relatório de conversão de leads
get_pipeline_performance_report - Relatório de performance de pipelines
get_dashboard_data - Dados do dashboard e métricas principais
get_user_performance_stats - Estatísticas de performance de usuário
get_lead_analytics - Analytics de lead específico
get_pipeline_analytics - Analytics de pipeline específico

🔧 Configuração no Cursor

O servidor já está configurado no arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "kommo": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "KOMMO_BASE_URL=https://your-subdomain.kommo.com",
        "-e", "KOMMO_ACCESS_TOKEN=SEU_TOKEN_AQUI",
        "kommo-mcp-server"
      ],
      "description": "Kommo CRM integration for leads, contacts, companies, tasks, events, analytics and reports"
    }
  }
}

🐳 Execução com Docker

# Executar o servidor MCP do Kommo
docker run --rm -i \
  -e KOMMO_BASE_URL=https://your-subdomain.kommo.com \
  -e KOMMO_ACCESS_TOKEN=SEU_TOKEN_AQUI \
  kommo-mcp-server

📝 Exemplos de Uso

Eventos e Atividades

{
  "name": "get_lead_events",
  "arguments": {
    "lead_id": 123,
    "limit": 10
  }
}

{
  "name": "create_lead_event",
  "arguments": {
    "lead_id": 123,
    "type": "note",
    "text": "Cliente interessado no produto premium",
    "responsible_user_id": 1
  }
}

Gestão de Status

{
  "name": "get_lead_statuses",
  "arguments": {
    "pipeline_id": 1
  }
}

{
  "name": "move_lead_to_status",
  "arguments": {
    "lead_id": 123,
    "status_id": 5
  }
}

Relatórios e Analytics

{
  "name": "get_sales_report",
  "arguments": {
    "date_from": "2024-01-01",
    "date_to": "2024-01-31"
  }
}

{
  "name": "get_dashboard_data",
  "arguments": {}
}

{
  "name": "get_user_performance_stats",
  "arguments": {
    "user_id": 1,
    "date_from": "2024-01-01",
    "date_to": "2024-01-31"
  }
}

🔗 Configuração para N8N

Para usar no N8N com o "MCP Client Tool":

URL: http://72.60.5.216:3001/mcp/
Auth Token: kommo-mcp-token
Headers:
- mcp-session-id: sua-session-id

📁 Estrutura do Projeto

kommo-mcp-server/
├── src/
│   ├── index.ts          # Servidor MCP principal
│   ├── index-http.ts     # Servidor MCP HTTP
│   └── kommo-api.ts      # Classe de integração com API (ATUALIZADA)
├── dist/                 # Arquivos compilados
├── package.json          # Dependências
├── tsconfig.json         # Configuração TypeScript
├── Dockerfile           # Containerização
├── .env                 # Variáveis de ambiente
└── README.md            # Documentação (ATUALIZADA)

🎯 Funcionalidades Avançadas

📊 Analytics em Tempo Real

Métricas de performance por usuário
Análise de conversão de leads
Performance de pipelines
Dashboard com KPIs principais

🔄 Gestão de Workflow

Movimentação automática de leads
Criação de status personalizados
Rastreamento de eventos e atividades
Histórico completo de interações

📈 Relatórios Estratégicos

Relatórios de vendas por período
Análise de conversão
Performance de equipe
Métricas de pipeline

🎯 Próximos Passos

Testar as novas ferramentas no Cursor
Configurar automações no N8N
Implementar mais funcionalidades conforme necessário
Adicionar webhooks para integrações em tempo real

🔒 Segurança

Token de acesso configurado com escopos apropriados
Container Docker isolado
Variáveis de ambiente seguras
Validação de entrada em todas as ferramentas

✅ Servidor MCP do Kommo com funcionalidades avançadas pronto para uso!

🚀 Total de Ferramentas Disponíveis: 25

7 ferramentas básicas (leads, contatos, empresas, tarefas, pipelines, usuários, conta)
4 ferramentas de eventos e atividades
4 ferramentas de gestão de status e pipelines
7 ferramentas de relatórios e analytics
3 ferramentas de analytics avançados

Deploy Server

HTTP connection URL

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Enables comprehensive integration with Kommo CRM through 25 tools for managing leads, contacts, companies, tasks, events, and generating detailed analytics reports. Supports advanced workflow management, pipeline operations, and real-time performance tracking.

Related MCP Servers

Loxo MCP Server
tbensonwest
A
security
F
license
A
quality
Enables interaction with the Loxo recruitment platform API, facilitating tasks such as candidate and job management, activity logging, and call queue management through AI assistants.
Last updated -
12
Attio MCP Server
hmk
-
security
A
license
-
quality
Facilitates interaction with the Attio CRM by allowing MCP clients to read and write company records and notes through the Attio API.
Last updated -
535
13
BSD 3-Clause
HubSpot MCP
shinzo-labs
A
security
A
license
A
quality
A Model Context Protocol implementation for the HubSpot API that provides a standardized interface for accessing and managing CRM data, including companies, contacts, deals, and other objects with comprehensive CRUD operations and association management.
Last updated -
112
37
18
MIT License
GoHighLevel MCP Server
mastanley13
-
security
F
license
-
quality
Connects Claude Desktop to GoHighLevel CRM, providing 269+ tools across 19 categories for complete contact management, messaging, sales, marketing, e-commerce, and business operations through AI automation.
Last updated -
5
76

View all related MCP servers