A PandaNpc MCP szerver konfigurálása a Claude Code és a Codex számára

Frissítve

A PandaNpc MCP szerver egy MCP-kompatibilis kódolási ügynököt köt össze a PandaNote tudásbázisoddal, munkanaplókkal, ütemezett feladatokkal, modellkonfigurációval és az Agent Service Centerrel. Akkor hasznos, ha egy ügynöknek tartós projektkontextusra van szüksége, ahelyett hogy minden alkalommal üres beszélgetéssel kezdene.

A szerver lokálisan fut az MCP szabványos bemeneti/kimeneti átvitelén keresztül. Az MCP-kliens elindítja a pandanpc-mcp folyamatot, amikor egy munkamenet megnyílik; nem kell portot megnyitnod vagy külön webkiszolgálót futtatnod.

A telepítés előtt

Szükséged lesz:

  • Node.js és npm, amely ugyanabban a környezetben érhető el, ahol az MCP-kliens fut.
  • Egy PandaNpc-fiók, amely hozzáfér a hitelesítéshez használt e-mail címhez.
  • Claude Code, OpenAI Codex, Cursor vagy egy másik kliens amely támogatja a helyi stdio MCP szervereket.

Ha azt szeretnéd, hogy az ügynök a saját számítógépeid egyikén ütemezzen munkát, először telepítsd és csatlakoztasd a PandaPaw-ot. A jegyzetek és munkaterület-eszközök nem igényelnek online PandaPaw-eszközt.

Az MCP szerver telepítése vagy frissítése

Telepítsd a csomagot globálisan macOS, Linux vagy Windows rendszeren:

bash
npm install -g @pandanpc/mcp-server

Erősítsd meg, hogy a végrehajtható fájl látható a shell számára:

bash
pandanpc-mcp --help

Futtasd ugyanazt az npm parancsot, amikor frissíteni szeretnél. Frissítés után indítsd újra az MCP-klienst, mert egy már futó kliens az általa eredetileg elindított folyamatverziót tartja meg.

Ellenőrizd az MCP szerver verziótörténetét, ha egy eszköz vagy annak viselkedése eltér egy régebbi képernyőképtől vagy oktatóanyagtól.

A PandaNpc hozzáadása a Claude Code-hoz

A legmegbízhatóbb módszer a Claude Code saját konfigurációs parancsa. Használj felhasználói hatókört, ha a PandaNpc-et minden projektben elérhetővé szeretnéd tenni:

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

Használd ehelyett a --scope project opciót, ha a konfigurációt a jelenlegi adattáron keresztül szeretnéd megosztani, vagy a --scope local opciót, ha az csak rád vonatkozzon az aktuális projektben.

Ellenőrizd a regisztrált szervert:

bash
claude mcp get pandanpc
claude mcp list

A stdio szervert manuálisan is konfigurálhatod a Claude Code telepítésed által használt MCP-konfigurációban:

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

A PandaNpc hozzáadása az OpenAI Codexhez

A Codex regisztrálhatja ugyanazt a helyi folyamatot a parancssorból:

bash
codex mcp add pandanpc -- pandanpc-mcp

Ellenőrizd a mentett konfigurációt:

bash
codex mcp get pandanpc
codex mcp list

A megfelelő bejegyzés a ~/.codex/config.toml fájlban a következő:

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

A szerver hozzáadása után indítsd újra a Codexet, vagy nyiss új munkamenetet. Ha egyéni Codex-konfigurációs fájlt használsz, az MCP-táblát abba a fájlba tedd, ne másold át több fájlba.

A Cursor és más MCP-kliensek konfigurálása

A Cursor esetében adj hozzá egy helyi szervert a ~/.cursor/mcp.json fájlhoz, ugyanazzal a JSON formával, mint amit a Claude Code-nál láttál. A Windsurf és más kliensek esetén hozz létre egy stdio MCP szervert, amelynek parancsa pandanpc-mcp, argumentumlistája pedig üres.

A végrehajtható fájlnak a grafikus alkalmazás által örökölt PATH változón kell lennie. Ha terminálban működik, de az asztali kliens azt jelzi, hogy „parancs nem található”, használd a következő parancs által visszaadott abszolút végrehajtható fájl útvonalát:

bash
command -v pandanpc-mcp

Windows PowerShell esetén használd:

powershell
Get-Command pandanpc-mcp

Bejelentkezés az ügynökből

A PandaNpc kétlépcsős e-mailes hitelesítési folyamatot használ. Kérd meg az ügynököt, hogy az alábbi műveleteket ebben a sorrendben hajtsa végre:

  1. Hívd meg a note_login eszközt az e-mail címeddel. A PandaNpc ellenőrző kódot küld.
  2. Hívd meg újra a note_login eszközt ugyanazzal az e-mail címmel és a kóddal.

A helyi hitelesítő adat gyorsítótárazva van, így nem kell minden munkamenetben bejelentkezned. Soha ne illeszd be az ellenőrző kódot nyilvános átiratba vagy megosztott promptba.

Az MCP-kapcsolat ellenőrzése

Futtass egy kisméretű, csak olvasási tesztet, mielőtt megengednéd az ügynöknek, hogy adatokat hozzon létre vagy szerkesszen:

  1. Kérd meg, hogy hívja meg a list_workspaces eszközt.
  2. Kérd meg, hogy hívja meg a list_notes eszközt egy munkaterületre.
  3. Kérd meg, hogy keressen egy ártalmatlan kulcsszót a search_notes eszközzel.

A sikeres válasz azt bizonyítja, hogy az MCP-kliens elindította a folyamatot, a hitelesítés befejeződött, és a fiók API-ja elérhető. Írási teszthez hozz létre egy eldobható jegyzetet, majd töröld soft-delete művelettel.

Az MCP-kliens által mutatott pontos eszközlista a telepített verzió elsődleges forrása. Az eszközök az alábbi munkafolyamatok köré csoportosulnak:

Munkafolyamat Jellemző eszközök Fontos viselkedés
Jegyzetek list_notes, create_note, read_note, update_note, search_notes Az update_note a teljes tartalmat lecseréli; szerkesztés előtt olvasd el
Munkanaplók save_done A befejezett munkát automatikusan a mai projektmappába menti
Munkaterületek list_workspaces, create_workspace, update_workspace A hozzárendelt projektútvonal lehetővé teszi a szerver számára a megfelelő munkaterület megtalálását
Ütemezett munka list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs Egy PandaPaw-gépnek online kell lennie; a cron kifejezések hat mezőt használnak
Szolgáltatók és modellek list_providers, list_models, létrehozó/frissítő/törlő eszközök Először listázz, hogy aktuális azonosítókat és érvényes modelltípusokat használj
Szabályok és készségek sync_rules Szinkronizálja a támogatott projektutasításokat, miközben kihagyja a módosulatlan fájlokat

A szolgáltatói és modellmező-definíciókért lásd: Egyéni AI-szolgáltatók és API-kulcsok. A fiók- és számlázási határokhoz lásd: PandaNpc-fiókok, csomagok és API-költségek.

Biztonságos működési gyakorlatok

  • Kezdd listázó, olvasó vagy kereső eszközökkel, mielőtt létrehozó, frissítő, törlő vagy ütemező műveleteket végeznél.
  • Egy jegyzet frissítése előtt olvasd el, mert a jegyzetfrissítés a teljes Markdown-dokumentumot lecseréli, nem pedig javítást alkalmaz.
  • Az ütemezett promptokat kódfuttatási kérelemként kezeld: erősítsd meg a célgépet, a munkakönyvtárat, az időzónát és a hatmezős cron kifejezést.
  • A szolgáltatói API-kulcsokat tartsd távol a promptoktól és a jegyzetektől. A titkokat csak a szolgáltatói konfiguráció célzott folyamatán keresztül add meg.
  • Tekintsd át az MCP-eszköz jóváhagyási kártyáját, mielőtt romboló vagy külső műveleteket engedélyeznél.
  • A munkanaplókhoz a save_done eszközt használd, ahelyett hogy kézzel találgatnád a megfelelő munkaterületet és dátum mappát.

Hibaelhárítás

A kliens azt írja, hogy a `pandanpc-mcp` nem található

A telepítés után nyiss egy új terminált, és ellenőrizd a végrehajtható fájl elérési útját. Az asztali alkalmazások néha egy régebbi PATH változót örökölnek; állítsd be az abszolút elérési utat, vagy indítsd újra az alkalmazást. Ha az npm-et verziókezelőn keresztül telepítetted, győződj meg arról, hogy az MCP-kliens ugyanazzal a felhasználóval és környezettel indul.

A szerver regisztrálva van, de nem jelennek meg eszközök

Indítsd újra a klienst, majd ellenőrizd a claude mcp get pandanpc vagy codex mcp get pandanpc parancsot. Ha a parancs hibás, távolítsd el és add hozzá újra a bejegyzést. Azt is ellenőrizd, hogy nem HTTP URL-ként konfiguráltad a helyi stdio folyamatot.

Az eszközök szerint nem vagy hitelesítve

Ismételd meg a két note_login hívást. Használd a legújabb ellenőrző kódot, ellenőrizd a spam mappát, és győződj meg arról, hogy mindkét hívás ugyanazt az e-mail címet használja.

Az ütemezett feladatok nem találnak gépet

Először hívd meg a list_scheduled_bridges eszközt. Ha nem ad vissza elérhető eszközt, ellenőrizd a PandaPaw állapotát és az eszközkapcsolatot a célgépen. Egy kikapcsolt, alvó, kijelentkezett vagy leválasztott gép nem tud ütemezett futtatást indítani.

Egy jegyzetfrissítés eltávolította a meglévő szöveget

Az update_note a teljes lecserélendő tartalmat fogadja el. Ha lehetséges, állítsd vissza a jegyzetet az előzményekből vagy a kukából, majd olvasd el az aktuális tartalmat, és küldd el az egyesített dokumentumot.

Fiókspecifikus segítségre van szükséged? Lépj kapcsolatba a support@pandanpc.com címmel, és add meg az MCP-kliens nevét, az operációs rendszert, a csomagverziót és a pontos hibaüzenetet titkok nélkül.