namakan-mcp-crm

Один MCP-сервер для любой CRM. Агенты вызывают crm_find_contact / crm_list_deals — и никогда не узнают, работает ли система на HubSpot, Salesforce, Dynamics, Pipedrive или Zoho.

Поставляется с имитационной CRM — она работает ещё до того, как вам выдадут API-ключ. Запись отключена, пока вы не зададите переменную окружения.

Запуск за 60 секунд

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 выводит три JSON-блока: поиск контакта, список сделок и неудачную запись (по умолчанию — только чтение). Последний блок — намеренно.

Related MCP server: Company Records

Как это встраивается

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]

Замените бэкенд с помощю NAMAKAN_CRM_BACKEND. Имена инструментов не меняются.

Подключение к Cursor

Создайте или отредактируйте .cursor/mcp.json (для проекта) или ~/.cursor/mcp.json:

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

Claude Desktop (claude_desktop_config.json) и конфигурация Hermes MCP используют ту же струкуру command / env. Хосты, которые не передаю т аргументы, тоже работают: namakan-mcp-crm без подкоманды — это serve.

CLI

Инструменты

Бэкенды

Запись

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

Сухой прогон возвращает { "dry_run": true, "would_call": ... } и не затрагивает хранилище. Боевые записи требуют этой переменной окружения и пути ручного утверждения (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()))

Лицензия

MIT. Copyright (c) 2026 Namakan AI Engineering.