Configurați serverul MCP PandaNpc pentru Claude Code și Codex

Actualizat 2026-08-18

Serverul MCP PandaNpc conectează un agent de codare compatibil MCP la baza dvs. de cunoștințe PandaNote, jurnalele de lucru, sarcinile programate, configurația modelelor și Centrul de service pentru agenți. Este util atunci când un agent are nevoie de context durabil de proiect, în loc să pornească de la o conversație goală de fiecare dată.

Serverul rulează local prin transportul standard de intrare/ieșire MCP. Clientul dvs. MCP pornește procesul pandanpc-mcp atunci când se deschide o sesiune; nu trebuie să expuneți un port sau să rulați un server web separat.

Înainte de instalare

Aveți nevoie de:

Node.js și npm disponibile în același mediu în care rulează clientul MCP.
Un cont PandaNpc cu acces la adresa de e-mail utilizată pentru verificare.
Claude Code, OpenAI Codex, Cursor sau alt client care acceptă servere MCP stdio locale.

Dacă doriți ca agentul să programeze lucrări pe unul dintre computerele dvs., instalați și conectați mai întâi PandaPaw. Instrumentele pentru note și spații de lucru nu necesită un dispozitiv PandaPaw online.

Instalarea sau actualizarea serverului MCP

Instalați pachetul la nivel global pe macOS, Linux sau Windows:

bash

npm install -g @pandanpc/mcp-server

Confirmați că executabilul este vizibil pentru shell-ul dvs.:

bash

pandanpc-mcp --help

Rulați aceeași comandă npm de fiecare dată când doriți să actualizați. Reporniți clientul MCP după o actualizare, deoarece un client deja pornit păstrează versiunea procesului pe care a lansat-o inițial.

Consultați istoricul versiunilor serverului MCP atunci când un instrument sau comportamentul acestuia diferă de o captură de ecran sau un tutorial mai vechi.

Adăugarea PandaNpc la Claude Code

Cea mai fiabilă metodă este comanda de configurare proprie a lui Claude Code. Utilizați domeniul de utilizator (user scope) dacă doriți ca PandaNpc să fie disponibil în fiecare proiect:

bash

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

Utilizați --scope project atunci când configurația ar trebui partajată prin depozitul curent, sau --scope local când ar trebui să se aplice doar pentru dvs. în proiectul curent.

Verificați serverul înregistrat:

bash

claude mcp get pandanpc
claude mcp list

De asemenea, puteți configura manual serverul stdio în configurația MCP utilizată de instalarea dvs. Claude Code:

json

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

Adăugarea PandaNpc la OpenAI Codex

Codex poate înregistra același proces local din linia de comandă:

bash

codex mcp add pandanpc -- pandanpc-mcp

Verificați configurația salvată:

bash

codex mcp get pandanpc
codex mcp list

Intrarea echivalentă în ~/.codex/config.toml este:

toml

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

Reporniți Codex sau deschideți o nouă sesiune după adăugarea serverului. Dacă mențineți un fișier de configurare Codex personalizat, puneți tabelul MCP în acel fișier, nu îl duplicați în mai multe fișiere.

Configurarea Cursor și a altor clienți MCP

Pentru Cursor, adăugați un server local la ~/.cursor/mcp.json folosind aceeași structură JSON prezentată pentru Claude Code. Pentru Windsurf și alți clienți, creați un server MCP stdio a cărui comandă este pandanpc-mcp și a cărui listă de argumente este goală.

Executabilul trebuie să fie în PATH moștenit de aplicația grafică. Dacă funcționează într-un terminal, dar clientul desktop raportează „command not found”, utilizați calea absolută a executabilului returnată de următoarea comandă:

bash

command -v pandanpc-mcp

Pe Windows PowerShell, utilizați:

powershell

Get-Command pandanpc-mcp

Autentificarea din agent

PandaNpc utilizează un flux de verificare prin e-mail în doi pași. Cereți agentului să efectueze aceste acțiuni în ordine:

Apelați note_login cu adresa dvs. de e-mail. PandaNpc trimite un cod de verificare.
Apelați din nou note_login cu aceeași adresă de e-mail și codul.

Acreditarea locală este stocată în cache, deci nu ar trebui să vă autentificați în fiecare sesiune. Nu lipiți niciodată codul de verificare într-o transcriere publică sau într-un prompt partajat.

Verificarea conexiunii MCP

Rulați un mic test doar pentru citire înainte de a permite agentului să creeze sau să modifice date:

Cereți-i să apeleze list_workspaces.
Cereți-i să apeleze list_notes pentru un spațiu de lucru.
Cereți-i să caute un cuvânt cheie inofensiv cu search_notes.

Un răspuns de succes demonstrează că clientul MCP a pornit procesul, autentificarea s-a finalizat și API-ul contului este accesibil. Pentru un test de scriere, creați o notă de unică folosință și apoi ștergeți-o logic (soft-delete).

Lista exactă de instrumente afișată de clientul dvs. MCP este sursa de adevăr pentru versiunea instalată. Instrumentele sunt grupate în jurul acestor fluxuri de lucru:

Flux de lucru	Instrumente tipice	Comportament important
Note	`list_notes`, `create_note`, `read_note`, `update_note`, `search_notes`	`update_note` înlocuiește întregul corp; citiți înainte de editare
Jurnale de lucru	`save_done`	Stochează automat munca finalizată în folderul de proiect al zilei
Spații de lucru	`list_workspaces`, `create_workspace`, `update_workspace`	O cale de proiect asociată permite serverului să găsească spațiul de lucru corect
Muncă programată	`list_scheduled_bridges`, `create_scheduled_task`, `list_scheduled_task_runs`	O mașină PandaPaw trebuie să fie online; expresiile cron folosesc șase câmpuri
Furnizori și modele	`list_providers`, `list_models`, instrumente de creare/actualizare/ștergere	Listați mai întâi pentru a utiliza ID-uri curente și tipuri de modele valide
Reguli și abilități	`sync_rules`	Sincronizează instrucțiunile de proiect acceptate, omițând fișierele neschimbate

Pentru definițiile câmpurilor de furnizori și modele, consultați Furnizori AI personalizați și API keys. Pentru limitele contului și ale facturării, consultați Conturi PandaNpc, planuri și costuri API.

Practici de operare sigure

Începeți cu instrumente de listare, citire sau căutare înainte de acțiuni de creare, actualizare, ștergere sau programare.
Citiți o notă înainte de a o actualiza, deoarece actualizările de note înlocuiesc întregul document Markdown, în loc să aplice un patch.
Tratați prompturile programate ca cereri de execuție a codului: confirmați mașina țintă, directorul de lucru, fusul orar și expresia cron cu șase câmpuri.
Nu includeți API keys ale furnizorilor în prompturi și note. Introduceți secretele doar prin fluxul de configurare a furnizorului destinat.
Examinați cardul de aprobare a instrumentelor MCP înainte de a permite acțiuni distructive sau externe.
Utilizați save_done pentru jurnalele de lucru, în loc să ghiciți manual spațiul de lucru și folderul de dată corecte.

Depanare

Clientul spune că `pandanpc-mcp` nu a fost găsit

Deschideți un nou terminal după instalare și verificați calea executabilului. Aplicațiile desktop moștenesc uneori un PATH mai vechi; configurați calea absolută sau reporniți aplicația. Dacă npm a fost instalat printr-un manager de versiuni, asigurați-vă că clientul MCP pornește sub același utilizator și mediu.

Serverul este înregistrat, dar nu apar instrumente

Reporniți clientul, apoi inspectați claude mcp get pandanpc sau codex mcp get pandanpc. Eliminați și adăugați din nou intrarea dacă comanda este greșită. Verificați, de asemenea, că nu ați configurat procesul stdio local ca URL HTTP.

Instrumentele spun că nu sunteți autentificat

Repetați cele două apeluri note_login. Utilizați cel mai recent cod de verificare, verificați folderul de spam și confirmați că ambele apeluri folosesc aceeași adresă de e-mail.

Sarcinile programate nu pot găsi o mașină

Apelați mai întâi list_scheduled_bridges. Dacă nu returnează niciun dispozitiv disponibil, verificați starea PandaPaw și conectivitatea dispozitivului pe mașina țintă. O mașină care este oprită, în modul de repaus, deconectată de la cont sau deconectată de la rețea nu poate începe o rulare programată.

O actualizare de notă a eliminat text existent

update_note acceptă corpul complet de înlocuire. Restaurați nota din istoricul sau coșul de gunoi, unde este disponibil, apoi citiți conținutul curent și trimiteți documentul combinat.

Aveți nevoie de ajutor specific contului? Contactați support@pandanpc.com și includeți numele clientului MCP, sistemul de operare, versiunea pachetului și mesajul exact de eroare, fără secrete.