Konfigurér PandaNpc MCP-serveren til Claude Code og Codex

Opdateret 2026-08-18

PandaNpc MCP-serveren forbinder en MCP-kompatibel kodningsagent til din PandaNote-vidensbase, arbejdslogge, planlagte opgaver, modelkonfiguration og Agent Service Center. Det er nyttigt, når en agent har brug for varig projektkontekst i stedet for at starte fra en tom samtale hver gang.

Serveren kører lokalt over MCP's standard input/output-transport. Din MCP-klient starter pandanpc-mcp-processen, når en session åbnes; du behøver ikke at blotlægge en port eller køre en separat webserver.

Før du installerer

Du skal bruge:

Node.js og npm tilgængelige i samme miljø, hvor MCP-klienten kører.
En PandaNpc-konto med adgang til den e-mailadresse, der bruges til verifikation.
Claude Code, OpenAI Codex, Cursor eller en anden klient, der understøtter lokale stdio MCP-servere.

Hvis du vil have agenten til at planlægge arbejde på en af dine egne computere, skal du installere og forbinde PandaPaw først. Note- og arbejdsområdeværktøjerne kræver ikke en online PandaPaw-enhed.

Installér eller opdater MCP-serveren

Installér pakken globalt på macOS, Linux eller Windows:

bash

npm install -g @pandanpc/mcp-server

Bekræft, at den eksekverbare fil er synlig for din shell:

bash

pandanpc-mcp --help

Kør den samme npm-kommando, når du vil opdatere. Genstart MCP-klienten efter en opdatering, fordi en allerede kørende klient beholder den procesversion, den oprindeligt startede med.

Tjek MCP-serverens versionshistorik, når et værktøj eller dets adfærd adskiller sig fra et ældre skærmbillede eller en ældre vejledning.

Tilføj PandaNpc til Claude Code

Den mest pålidelige metode er Claude Codes egen konfigurationskommando. Brug brugerområde (user scope), hvis du vil have PandaNpc tilgængelig i alle projekter:

bash

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

Brug i stedet --scope project, når konfigurationen skal deles via det aktuelle repository, eller --scope local, når den kun skal gælde for dig i det aktuelle projekt.

Tjek den registrerede server:

bash

claude mcp get pandanpc
claude mcp list

Du kan også konfigurere stdio-serveren manuelt i den MCP-konfiguration, der bruges af din Claude Code-installation:

json

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

Tilføj PandaNpc til OpenAI Codex

Codex kan registrere den samme lokale proces fra kommandolinjen:

bash

codex mcp add pandanpc -- pandanpc-mcp

Bekræft den gemte konfiguration:

bash

codex mcp get pandanpc
codex mcp list

Den tilsvarende indgang i ~/.codex/config.toml er:

toml

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

Genstart Codex, eller åbn en ny session efter at have tilføjet serveren. Hvis du vedligeholder en brugerdefineret Codex-konfigurationsfil, skal du placere MCP-tabellen i den fil i stedet for at duplikere den på tværs af filer.

Konfigurér Cursor og andre MCP-klienter

For Cursor skal du tilføje en lokal server til ~/.cursor/mcp.json med samme JSON-struktur som vist for Claude Code. For Windsurf og andre klienter skal du oprette en stdio MCP-server, hvis kommando er pandanpc-mcp og hvis argumentliste er tom.

Den eksekverbare fil skal være på den PATH, som den grafiske applikation overtager. Hvis det virker i en terminal, men desktop-klienten rapporterer “kommandoen blev ikke fundet”, så brug den absolutte sti til den eksekverbare fil, som returneres af følgende kommando:

bash

command -v pandanpc-mcp

På Windows PowerShell skal du bruge:

powershell

Get-Command pandanpc-mcp

Log ind fra agenten

PandaNpc bruger en totrins-e-mailverifikationsproces. Bed agenten om at udføre disse handlinger i rækkefølge:

Kald note_login med din e-mailadresse. PandaNpc sender en verifikationskode.
Kald note_login igen med den samme e-mailadresse og koden.

Den lokale legitimationsoplysning cachelagres, så du bør ikke behøve at logge ind under hver session. Indsæt aldrig verifikationskoden i et offentligt udskrift eller en delt prompt.

Verificér MCP-forbindelsen

Kør en lille skrivebeskyttet test, før du tillader agenten at oprette eller redigere data:

Bed den om at kalde list_workspaces.
Bed den om at kalde list_notes for et arbejdsområde.
Bed den om at søge efter et uskyldigt søgeord med search_notes.

Et vellykket svar beviser, at MCP-klienten startede processen, autentificeringen blev fuldført, og at konto-API'en er tilgængelig. Til en skrivetest skal du oprette en engangsnote og derefter blødt slette den.

Den nøjagtige værktøjsliste, som din MCP-klient viser, er kilden til sandheden for den installerede version. Værktøjer er grupperet omkring disse arbejdsgange:

Arbejdsgang	Typiske værktøjer	Vigtig adfærd
Noter	`list_notes`, `create_note`, `read_note`, `update_note`, `search_notes`	`update_note` erstatter hele brødteksten; læs før redigering
Arbejdslogge	`save_done`	Gemmer fuldført arbejde i dagens projektmappe automatisk
Arbejdsområder	`list_workspaces`, `create_workspace`, `update_workspace`	En bundet projektsti gør det muligt for serveren at finde det korrekte arbejdsområde
Planlagt arbejde	`list_scheduled_bridges`, `create_scheduled_task`, `list_scheduled_task_runs`	En PandaPaw-maskine skal være online; cron-udtryk bruger seks felter
Udbydere og modeller	`list_providers`, `list_models`, opret/opdater/slet-værktøjer	List først, så du bruger aktuelle ID'er og gyldige modeltyper
Regler og færdigheder	`sync_rules`	Synkroniserer understøttede projektinstruktioner, mens uændrede filer springes over

For definitioner af udbyder- og modelfelter, se Brugerdefinerede AI-udbydere og API-nøgler. For konto- og faktureringsgrænser, se PandaNpc-konti, -planer og API-omkostninger.

Sikker driftspraksis

Start med liste-, læse- eller søgeværktøjer, før du opretter, opdaterer, sletter eller planlægger handlinger.
Læs en note, før du opdaterer den, fordi noteopdateringer erstatter hele Markdown-dokumentet i stedet for at anvende en patch.
Behandl planlagte prompter som kodeudførelsesanmodninger: bekræft målmaskinen, arbejdsmappen, tidszonen og seks-felts cron-udtrykket.
Hold udbyder-API-nøgler ude af prompter og noter. Indtast hemmeligheder kun gennem den tilsigtede udbyderkonfigurationsproces.
Gennemgå MCP-værktøjets godkendelseskort, før du tillader destruktive eller eksterne handlinger.
Brug save_done til arbejdslogge i stedet for manuelt at gætte det korrekte arbejdsområde og datomappe.

Fejlfinding

Klienten siger, at `pandanpc-mcp` ikke blev fundet

Åbn en ny terminal efter installationen, og tjek stien til den eksekverbare fil. Desktopapplikationer nedarver nogle gange en ældre PATH; konfigurér den absolutte sti, eller genstart applikationen. Hvis npm blev installeret gennem en versionsmanager, skal du sørge for, at MCP-klienten starter under den samme bruger og det samme miljø.

Serveren er registreret, men der vises ingen værktøjer

Genstart klienten, og inspicér derefter claude mcp get pandanpc eller codex mcp get pandanpc. Fjern og tilføj indgangen igen, hvis kommandoen er forkert. Kontrollér også, at du ikke har konfigureret den lokale stdio-proces som en HTTP-URL.

Værktøjer siger, at du ikke er autentificeret

Gentag de to note_login-kald. Brug den nyeste verifikationskode, tjek spam-mappen, og bekræft, at begge kald bruger den samme e-mailadresse.

Planlagte opgaver kan ikke finde en maskine

Kald list_scheduled_bridges først. Hvis den ikke returnerer nogen tilgængelig enhed, skal du verificere PandaPaw-status og enhedsforbindelse på målmaskinen. En maskine, der er slukket, sover, er logget ud eller er afbrudt, kan ikke starte en planlagt kørsel.

En noteopdatering fjernede eksisterende tekst

update_note accepterer den fulde erstatningsbrødtekst. Gendan noten fra dens historik eller papirkurv, hvor det er muligt, og læs derefter det aktuelle indhold, og indsend det kombinerede dokument.

Har du brug for kontospecifik hjælp? Kontakt support@pandanpc.com, og inkludér MCP-klientens navn, operativsystem, pakkeversion og den nøjagtige fejlmeddelelse uden hemmeligheder.