Konfigurer PandaNpc MCP-serveren for Claude Code og Codex

Oppdatert

PandaNpc MCP-serveren kobler en MCP-kompatibel kodeagent til PandaNote-kunnskapsbasen din, arbeidslogger, planlagte oppgaver, modellkonfigurasjon og Agent Service Center. Det er nyttig når en agent trenger varig prosjektkontekst i stedet for å starte fra en tom samtale hver gang.

Serveren kjører lokalt over MCPs standard inn-/ut-transport. MCP-klienten din starter pandanpc-mcp-prosessen når en økt åpnes; du trenger ikke å eksponere en port eller kjøre en egen web-server.

Før du installerer

Du trenger:

  • Node.js og npm tilgjengelig i samme miljø der MCP-klienten kjører.
  • En PandaNpc-konto med tilgang til e-postadressen som brukes til verifisering.
  • Claude Code, OpenAI Codex, Cursor eller en annen klient som støtter lokale stdio MCP-servere.

Hvis du vil at agenten skal planlegge arbeid på en av dine egne datamaskiner, installer og koble til PandaPaw først. Notat- og arbeidsområdeverktøyene krever ikke en online PandaPaw-enhet.

Installer eller oppdater MCP-serveren

Installer pakken globalt på macOS, Linux eller Windows:

bash
npm install -g @pandanpc/mcp-server

Bekreft at den kjørbare filen er synlig i shellen din:

bash
pandanpc-mcp --help

Kjør den samme npm-kommandoen når du vil oppdatere. Start MCP-klienten på nytt etter en oppdatering, fordi en allerede kjørende klient beholder prosessversjonen den opprinnelig startet.

Se MCP-serverens versjonshistorikk når et verktøy eller oppførselen avviker fra et eldre skjermbilde eller en eldre veiledning.

Legg til PandaNpc i Claude Code

Den mest pålitelige metoden er Claude Codes egen konfigurasjonskommando. Bruk user scope hvis du vil at PandaNpc skal være tilgjengelig i hvert prosjekt:

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

Bruk --scope project i stedet når konfigurasjonen skal deles gjennom det gjeldende repositoriet, eller --scope local når den bare skal gjelde for deg i det gjeldende prosjektet.

Sjekk den registrerte serveren:

bash
claude mcp get pandanpc
claude mcp list

Du kan også konfigurere stdio-serveren manuelt i MCP-konfigurasjonen som brukes av Claude Code-installasjonen din:

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

Legg til PandaNpc i OpenAI Codex

Codex kan registrere den samme lokale prosessen fra kommandolinjen:

bash
codex mcp add pandanpc -- pandanpc-mcp

Bekreft den lagrede konfigurasjonen:

bash
codex mcp get pandanpc
codex mcp list

Den tilsvarende oppføringen i ~/.codex/config.toml er:

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

Start Codex på nytt eller åpne en ny økt etter at du har lagt til serveren. Hvis du vedlikeholder en egendefinert Codex-konfigurasjonsfil, legg MCP-tabellen i den filen i stedet for å duplisere den i flere filer.

Konfigurer Cursor og andre MCP-klienter

For Cursor legger du til en lokal server i ~/.cursor/mcp.json med samme JSON-struktur som vist for Claude Code. For Windsurf og andre klienter oppretter du en stdio MCP-server der kommandoen er pandanpc-mcp og argumentlisten er tom.

Den kjørbare filen må være på PATH som arves av den grafiske applikasjonen. Hvis den fungerer i en terminal, men skrivebordsklienten rapporterer «command not found», bruk den absolutte stien til den kjørbare filen som returneres av følgende kommando:

bash
command -v pandanpc-mcp

På Windows PowerShell bruker du:

powershell
Get-Command pandanpc-mcp

Logg inn fra agenten

PandaNpc bruker en to-trinns e-postverifiseringsprosess. Be agenten utføre disse handlingene i rekkefølge:

  1. Kall note_login med e-postadressen din. PandaNpc sender en verifiseringskode.
  2. Kall note_login på nytt med samme e-postadresse og koden.

Den lokale legitimasjonen er bufret, så du bør ikke trenge å logge inn i hver økt. Lim aldri verifiseringskoden inn i et offentlig transkript eller en delt prompt.

Bekreft MCP-tilkoblingen

Kjør en liten skrivebeskyttet test før du lar agenten opprette eller redigere data:

  1. Be den om å kalle list_workspaces.
  2. Be den om å kalle list_notes for ett arbeidsområde.
  3. Be den om å søke etter et ufarlig søkeord med search_notes.

Et vellykket svar beviser at MCP-klienten startet prosessen, autentiseringen ble fullført, og at API-en for kontoen er tilgjengelig. For en skrivetest oppretter du et engangsnotat og sletter det deretter mykt (soft-delete).

Den nøyaktige verktøylisten som vises av MCP-klienten din, er sannhetskilden for den installerte versjonen. Verktøyene er gruppert rundt disse arbeidsflytene:

Arbeidsflyt Typiske verktøy Viktig oppførsel
Notater list_notes, create_note, read_note, update_note, search_notes update_note erstatter hele brødteksten; les før du redigerer
Arbeidslogger save_done Lagrer utført arbeid i dagens prosjektmappe automatisk
Arbeidsområder list_workspaces, create_workspace, update_workspace En bundet prosjektsti lar serveren finne riktig arbeidsområde
Planlagt arbeid list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs En PandaPaw-maskin må være online; cron-uttrykk bruker seks felt
Leverandører og modeller list_providers, list_models, create/update/delete-verktøy List først slik at du bruker gjeldende ID-er og gyldige modelltyper
Regler og ferdigheter sync_rules Synkroniserer støttede prosjektinstruksjoner og hopper over uendrede filer

For feltdefinisjoner for leverandør og modell, se Egendefinerte AI-leverandører og API keys. For kontogrenser og faktureringsgrenser, se PandaNpc-kontoer, -planer og API-kostnader.

Trygg operasjonspraksis

  • Start med liste-, lese- eller søkeverktøy før du oppretter, oppdaterer, sletter eller planlegger handlinger.
  • Les et notat før du oppdaterer det, fordi notatoppdateringer erstatter hele Markdown-dokumentet i stedet for å bruke en patch.
  • Behandle planlagte prompt som kjøring av kode: bekreft målmaskinen, arbeidskatalogen, tidssonen og cron-uttrykket med seks felt.
  • Hold leverandørenes API keys ute av prompt og notater. Skriv inn hemmeligheter bare gjennom den tiltenkte leverandørkonfigurasjonsflyten.
  • Gå gjennom MCP-verktøyets godkjenningskort før du tillater destruktive eller eksterne handlinger.
  • Bruk save_done for arbeidslogger i stedet for manuelt å gjette riktig arbeidsområde og datamappe.

Feilsøking

Klienten sier at `pandanpc-mcp` ikke ble funnet

Åpne en ny terminal etter installasjonen og sjekk stien til den kjørbare filen. Skrivebordsapplikasjoner arver noen ganger en eldre PATH; konfigurer den absolutte stien eller start applikasjonen på nytt. Hvis npm ble installert gjennom en versjonsbehandler, må du sørge for at MCP-klienten starter under samme bruker og miljø.

Serveren er registrert, men ingen verktøy vises

Start klienten på nytt, og undersøk deretter claude mcp get pandanpc eller codex mcp get pandanpc. Fjern og legg til oppføringen igjen hvis kommandoen er feil. Sjekk også at du ikke har konfigurert den lokale stdio-prosessen som en HTTP-URL.

Verktøy sier at du ikke er autentisert

Gjenta de to note_login-kallene. Bruk den nyeste verifiseringskoden, sjekk søppelmappen, og bekreft at begge kallene bruker samme e-postadresse.

Planlagte oppgaver finner ingen maskin

Kall list_scheduled_bridges først. Hvis den ikke returnerer noen tilgjengelig enhet, kontroller PandaPaw-status og enhetstilkobling på målmaskinen. En maskin som er slått av, sover, er logget ut eller frakoblet, kan ikke starte en planlagt kjøring.

En notatoppdatering fjernet eksisterende tekst

update_note godtar hele erstatningsinnholdet. Gjenopprett notatet fra historikken eller papirkurven der det er tilgjengelig, les deretter det gjeldende innholdet og send inn det kombinerte dokumentet.

Trenger du hjelp som gjelder kontoen din? Kontakt support@pandanpc.com, og oppgi MCP-klientens navn, operativsystem, pakkeversjon og den nøyaktige feilmeldingen uten hemmeligheter.