Konfigurieren des PandaNpc MCP-Servers für Claude Code und Codex

Aktualisiert

Der PandaNpc MCP-Server verbindet einen MCP-kompatiblen Codierungsagenten mit Ihrer PandaNote-Wissensbasis, Arbeitsprotokollen, geplanten Aufgaben, Modellkonfiguration und dem Agent Service Center. Er ist nützlich, wenn ein Agent dauerhaften Projektkontext benötigt, anstatt jedes Mal mit einer leeren Konversation zu beginnen.

Der Server läuft lokal über den Standard-Eingabe-/Ausgabe-Transport von MCP. Ihr MCP-Client startet den Prozess pandanpc-mcp, wenn eine Sitzung geöffnet wird; Sie müssen keinen Port freigeben oder einen separaten Webserver ausführen.

Vor der Installation

Sie benötigen:

  • Node.js und npm in derselben Umgebung, in der der MCP-Client läuft.
  • Ein PandaNpc-Konto mit Zugriff auf die für die Verifizierung verwendete E-Mail-Adresse.
  • Claude Code, OpenAI Codex, Cursor oder einen anderen Client, der lokale Stdio-MCP-Server unterstützt.

Wenn der Agent Arbeiten auf einem Ihrer eigenen Computer planen soll, installieren und verbinden Sie zuerst PandaPaw. Die Notiz- und Arbeitsbereichs-Tools erfordern kein online verfügbares PandaPaw-Gerät.

MCP-Server installieren oder aktualisieren

Installieren Sie das Paket global unter macOS, Linux oder Windows:

bash
npm install -g @pandanpc/mcp-server

Bestätigen Sie, dass die ausführbare Datei für Ihre Shell sichtbar ist:

bash
pandanpc-mcp --help

Führen Sie denselben npm-Befehl aus, wann immer Sie aktualisieren möchten. Starten Sie den MCP-Client nach einem Update neu, da ein bereits laufender Client die ursprünglich gestartete Prozessversion beibehält.

Überprüfen Sie die MCP-Server-Versionshistorie, wenn ein Tool oder sein Verhalten von einem älteren Screenshot oder Tutorial abweicht.

PandaNpc zu Claude Code hinzufügen

Die zuverlässigste Methode ist der eigene Konfigurationsbefehl von Claude Code. Verwenden Sie den Benutzerbereich, wenn PandaNpc in jedem Projekt verfügbar sein soll:

bash
claude mcp add --scope user pandanpc -- pandanpc-mcp

Verwenden Sie stattdessen --scope project, wenn die Konfiguration über das aktuelle Repository geteilt werden soll, oder --scope local, wenn sie nur für Sie im aktuellen Projekt gelten soll.

Überprüfen Sie den registrierten Server:

bash
claude mcp get pandanpc
claude mcp list

Sie können den Stdio-Server auch manuell in der MCP-Konfiguration konfigurieren, die von Ihrer Claude-Code-Installation verwendet wird:

json
{
  "mcpServers": {
    "pandanpc": {
      "command": "pandanpc-mcp"
    }
  }
}

PandaNpc zu OpenAI Codex hinzufügen

Codex kann denselben lokalen Prozess über die Befehlszeile registrieren:

bash
codex mcp add pandanpc -- pandanpc-mcp

Überprüfen Sie die gespeicherte Konfiguration:

bash
codex mcp get pandanpc
codex mcp list

Der entsprechende Eintrag in ~/.codex/config.toml lautet:

toml
[mcp_servers.pandanpc]
command = "pandanpc-mcp"

Starten Sie Codex neu oder öffnen Sie nach dem Hinzufügen des Servers eine neue Sitzung. Wenn Sie eine benutzerdefinierte Codex-Konfigurationsdatei verwalten, fügen Sie die MCP-Tabelle in diese Datei ein, anstatt sie über mehrere Dateien zu duplizieren.

Cursor und andere MCP-Clients konfigurieren

Für Cursor fügen Sie einen lokalen Server zu ~/.cursor/mcp.json hinzu, und zwar mit derselben JSON-Form, die für Claude Code gezeigt wird. Für Windsurf und andere Clients erstellen Sie einen Stdio-MCP-Server, dessen Befehl pandanpc-mcp und dessen Argumentliste leer ist.

Die ausführbare Datei muss sich im PATH befinden, den die grafische Anwendung erbt. Wenn sie in einem Terminal funktioniert, der Desktop-Client jedoch „Befehl nicht gefunden“ meldet, verwenden Sie den absoluten Pfad zur ausführbaren Datei, der von folgendem Befehl zurückgegeben wird:

bash
command -v pandanpc-mcp

Verwenden Sie unter Windows PowerShell:

powershell
Get-Command pandanpc-mcp

Vom Agenten aus anmelden

PandaNpc verwendet einen zweistufigen E-Mail-Verifizierungsablauf. Bitten Sie den Agenten, diese Aktionen in der richtigen Reihenfolge auszuführen:

  1. Rufen Sie note_login mit Ihrer E-Mail-Adresse auf. PandaNpc sendet einen Verifizierungscode.
  2. Rufen Sie note_login erneut mit derselben E-Mail-Adresse und dem Code auf.

Die lokalen Anmeldeinformationen werden zwischengespeichert, sodass Sie sich nicht in jeder Sitzung anmelden müssen. Fügen Sie den Verifizierungscode niemals in ein öffentliches Transkript oder einen gemeinsamen Prompt ein.

MCP-Verbindung überprüfen

Führen Sie einen kleinen Nur-Lese-Test durch, bevor Sie dem Agenten erlauben, Daten zu erstellen oder zu bearbeiten:

  1. Bitten Sie es, list_workspaces aufzurufen.
  2. Bitten Sie es, list_notes für einen Arbeitsbereich aufzurufen.
  3. Bitten Sie es, mit search_notes nach einem harmlosen Schlüsselwort zu suchen.

Eine erfolgreiche Antwort beweist, dass der MCP-Client den Prozess gestartet hat, die Authentifizierung abgeschlossen wurde und die Konto-API erreichbar ist. Für einen Schreiblauf erstellen Sie eine Wegwerf-Notiz und löschen Sie sie anschließend per Soft-Delete.

Die genaue Tool-Liste, die Ihr MCP-Client anzeigt, ist die maßgebliche Quelle für die installierte Version. Tools sind um diese Arbeitsabläufe gruppiert:

Workflow Typische Tools Wichtiges Verhalten
Notizen list_notes, create_note, read_note, update_note, search_notes update_note ersetzt den gesamten Textkörper; vor dem Bearbeiten lesen
Arbeitsprotokolle save_done Speichert erledigte Arbeit automatisch im heutigen Projektordner
Arbeitsbereiche list_workspaces, create_workspace, update_workspace Ein gebundener Projektpfad ermöglicht es dem Server, den richtigen Arbeitsbereich zu finden
Geplante Arbeiten list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs Eine PandaPaw-Maschine muss online sein; Cron-Ausdrücke verwenden sechs Felder
Anbieter und Modelle list_providers, list_models, Erstellen-/Aktualisieren-/Löschen-Tools Zuerst auflisten, damit Sie aktuelle IDs und gültige Modelltypen verwenden
Regeln und Fähigkeiten sync_rules Synchronisiert unterstützte Projektanweisungen und überspringt unveränderte Dateien

Für Felddefinitionen zu Anbietern und Modellen siehe Benutzerdefinierte KI-Anbieter und API-Schlüssel. Für Konto- und Abrechnungsgrenzen siehe PandaNpc-Konten, Pläne und API-Kosten.

Sichere Betriebspraktiken

  • Beginnen Sie mit Listen-, Lese- oder Such-Tools, bevor Sie Aktionen zum Erstellen, Aktualisieren, Löschen oder Planen ausführen.
  • Lesen Sie eine Notiz, bevor Sie sie aktualisieren, da Notizaktualisierungen das gesamte Markdown-Dokument ersetzen, anstatt einen Patch anzuwenden.
  • Behandeln Sie geplante Prompts wie Codeausführungsanfragen: Bestätigen Sie Zielmaschine, Arbeitsverzeichnis, Zeitzone und den Cron-Ausdruck mit sechs Feldern.
  • Halten Sie Anbieter-API-Schlüssel aus Prompts und Notizen heraus. Geben Sie Geheimnisse nur über den vorgesehenen Konfigurationsablauf des Anbieters ein.
  • Überprüfen Sie die MCP-Tool-Genehmigungskarte, bevor Sie destruktive oder externe Aktionen zulassen.
  • Verwenden Sie save_done für Arbeitsprotokolle, anstatt manuell den richtigen Arbeitsbereich und Datumsordner zu erraten.

Fehlerbehebung

Der Client meldet, dass `pandanpc-mcp` nicht gefunden wurde

Öffnen Sie nach der Installation ein neues Terminal und überprüfen Sie den Pfad zur ausführbaren Datei. Desktop-Anwendungen erben manchmal einen älteren PATH. Konfigurieren Sie den absoluten Pfad oder starten Sie die Anwendung neu. Wenn npm über einen Versionsmanager installiert wurde, stellen Sie sicher, dass der MCP-Client unter demselben Benutzer und derselben Umgebung gestartet wird.

Der Server ist registriert, aber es werden keine Tools angezeigt

Starten Sie den Client neu und überprüfen Sie anschließend claude mcp get pandanpc oder codex mcp get pandanpc. Entfernen Sie den Eintrag und fügen Sie ihn erneut hinzu, wenn der Befehl falsch ist. Stellen Sie außerdem sicher, dass Sie den lokalen Stdio-Prozess nicht als HTTP-URL konfiguriert haben.

Tools melden, dass Sie nicht authentifiziert sind

Wiederholen Sie die beiden note_login-Aufrufe. Verwenden Sie den neuesten Verifizierungscode, überprüfen Sie den Spam-Ordner und stellen Sie sicher, dass beide Aufrufe dieselbe E-Mail-Adresse verwenden.

Geplante Aufgaben können keine Maschine finden

Rufen Sie zuerst list_scheduled_bridges auf. Wenn kein verfügbares Gerät zurückgegeben wird, überprüfen Sie den PandaPaw-Status und die Gerätekonnektivität auf der Zielmaschine. Eine Maschine, die ausgeschaltet ist, schläft, abgemeldet ist oder keine Verbindung hat, kann keinen geplanten Lauf starten.

Eine Notizaktualisierung hat vorhandenen Text entfernt

update_note akzeptiert den vollständigen Ersatztextkörper. Stellen Sie die Notiz gegebenenfalls aus ihrem Verlauf oder Papierkorb wieder her, lesen Sie dann den aktuellen Inhalt und übermitteln Sie das kombinierte Dokument.

Benötigen Sie kontospezifische Hilfe? Kontaktieren Sie support@pandanpc.com und geben Sie den MCP-Clientnamen, das Betriebssystem, die Paketversion und die genaue Fehlermeldung ohne Geheimnisse an.