Pinecone MCP Server einrichten

Der Pinecone MCP Server verbindet Coding-Assistenten wie Cursor, Claude Code und Claude Desktop direkt mit Pinecone-Projekten und deren offizieller Dokumentation. Laut offizieller Pinecone-Dokumentation kann ein verbundener Agent Dokumentation durchsuchen, Indexes verwalten, Datensätze einspielen und semantisch suchen, ohne zwischen Assistent und Pinecone-Konsole wechseln zu müssen. Dieser Guide zeigt, wie man den Server sicher einrichtet, welche Voraussetzungen nötig sind und worauf beim Einsatz in der Entwicklung zu achten ist.

Voraussetzungen prüfen

Vor der Einrichtung sind drei Dinge sicherzustellen: Erstens muss Node.js v20 oder neuer installiert sein. Überprüfe das mit node --version. Zweitens muss npx im PATH verfügbar sein, prüfe mit which npx. Drittens benötigt man einen Pinecone API-Key, den man über die Pinecone-Konsole erstellen kann. Ohne API-Key steht laut Dokumentation nur die Dokumentationssuche zur Verfügung; Indexoperationen sind nicht möglich. Halte den Key bereit, aber hinterlege ihn noch nicht in Konfigurationsdateien, bis der Speicherort gesichert ist.

Prüfe außerdem, welchen Client du verwendest. Cursor, Claude Desktop, Claude Code und Antigravity werden in der offiziellen Dokumentation explizit beschrieben. Für Gemini CLI dokumentiert das Repository eine Erweiterungsinstallation. Stelle sicher, dass der verwendete Client aktuelle MCP-Unterstützung besitzt, bevor du mit der Konfiguration beginnst.

API-Key sicher hinterlegen

Der PINECONE_API_KEY gehört in die Secret- oder Credential-Verwaltung des Clients, nicht in den Quellcode, nicht in eine geteilte Konfigurationsdatei und nicht als Klartext in den Terminal-Verlauf. Die meisten Clients bieten eine Umgebungsvariablen-Verwaltung oder Secret-Funktion, über die der Key dem MCP-Prozess zur Verfügung gestellt werden kann. Nutze diese, statt den Key direkt in JSON-Konfigurationsdateien einzutragen, die versehentlich in ein Repository eingecheckt werden könnten.

Wenn ein Key doch in eine Konfigurationsdatei eingefügt wurde, füge die Datei sofort zur .gitignore hinzu, bevor sie ins Repository gelangt. Rotiere oder widerrufe einen möglicherweise offengelegten Key über die Pinecone-Konsole. Der Key ermöglicht Schreib- und Lesezugriff auf dein Pinecone-Projekt; ein offengelegter Key sollte umgehend gesperrt werden.

Cursor einrichten

Für die projektbezogene Einrichtung legt man im Projektstamm eine Datei .cursor/mcp.json an und fügt folgende Konfiguration ein:

{
  "mcpServers": {
    "pinecone": {
      "command": "npx",
      "args": ["-y", "@pinecone-database/mcp"],
      "env": {
        "PINECONE_API_KEY": "<dein-api-key>"
      }
    }
  }
}

Ersetze <dein-api-key> durch den tatsächlichen Key, oder nutze eine Cursor-spezifische Secret-Funktion. Für eine globale Einrichtung auf dem Rechner legt man die Datei im Home-Verzeichnis unter .cursor/mcp.json an. Den Status des Servers prüft man unter Cursor Settings > MCP. Die offizielle Dokumentation empfiehlt außerdem, Cursor-Regeln für die korrekte Nutzung des MCP-Servers zu hinterlegen.

Claude Desktop einrichten

In Claude Desktop öffnet man Settings > Developer > Edit Config und fügt die Konfiguration in die claude_desktop_config.json ein. Der Aufbau entspricht dem Cursor-Beispiel oben. Nach dem Speichern der Konfiguration startet man Claude Desktop neu. Auf dem neuen Chat-Bildschirm sollte ein Hammer-Icon erscheinen, das die verfügbaren MCP-Werkzeuge anzeigt. Falls das Icon ausbleibt, prüfe die JSON-Syntax der Konfigurationsdatei und ob Node.js korrekt installiert ist.

Claude Code einrichten

Für Claude Code verwendet man folgenden Befehl:

claude mcp add-json pinecone-mcp \
  '{"type": "stdio",
    "command": "npx",
    "args": ["-y", "@pinecone-database/mcp"],
    "env": {"PINECONE_API_KEY": "YOUR_API_KEY"}}'

Nach einem Neustart von Claude Code prüft man den Status mit /mcp. Die offizielle Dokumentation beschreibt außerdem das Pinecone Claude Code Plugin, das den MCP-Server, acht Skills und Slash-Commands bündelt, falls eine umfassendere Integration gewünscht ist.

Ersten Test durchführen

Nach der Einrichtung beginnt man mit einer unkritischen Anfrage an die Dokumentation, beispielsweise: „Suche in den Pinecone-Docs nach Informationen zu Metadaten-Filterung." Damit prüft man, ob der Assistent das Tool erkennt und nutzt, ohne sofort schreibende Operationen auszuführen. Funktioniert das, kann man mit list-indexes die eigenen Indexes auflisten, um den Projektzugriff zu verifizieren.

Für erste Schreiboperationen wählt man eine Testumgebung oder einen Namespace, der keine Produktionsdaten enthält. Erstelle einen Index mit create-index-for-model, spiele Testdaten ein und suche danach. So kann man Abfragen und Ergebnisse direkt in der Entwicklungsumgebung bewerten, bevor echter Inhalt eingespeilt wird.

Grenzen des MCP-Servers kennen

Laut offizieller Dokumentation unterstützt der Pinecone Developer MCP Server ausschließlich Indexes mit integrierter Inferenz. Eigene Embedding-Modelle und einfache Vektorsuche ohne integrierte Inferenz werden nicht unterstützt. Für den Zugriff auf Pinecone Assistants und deren Wissensdatenbanken gibt es einen separaten Pinecone Assistant MCP Server, der unabhängig konfiguriert wird. Trenne diese beiden Anwendungsfälle klar, um Konfigurationsfehler zu vermeiden.

Schreibrechte und menschliche Freigabe

Operationen wie upsert-records und create-index-for-model verändern das Pinecone-Projekt dauerhaft. In einem Produktionsumfeld gehört eine explizite Freigabe durch eine verantwortliche Person in den Prozess, bevor der Assistent solche Änderungen ausführt. Beschränke die Agentenrechte auf die tatsächlich benötigten Operationen. Daten, die über upsert-records eingespeilt werden, verlassen das lokale Gerät und werden auf Pinecone-Servern gespeichert; prüfe vor dem Einsatz sensibler Inhalte die Pinecone-Datenschutzrichtlinien und Nutzungsbedingungen direkt beim Anbieter. Dieser Guide nennt bewusst keine Preisbeträge.

FAQ

Welches npm-Paket startet den Pinecone MCP Server? @pinecone-database/mcp, gestartet über npx -y @pinecone-database/mcp.

Brauche ich einen API-Key für die Dokumentationssuche? Nein. Die Dokumentationssuche ist laut offizieller Dokumentation auch ohne API-Key verfügbar. Für Indexoperationen ist ein Key erforderlich.

Wie prüfe ich, ob der Server aktiv ist? In Cursor unter Settings > MCP; in Claude Code mit dem Befehl /mcp.