● Online

1CRM MCP-Server

Verbindet KI-Assistenten (z. B. Claude) über das Model Context Protocol mit 1CRM. Dies ist ein API-Endpunkt für MCP-Clients – kein interaktives Web-UI.

MCP-Endpunkt

POST https://beta.mcp.1crm.de/mcp

Authentifizierung per Authorization: Basic <base64(benutzer:passwort)> mit dem eigenen 1CRM-Login. Server-Status: /health.

Aktive Guardrails

Feste Instanz: https://demo.1crm.de

Verfügbare Tools (10)

`list_modules`	Verfügbare 1CRM-Module auflisten.
`describe_model`	Felder, Filter und Verknüpfungen eines Moduls anzeigen.
`list_records`	Datensätze suchen und filtern (Feld-Angabe optional).
`get_record`	Einen Datensatz inkl. verknüpfter Daten lesen.
`create_record`	Neuen Datensatz anlegen.
`update_record`	Bestehenden Datensatz aktualisieren.
`delete_record`	Datensatz löschen.
`list_related`	Verknüpfte Datensätze eines Datensatzes auflisten.
`link_records`	Datensätze miteinander verknüpfen.
`unlink_records`	Eine Verknüpfung wieder entfernen.

Verbindung einrichten

Der Endpunkt spricht MCP über Streamable HTTP und funktioniert mit jedem kompatiblen MCP-Client. Jeder Nutzer meldet sich mit dem eigenen 1CRM-Login an – der Server speichert keine Zugangsdaten.

Endpunkt	`POST https://beta.mcp.1crm.de/mcp`
Transport	Streamable HTTP (SSE)
`Authorization`	`Basic <base64(benutzer:passwort)>` – Pflicht
`X-OneCRM-Base-Url`	eigene 1CRM-Instanz (optional, Server hat einen Standard)
Guardrail-Header	`X-OneCRM-Read-Only`, `X-OneCRM-Allow-Delete`, `X-OneCRM-Allowed-Modules` – optional, nur verschärfbar

Basic-Wert erzeugen: printf 'benutzer:passwort' | base64.

Clients ohne HTTP-Transport (z. B. Claude Desktop)

Clients, die nur stdio sprechen, verbinden sich über die Brücke mcp-remote. Beispiel-Eintrag (Header entsprechend anpassen):

{
  "mcpServers": {
    "1crm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://beta.mcp.1crm.de/mcp",
        "--header",
        "Authorization:${ONECRM_AUTH}",
        "--header",
        "X-OneCRM-Base-Url: https://ihre-firma.1crm.de"
      ],
      "env": {
        "ONECRM_AUTH": "Basic <BASE64_VON_BENUTZER:PASSWORT>"
      }
    }
  }
}