Pipedrive MCP: CRM nach Sicherheitsstufe abfragen und ändern

Für wen

Wenn du in Claude Code oder Claude Desktop Pipedrive-CRM-Daten direkt abfragen, anlegen oder aktualisieren willst, passt dieser Dienst. Es ist ein MCP-Server für lokale oder selbst gehostete Szenarien, authentifiziert mit einem Pipedrive-API-Schlüssel.

Für alle, die bereits ein Pipedrive-Konto und einen API-Schlüssel haben und deren Client STDIO-MCP ausführen kann. Offiziell steht, der Transport sei derzeit nur STDIO, ohne gehostetes OAuth. Wer Remote-HTTP oder OAuth-Anmeldung braucht, findet auf dieser Seite keinen nutzbaren Pfad.

Der Paketname muss das gescopte @ckalima/pipedrive-mcp-server sein. Offiziell klar: Wenn ein altes Fragment das ungescopte pipedrive-mcp-server zitiert, ist das ein anderes, unabhängiges Paket; nicht falsch installieren.

Ersten Versuch in 3 Minuten abschließen

Der offiziell empfohlene Pfad ist geführte Installation. Voraussetzungen: Pipedrive-API-Schlüssel bereithalten, Client Claude Code oder Claude Desktop wählen, Transport nur STDIO.

Im Terminal ausführen:

npx -y @ckalima/pipedrive-mcp-server init

Der Führung folgen und den Server in die Client-Konfiguration schreiben. Wenn die Konfiguration von Hand geändert werden muss, ist der Befehl npx, die Argumente sind -y und @ckalima/pipedrive-mcp-server, und PIPEDRIVE_API_KEY in der Umgebung setzen. Keine Beispielschlüsselzeichenkette schreiben und keinen ungescopten Paketnamen verwenden.

Beim ersten Versuch PIPEDRIVE_MODE auf read-only setzen. Offiziell ist diese Stufe Nur-Lesen; die Standardstufe safe-write enthält bereits nicht-zerstörende Schreibvorgänge und passt nicht zum ersten Versuch.

Dann einen risikoarmen Aufruf machen: CRM-Daten abfragen. Offiziell kannst du vom Assistenten aus Query, create, and update CRM data; der erste Versuch macht nur Query. Offiziell gibt es keinen konkreten Toolnamen und keinen Objekttyp. Nur Abfrage-Tools verwenden, die der Client für diesen Server auflistet. Keine nicht vorkommenden Toolnamen erfinden und keine Datensätze anlegen oder aktualisieren.

Erfolgssignal: Ein Abfrageergebnis vorhandener Pipedrive-Datensätze kommt zurück, ohne Schreiben. Fehlen Schreib-Tools in der aktuellen Stufe, entspricht das der offiziellen Aussage: Tools außerhalb der Stufe werden verborgen, ein Direktaufruf wird abgelehnt.

Anwendungsfälle

Fall 1: Nur-Lese-CRM-Abfrage. PIPEDRIVE_MODE auf read-only setzen, dann vorhandene Daten abfragen. Offiziell steht nur Query CRM data, ohne Objekte, Filter oder Paginierung. Bei Erfolg solltest du vorhandene Datensätze sehen; eine Abfrage nicht als vollständigen Datenexport behandeln.

Fall 2: Datensätze in der Standardstufe safe-write anlegen oder aktualisieren. Offiziell ist die Standardstufe Lesen plus nicht-zerstörendes Schreiben, passend zu create und update. Das ändert CRM; vor dem Aufruf bestätigen, welchen Geschäftsdatensatz du ändern willst. Offiziell gibt es keine Feldliste und keine Beispielnutzlast. Nur die vom Client gezeigte Anlage- oder Aktualisierungsfähigkeit nutzen und vor der Ausführung den Schreibinhalt wiederholen. Deletes, conversions und andere irreversible writes gehören nicht in diese Stufe; offiziell öffnet erst die Stufe full sie.

Grenzen der Nutzung

PIPEDRIVE_MODE hat read-only, safe-write (Standard) und full. Tools außerhalb der Stufe erscheinen nicht in der Tool-Liste, ein Direktaufruf wird abgelehnt. Deletes, conversions und andere irreversible writes brauchen full; diese Stufe beim ersten Versuch nicht öffnen.

Transport derzeit nur STDIO; Streamable HTTP ist nur ein geplantes Kennzeichen und auf dieser Seite nicht als bereitgestellt behandeln. Authentifizierung ist ein Pipedrive-API-Schlüssel, ohne gehostetes OAuth. Der Schlüssel liegt in einer lokalen Umgebungsvariable; Abfragen und Schreibvorgänge gehen ins Netz zu Pipedrive.

Offiziell stehen keine Ratengrenzen und kein Widerruf. Ist ein Schreibvorgang erfolgreich, musst du ihn selbst in Pipedrive zurücksetzen. Der ungescopte Paketname pipedrive-mcp-server ist offiziell ein anderes, unabhängiges Paket.