namakan-mcp-crm

Un único servidor MCP para cualquier CRM. Los agentes llaman a crm_find_contact / crm_list_deals — nunca llegan a saber si la plataforma funciona con HubSpot, Salesforce, Dynamics, Pipedrive o Zoho.

Incluye un CRM simulado para que funcione antes de que nadie te dé una clave de API. Las escrituras están desactivadas hasta que establezcas una variable de entorno.

Ejecución en 60 segundos

pip install git+https://github.com/cfollette18/namakan-mcp-crm.git
namakan-mcp-crm demo
namakan-mcp-crm tools
namakan-mcp-crm call crm_find_contact query=alex

demo imprime tres bloques JSON: una búsqueda de contacto, una lista de negocios y una escritura fallida (solo lectura por defecto). La última es intencionada.

Related MCP server: Company Records

Cómo encaja

flowchart LR
  Agent[Hermes / Cursor / Claude Desktop] -->|MCP stdio| Server[namakan-mcp-crm]
  Server --> Tools[crm_find_contact etc.]
  Tools --> Mock[mock backend]
  Tools --> Rest[generic REST]
  Tools --> Vendor[HubSpot / Salesforce / ... adapter]

Cambia el backend mediante NAMAKAN_CRM_BACKEND. Los nombres de las herramientas no cambian.

Conéctalo a Cursor

Crea o edita .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json:

{
  "mcpServers": {
    "namakan-crm": {
      "command": "namakan-mcp-crm",
      "args": ["serve"],
      "env": {
        "NAMAKAN_CRM_BACKEND": "mock"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json) y la configuración MCP de Hermes usan la misma estructura de command / env. Los hosts que no pasan argumentos también funcionan: namakan-mcp-crm sin subcomando es serve.

CLI

Herramientas

Backends

Escrituras

NAMAKAN_MCP_ALLOW_WRITES=1 NAMAKAN_MCP_DRY_RUN=1 namakan-mcp-crm call crm_create_deal name=Test

La ejecución en seco devuelve { "dry_run": true, "would_call": ... } y no toca el almacén. Las escrituras en producción necesitan esa variable de entorno y una vía de aprobación humana (Namakan: ciso).

Python

from namakan_mcp_crm import handle
from namakan_mcp_crm.backends import MockCrm

print(handle("crm_find_contact", {"query": "alex"}, backend=MockCrm()))

Licencia

MIT. Copyright (c) 2026 Namakan AI Engineering.