Installation

So verbinden Sie Ihren KI-Assistenten mit 1CRM. Jeder Nutzer arbeitet mit seinem eigenen 1CRM-Login und sieht nur, was er auch in 1CRM sehen darf.

Claude · Microsoft Copilot · Gemini · ChatGPT · Technische Details

Welcher Weg passt?

Voraussetzungen

• 1CRM Professional oder Enterprise mit aktivierter API (Administration → Systemeinstellungen → API).
• Für die Wege mit Anmeldung über 1CRM (alle Unternehmens-Connectoren, ChatGPT, Gemini Enterprise): die 1CRM-Erweiterung CRM Entra ID und je KI-Werkzeug ein eigener API-Client in 1CRM, weil sich die Redirect-URIs unterscheiden.

Auf diesem Server ist die Anmeldung über 1CRM (OAuth) nicht eingerichtet. Die Wege mit 1CRM-Anmeldung stehen erst zur Verfügung, wenn der Betreiber PUBLIC_URL und den Authorization Server konfiguriert hat.

Claude

Unternehmens-Connector (Team / Enterprise) empfohlen

Ein Owner der Organisation hinterlegt den Server einmal. Danach verbindet sich jedes Mitglied mit einem Klick und meldet sich mit dem eigenen 1CRM-Login an – bei aktivem SSO ohne weitere Eingabe. Keine lokale Installation, keine Passwortweitergabe; der Connector steht in Claude Desktop, im Web, auf Mobilgeräten und in Claude Code bereit.

1. In 1CRM unter Administration → API-Clients → Neu einen Client anlegen: Grant Type authorization_code, Redirect-URI https://claude.ai/api/mcp/auth_callback, Scopes read und write – Öffentlicher Client setzen, wenn kein Secret verwendet wird. Die Client-ID beim Betreiber dieses Servers in OAUTH_CLIENT_ID ergänzen lassen.
2. In Claude unter Organisationseinstellungen → Konnektoren → Hinzufügen → Benutzerdefiniert als URL https://beta.mcp.1crm.de/mcp eintragen (zeichengenau) und unter Erweiterte Einstellungen die Client-ID hinterlegen – ein Secret nur bei einem nicht-öffentlichen Client.
3. Jedes Mitglied klickt einmalig unter Anpassen → Konnektoren beim Eintrag „1CRM“ auf Verbinden und bestätigt die Freigabe in 1CRM.

Die Anmelde-Einstellungen eines Connectors lassen sich später nicht ändern – zum Wechseln den Connector entfernen und neu anlegen.

Hersteller-Doku: Eigene Connectors per Remote-MCP

Claude Desktop: Ein-Klick-Erweiterung

Für einzelne Nutzer ohne Administratorrechte oder ohne Team-/Enterprise-Plan. Die Erweiterung bringt alles mit (inkl. Node-Runtime) – keine Konfigurationsdateien, kein Node-Setup. Angemeldet wird mit 1CRM-Benutzername und -Passwort; die CRM-Entra-ID-Erweiterung ist dafür nicht nötig.

⬇ Erweiterung herunterladen (.mcpb)

1. In Claude Desktop Einstellungen → Erweiterungen öffnen und die .mcpb-Datei hineinziehen (oder unter Erweitert „Erweiterung installieren …“ wählen), dann Installieren.
2. 1CRM-Adresse, Benutzername und Passwort eintragen, optional Nur-Lesen aktivieren.
3. Fertig – 1CRM erscheint sofort mit seinen Werkzeugen.

Die Zugangsdaten bleiben lokal auf dem Rechner und gehen nur an Ihre 1CRM-Instanz. Organisationen können Erweiterungen zentral sperren oder freigeben. Erscheinen die Werkzeuge im Chat nicht, konkurrierende Connectoren wie „Claude in Chrome“ für den Chat deaktivieren.

Claude Code

Mit Anmeldung über 1CRM (eigener API-Client mit Loopback-Redirect, öffentlicher Client):

1. In 1CRM unter Administration → API-Clients → Neu einen Client anlegen: Grant Type authorization_code, Redirect-URI http://localhost:8080/callback, Scopes read und write. Die Client-ID beim Betreiber dieses Servers in OAUTH_CLIENT_ID ergänzen lassen.

claude mcp add --transport http 1crm https://beta.mcp.1crm.de/mcp \
  --client-id <CLIENT_ID> --callback-port 8080
# danach im Chat: /mcp → 1crm → anmelden

Oder mit 1CRM-Login als Header:

claude mcp add --transport http 1crm https://beta.mcp.1crm.de/mcp \
  --header "Authorization: Basic <BASE64_VON_BENUTZER:PASSWORT>"

Hersteller-Doku: Claude Code und MCP

Microsoft Copilot

Copilot bindet den Server direkt über Streamable HTTP an – ohne Brücke und ohne lokale Installation. Eingerichtet wird er einmal von einem Maker oder Administrator; das Ergebnis ist ein Agent, der in Copilot und Teams genutzt wird.

Copilot Studio empfohlen

1. Agent öffnen → Tools → Tool hinzufügen → Neues Tool → Model Context Protocol.
2. Name „1CRM“, eine kurze Beschreibung und als Server-URL https://beta.mcp.1crm.de/mcp eintragen.
3. Authentifizierung: OAuth 2.0 → Manuell mit Client-ID und Secret eines 1CRM-API-Clients sowie den Endpunkten …/api.php/auth/user/authorize und …/api.php/auth/user/access_token Ihrer 1CRM-Instanz. Die nach Erstellen angezeigte Callback-URL als Redirect-URI im API-Client eintragen. Ohne CRM-Entra-ID-Erweiterung: API-Schlüssel → Header Authorization mit dem Wert Basic … (ungetestet).
4. Erstellen → Tool hinzufügen → Neue Verbindung anlegen und dem Agenten hinzufügen.
5. Agent veröffentlichen und den Kanal Teams und Microsoft 365 Copilot aktivieren.

Benötigt eine Copilot-Studio- bzw. Microsoft-365-Copilot-Lizenz für den Maker und Copilot-Credits im Tenant; Power-Platform-Datenrichtlinien gelten.

Hersteller-Doku: Agent mit einem MCP-Server verbinden

Microsoft 365 Copilot (deklarativer Agent)

Für Entwickler: In VS Code mit dem Microsoft 365 Agents Toolkit einen Declarative Agent anlegen → Add an Action → Start with an MCP Server → URL eintragen. Authentifizierung über OAuth (static registration).

1. In 1CRM unter Administration → API-Clients → Neu einen Client anlegen: Grant Type authorization_code, Redirect-URI https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect, Scopes read und write. Die Client-ID beim Betreiber dieses Servers in OAUTH_CLIENT_ID ergänzen lassen.

Hersteller-Doku: Deklarative Agents mit MCP

Google Gemini

Gemini Enterprise

Ein Administrator legt in der Google Cloud Console einen Custom MCP Server als Datenspeicher an (Business-Edition: Einstellungen → Team verwalten → Verbundene Apps → MCP-Server hinzufügen). Nur Anmeldung über OAuth – feste Header werden nicht unterstützt.

1. In 1CRM unter Administration → API-Clients → Neu einen Client anlegen: Grant Type authorization_code, Redirect-URI https://vertexaisearch.cloud.google.com/oauth-redirect, Scopes read und write – mit Client-Secret. Die Client-ID beim Betreiber dieses Servers in OAUTH_CLIENT_ID ergänzen lassen.
2. Server-URL https://beta.mcp.1crm.de/mcp, Client-ID und -Secret, Authorization-URL …/api.php/auth/user/authorize, Token-URL …/api.php/auth/user/access_token, Scopes read write eintragen und PKCE aktivieren.
3. Aktionen neu laden und die gewünschten Aktionen aktivieren – sie sind anfangs ausgeschaltet.

Hersteller-Doku: Custom MCP Server einrichten

Gemini CLI

In ~/.gemini/settings.json:

{
  "mcpServers": {
    "1crm": {
      "httpUrl": "https://beta.mcp.1crm.de/mcp",
      "headers": {
        "Authorization": "Basic <BASE64_VON_BENUTZER:PASSWORT>"
      }
    }
  }
}

Mit OAuth statt Header: headers weglassen; die CLI erkennt die Anmeldung über das Discovery-Dokument, angemeldet wird mit /mcp auth 1crm.

Hersteller-Doku: MCP-Server in der Gemini CLI

Die Gemini-App für Privatkonten kann eigene Apps einbinden, ist aber auf private Google-Konten (USA, Englisch) beschränkt und für den Unternehmenseinsatz nicht geeignet.

ChatGPT

ChatGPT bindet den Server als eigene App über den Entwicklermodus ein (Plus, Pro, Business, Enterprise, Edu; nur im Web). Nur Anmeldung über OAuth – ein 1CRM-Login als Header ist nicht möglich, die CRM-Entra-ID-Erweiterung ist also Pflicht.

1. In 1CRM unter Administration → API-Clients → Neu einen Client anlegen: Grant Type authorization_code, Redirect-URI https://chatgpt.com/connector_platform_oauth_redirect, Scopes read und write. Die Client-ID beim Betreiber dieses Servers in OAUTH_CLIENT_ID ergänzen lassen.
2. Einstellungen → Sicherheit und Anmeldung → Entwicklermodus aktivieren (in Business/Enterprise nur durch Owner/Admins).
3. Eine neue App anlegen, als URL https://beta.mcp.1crm.de/mcp eintragen und unter OAuth die Client-ID (und ggf. das Secret) des API-Clients hinterlegen.
4. In Business/Enterprise die App nach dem Test für den Workspace veröffentlichen; jeder Nutzer meldet sich beim ersten Aufruf mit seinem 1CRM-Login an.

Schreibende Aktionen fragt ChatGPT vor der Ausführung ab. Menübezeichnungen ändern sich bei OpenAI häufig.

Hersteller-Doku: ChatGPT-Entwicklermodus

Codex CLI

In ~/.codex/config.toml, danach codex mcp login 1crm:

[mcp_servers.1crm]
url = "https://beta.mcp.1crm.de/mcp"
auth = "oauth"

Technische Details

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

Redirect-URIs der API-Clients

Clients ohne Remote-MCP (stdio-Brücke)

Clients, die nur stdio sprechen, verbinden sich über mcp-remote:

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

→ Was der Assistent mit 1CRM tun kann