Configureer de PandaNpc MCP-server voor Claude Code en Codex

Bijgewerkt

De PandaNpc MCP-server verbindt een MCP-compatibele codeeragent met je PandaNote-kennisbank, werklogboeken, geplande taken, modelconfiguratie en Agent Service Center. Het is nuttig wanneer een agent duurzame projectcontext nodig heeft in plaats van elke keer vanuit een leeg gesprek te starten.

De server draait lokaal via MCP's standaard invoer/uitvoer-transport. Je MCP-client start het pandanpc-mcp-proces wanneer een sessie wordt geopend; je hoeft geen poort bloot te stellen of een aparte webserver te draaien.

Voordat je installeert

Je hebt nodig:

  • Node.js en npm beschikbaar in dezelfde omgeving waar de MCP-client draait.
  • Een PandaNpc-account met toegang tot het e-mailadres dat voor verificatie wordt gebruikt.
  • Claude Code, OpenAI Codex, Cursor of een andere client die lokale stdio MCP-servers ondersteunt.

Als je wilt dat de agent werk op een van je eigen computers inplant, installeer en verbind dan eerst PandaPaw. De notities- en werkruimtetools vereisen geen online PandaPaw-apparaat.

De MCP-server installeren of bijwerken

Installeer het pakket globaal op macOS, Linux of Windows:

bash
npm install -g @pandanpc/mcp-server

Bevestig dat het uitvoerbare bestand zichtbaar is voor je shell:

bash
pandanpc-mcp --help

Voer hetzelfde npm-commando uit wanneer je wilt bijwerken. Herstart de MCP-client na een update, omdat een al draaiende client de procesversie behoudt die oorspronkelijk is gestart.

Raadpleeg de MCP-serverversiegeschiedenis wanneer een tool of het gedrag ervan afwijkt van een oudere screenshot of tutorial.

PandaNpc toevoegen aan Claude Code

De meest betrouwbare methode is Claude Code's eigen configuratiecommando. Gebruik gebruikersbereik als je PandaNpc in elk project beschikbaar wilt hebben:

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

Gebruik --scope project wanneer de configuratie via de huidige repository moet worden gedeeld, of --scope local wanneer deze alleen voor jou in het huidige project moet gelden.

Controleer de geregistreerde server:

bash
claude mcp get pandanpc
claude mcp list

Je kunt de stdio-server ook handmatig configureren in de MCP-configuratie die door je Claude Code-installatie wordt gebruikt:

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

PandaNpc toevoegen aan OpenAI Codex

Codex kan hetzelfde lokale proces vanaf de opdrachtregel registreren:

bash
codex mcp add pandanpc -- pandanpc-mcp

Controleer de opgeslagen configuratie:

bash
codex mcp get pandanpc
codex mcp list

Het equivalente item in ~/.codex/config.toml is:

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

Herstart Codex of open een nieuwe sessie na het toevoegen van de server. Als je een aangepast Codex-configuratiebestand onderhoudt, plaats de MCP-tabel dan in dat bestand in plaats van deze over bestanden te dupliceren.

Cursor en andere MCP-clients configureren

Voeg voor Cursor een lokale server toe aan ~/.cursor/mcp.json met dezelfde JSON-vorm als weergegeven voor Claude Code. Maak voor Windsurf en andere clients een stdio MCP waarvan het commando pandanpc-mcp is en waarvan de argumentenlijst leeg is.

Het uitvoerbare bestand moet zich op het PATH bevinden dat door de grafische toepassing wordt overgeërfd. Als het in een terminal werkt maar de desktopclient 'command not found' meldt, gebruik dan het absolute pad naar het uitvoerbare bestand dat door de volgende opdracht wordt geretourneerd:

bash
command -v pandanpc-mcp

Gebruik op Windows PowerShell:

powershell
Get-Command pandanpc-mcp

Inloggen vanuit de agent

PandaNpc gebruikt een e-mailverificatieproces in twee stappen. Vraag de agent om deze acties in volgorde uit te voeren:

  1. Roep note_login aan met je e-mailadres. PandaNpc stuurt een verificatiecode.
  2. Roep note_login opnieuw aan met hetzelfde e-mailadres en de code.

De lokale referentie wordt gecachet, dus je hoeft niet bij elke sessie in te loggen. Plak de verificatiecode nooit in een openbaar transcript of een gedeelde prompt.

De MCP-verbinding verifiëren

Voer een kleine alleen-lezentest uit voordat je de agent gegevens laat maken of bewerken:

  1. Vraag het om list_workspaces aan te roepen.
  2. Vraag het om list_notes aan te roepen voor één werkruimte.
  3. Vraag het om met search_notes naar een onschuldig sleutelwoord te zoeken.

Een succesvolle reactie bewijst dat de MCP-client het proces heeft gestart, de authenticatie is voltooid en de account-API bereikbaar is. Maak voor een schrijftest een wegwerpnotitie aan en soft-delete deze daarna.

De exacte toollijst die je MCP-client toont, is de bron van waarheid voor de geïnstalleerde versie. Tools zijn gegroepeerd rond deze workflows:

Workflow Typische tools Belangrijk gedrag
Notities list_notes, create_note, read_note, update_note, search_notes update_note vervangt de volledige inhoud; lees vóór het bewerken
Werklogboeken save_done Slaat voltooid werk automatisch op in de projectmap van vandaag
Werkruimten list_workspaces, create_workspace, update_workspace Een gebonden projectpad stelt de server in staat de juiste werkruimte te vinden
Gepland werk list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs Een PandaPaw-machine moet online zijn; cron-expressies gebruiken zes velden
Providers en modellen list_providers, list_models, tools voor maken, bijwerken en verwijderen Maak eerst een lijst, zodat je actuele ID's en geldige modeltypen gebruikt
Regels en vaardigheden sync_rules Synchroniseert ondersteunde projectinstructies terwijl ongewijzigde bestanden worden overgeslagen

Zie Aangepaste AI-providers en API-sleutels voor velddefinities van providers en modellen. Zie PandaNpc-accounts, abonnementen en API-kosten voor account- en factureringsgrenzen.

Veilige werkwijzen

  • Begin met lijst-, lees- of zoektools voordat je acties uitvoert voor maken, bijwerken, verwijderen of plannen.
  • Lees een notitie voordat je deze bijwerkt, omdat notitie-updates het hele Markdown-document vervangen in plaats van een patch toe te passen.
  • Behandel geplande prompts als code-uitvoeringsverzoeken: bevestig de doelcomputer, werkmap, tijdzone en cron-expressie met zes velden.
  • Houd provider-API-sleutels buiten prompts en notities. Voer geheimen alleen in via de beoogde providerconfiguratiestroom.
  • Controleer de MCP-toolgoedkeuringskaart voordat je destructieve of externe acties toestaat.
  • Gebruik save_done voor werklogboeken in plaats van handmatig de juiste werkruimte en datummapper te raden.

Problemen oplossen

De client meldt dat `pandanpc-mcp` niet is gevonden

Open na installatie een nieuwe terminal en controleer het pad naar het uitvoerbare bestand. Desktoptoepassingen erven soms een ouder PATH; configureer het absolute pad of herstart de toepassing. Als npm via een versiebeheerder is geïnstalleerd, zorg er dan voor dat de MCP-client onder dezelfde gebruiker en omgeving start.

De server is geregistreerd maar er verschijnen geen tools

Herstart de client en inspecteer vervolgens claude mcp get pandanpc of codex mcp get pandanpc. Verwijder het item en voeg het opnieuw toe als het commando onjuist is. Controleer ook dat je het lokale stdio-proces niet als HTTP-URL hebt geconfigureerd.

Tools melden dat je niet bent geauthenticeerd

Herhaal de twee note_login-aanroepen. Gebruik de nieuwste verificatiecode, controleer de spammap en bevestig dat beide aanroepen hetzelfde e-mailadres gebruiken.

Geplande taken kunnen geen machine vinden

Roep eerst list_scheduled_bridges aan. Als er geen beschikbaar apparaat wordt geretourneerd, controleer dan de PandaPaw-status en apparaatconnectiviteit op de doelcomputer. Een machine die is uitgeschakeld, slaapt, is afgemeld of de verbinding is verbroken, kan geen geplande uitvoering starten.

Een notitie-update heeft bestaande tekst verwijderd

update_note accepteert de volledige vervangende inhoud. Herstel de notitie uit de geschiedenis of prullenbak waar beschikbaar, lees vervolgens de huidige inhoud en dien het gecombineerde document in.

Hulp nodig die specifiek is voor je account? Neem contact op met support@pandanpc.com en vermeld de naam van de MCP-client, het besturingssysteem, de pakketversie en het exacte foutbericht zonder geheimen.