namakan-mcp-crm

Ein MCP-Server für jedes CRM. Agents rufen crm_find_contact / crm_list_deals auf — sie erfahren nie, ob die Plattform HubSpot, Salesforce, Dynamics, Pipedrive oder Zoho läuft.

Wird mit einem Mock-CRM ausgeliefert, damit es funktioniert, bevor dir jemand einen API-Schlüssel gibt. Schreibvorgänge sind deaktiviert, bis du eine Umgebungsvariable setzt.

In 60 Sekunden ausführen

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 gibt drei JSON-Blobs aus: eine Kontaktsuche, eine Deal-Liste und einen fehlgeschlagenen Schreibvorgang (Standard: schreibgeschützt). Der letzte ist beabsichtigt.

Related MCP server: Company Records

Wie es sich einfügt

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]

Tausche das Backend über NAMAKAN_CRM_BACKEND aus. Die Toolnamen ändern sich nicht.

In Cursor einbinden

Erstelle oder bearbeite .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json:

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

Claude Desktop (claude_desktop_config.json) und die Hermes-MCP-Konfiguration verwenden dieselbe command / env-Struktur. Auch Hosts, die keine Argumente übergeben, funktionieren: namakan-mcp-crm ohne Unterbefehl entspricht serve.

CLI

Tools

Backends

Schreibvorgänge

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

Der Dry-run gibt { "dry_run": true, "would_call": ... } zurück und greift nicht auf den Store zu. Schreibvorgänge in Produktion benötigen diese Umgebungsvariable und einen Freigabeprozess durch Menschen (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()))

Lizenz

MIT. Copyright (c) 2026 Namakan AI Engineering.