Διαμόρφωση του διακομιστή MCP PandaNpc για το Claude Code και το Codex

Ενημερώθηκε 2026-08-18

Ο διακομιστής PandaNpc MCP συνδέει έναν συμβατό με MCP πράκτορα κωδικοποίησης με τη βάση γνώσεων PandaNote, τα αρχεία καταγραφής εργασίας, τις προγραμματισμένες εργασίες, τη διαμόρφωση μοντέλων και το Κέντρο Υπηρεσιών Πρακτόρων. Είναι χρήσιμος όταν ένας πράκτορας χρειάζεται διαρκή συμφραζόμενα έργου αντί να ξεκινά από έναν κενό διάλογο κάθε φορά.

Ο διακομιστής εκτελείται τοπικά μέσω της τυπικής μεταφοράς εισόδου/εξόδου του MCP. Ο πελάτης MCP εκκινεί τη διαδικασία pandanpc-mcp όταν ανοίγει μια συνεδρία· δεν χρειάζεται να εκθέσετε μια θύρα ή να εκτελέσετε έναν ξεχωριστό διακομιστή ιστού.

Πριν την εγκατάσταση

Χρειάζεστε:

Node.js και npm διαθέσιμα στο ίδιο περιβάλλον όπου εκτελείται ο πελάτης MCP.
Έναν λογαριασμό PandaNpc με πρόσβαση στη διεύθυνση email που χρησιμοποιείται για επαλήθευση.
Claude Code, OpenAI Codex, Cursor ή άλλον πελάτη που υποστηρίζει τοπικούς διακομιστές MCP μέσω stdio.

Αν θέλετε ο πράκτορας να προγραμματίζει εργασίες σε έναν από τους δικούς σας υπολογιστές, εγκαταστήστε και συνδέστε πρώτα το PandaPaw. Τα εργαλεία σημειώσεων και χώρων εργασίας δεν απαιτούν μια online συσκευή PandaPaw.

Εγκατάσταση ή ενημέρωση του διακομιστή MCP

Εγκαταστήστε το πακέτο καθολικά σε macOS, Linux ή Windows:

bash

npm install -g @pandanpc/mcp-server

Επιβεβαιώστε ότι το εκτελέσιμο είναι ορατό στο κέλυφός σας:

bash

pandanpc-mcp --help

Εκτελέστε την ίδια εντολή npm όποτε θέλετε να ενημερώσετε. Επανεκκινήστε τον πελάτη MCP μετά από μια ενημέρωση, επειδή ένας ήδη εκτελούμενος πελάτης διατηρεί την έκδοση της διαδικασίας που εκκίνησε αρχικά.

Ελέγξτε το ιστορικό εκδόσεων του διακομιστή MCP όταν ένα εργαλείο ή η συμπεριφορά του διαφέρει από ένα παλαιότερο στιγμιότυπο οθόνης ή εκμάθηση.

Προσθήκη του PandaNpc στο Claude Code

Η πιο αξιόπιστη μέθοδος είναι η εντολή διαμόρφωσης του ίδιου του Claude Code. Χρησιμοποιήστε εμβέλεια χρήστη αν θέλετε το PandaNpc να είναι διαθέσιμο σε κάθε έργο:

bash

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

Χρησιμοποιήστε --scope project αντί αυτού όταν η διαμόρφωση πρέπει να κοινοποιείται μέσω του τρέχοντος αποθετηρίου, ή --scope local όταν πρέπει να ισχύει μόνο για εσάς στο τρέχον έργο.

Ελέγξτε τον καταχωρημένο διακομιστή:

bash

claude mcp get pandanpc
claude mcp list

Μπορείτε επίσης να διαμορφώσετε χειροκίνητα τον διακομιστή stdio στη διαμόρφωση MCP που χρησιμοποιείται από την εγκατάσταση του Claude Code:

json

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

Προσθήκη του PandaNpc στο OpenAI Codex

Το Codex μπορεί να καταχωρίσει την ίδια τοπική διαδικασία από τη γραμμή εντολών:

bash

codex mcp add pandanpc -- pandanpc-mcp

Επαληθεύστε την αποθηκευμένη διαμόρφωση:

bash

codex mcp get pandanpc
codex mcp list

Η αντίστοιχη εγγραφή στο ~/.codex/config.toml είναι:

toml

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

Επανεκκινήστε το Codex ή ανοίξτε μια νέα συνεδρία μετά την προσθήκη του διακομιστή. Αν διατηρείτε ένα προσαρμοσμένο αρχείο διαμόρφωσης Codex, τοποθετήστε τον πίνακα MCP σε αυτό το αρχείο αντί να τον αντιγράφετε σε πολλά αρχεία.

Διαμόρφωση του Cursor και άλλων πελατών MCP

Για το Cursor, προσθέστε έναν τοπικό διακομιστή στο ~/.cursor/mcp.json χρησιμοποιώντας την ίδια μορφή JSON που εμφανίζεται για το Claude Code. Για το Windsurf και άλλους πελάτες, δημιουργήστε έναν διακομιστή MCP stdio του οποίου η εντολή είναι pandanpc-mcp και η λίστα ορισμάτων είναι κενή.

Το εκτελέσιμο πρέπει να βρίσκεται στο PATH που κληρονομεί η γραφική εφαρμογή. Αν λειτουργεί σε ένα τερματικό αλλά ο πελάτης επιφάνειας εργασίας αναφέρει «εντολή δεν βρέθηκε», χρησιμοποιήστε την απόλυτη διαδρομή εκτελέσιμου που επιστρέφεται από την ακόλουθη εντολή:

bash

command -v pandanpc-mcp

Στα Windows PowerShell, χρησιμοποιήστε:

powershell

Get-Command pandanpc-mcp

Σύνδεση από τον πράκτορα

Το PandaNpc χρησιμοποιεί μια διαδικασία επαλήθευσης email δύο βημάτων. Ζητήστε από τον πράκτορα να εκτελέσει αυτές τις ενέργειες με τη σειρά:

Καλέστε το note_login με τη διεύθυνση email σας. Το PandaNpc στέλνει έναν κωδικό επαλήθευσης.
Καλέστε ξανά το note_login με την ίδια διεύθυνση email και τον κωδικό.

Το τοπικό διαπιστευτήριο αποθηκεύεται στην κρυφή μνήμη, οπότε δεν θα χρειαστεί να συνδεθείτε σε κάθε συνεδρία. Ποτέ μην επικολλήσετε τον κωδικό επαλήθευσης σε δημόσια μεταγραφή ή σε κοινόχρηστη προτροπή.

Επαλήθευση της σύνδεσης MCP

Εκτελέστε ένα μικρό δοκιμαστικό μόνο για ανάγνωση πριν επιτρέψετε στον πράκτορα να δημιουργήσει ή να επεξεργαστεί δεδομένα:

Ζητήστε του να καλέσει το list_workspaces.
Ζητήστε του να καλέσει το list_notes για έναν χώρο εργασίας.
Ζητήστε του να αναζητήσει μια ακίνδυνη λέξη-κλειδί με το search_notes.

Μια επιτυχημένη απόκριση αποδεικνύει ότι ο πελάτης MCP εκκίνησε τη διαδικασία, η πιστοποίηση ολοκληρώθηκε και το API λογαριασμού είναι προσβάσιμο. Για μια δοκιμή εγγραφής, δημιουργήστε μια προσωρινή σημείωση και στη συνέχεια διαγράψτε την με μαλακή διαγραφή.

Η ακριβής λίστα εργαλείων που εμφανίζει ο πελάτης MCP σας είναι η πηγή αλήθειας για την εγκατεστημένη έκδοση. Τα εργαλεία ομαδοποιούνται γύρω από αυτές τις ροές εργασίας:

Ροή εργασίας	Τυπικά εργαλεία	Σημαντική συμπεριφορά
Σημειώσεις	`list_notes`, `create_note`, `read_note`, `update_note`, `search_notes`	Το `update_note` αντικαθιστά ολόκληρο το σώμα· διαβάστε πριν επεξεργαστείτε
Αρχεία καταγραφής εργασίας	`save_done`	Αποθηκεύει αυτόματα την ολοκληρωμένη εργασία στον φάκελο του σημερινού έργου
Χώροι εργασίας	`list_workspaces`, `create_workspace`, `update_workspace`	Μια δεσμευμένη διαδρομή έργου επιτρέπει στον διακομιστή να βρει τον σωστό χώρο εργασίας
Προγραμματισμένη εργασία	`list_scheduled_bridges`, `create_scheduled_task`, `list_scheduled_task_runs`	Μια μηχανή PandaPaw πρέπει να είναι online· οι εκφράσεις cron χρησιμοποιούν έξι πεδία
Πάροχοι και μοντέλα	`list_providers`, `list_models`, εργαλεία δημιουργίας/ενημέρωσης/διαγραφής	Καταχωρίστε πρώτα τη λίστα, ώστε να χρησιμοποιείτε τρέχοντα αναγνωριστικά και έγκυρους τύπους μοντέλων
Κανόνες και δεξιότητες	`sync_rules`	Συγχρονίζει τις υποστηριζόμενες οδηγίες έργου παρακάμπτοντας τα αρχεία που δεν έχουν αλλάξει

Για ορισμούς πεδίων παρόχων και μοντέλων, δείτε Προσαρμοσμένοι πάροχοι AI και API keys. Για όρια λογαριασμού και χρέωσης, δείτε Λογαριασμοί PandaNpc, προγράμματα και κόστη API.

Ασφαλείς πρακτικές λειτουργίας

Ξεκινήστε με εργαλεία λίστας, ανάγνωσης ή αναζήτησης πριν από ενέργειες δημιουργίας, ενημέρωσης, διαγραφής ή προγραμματισμού.
Διαβάστε μια σημείωση πριν την ενημερώσετε, επειδή οι ενημερώσεις σημειώσεων αντικαθιστούν ολόκληρο το έγγραφο Markdown αντί να εφαρμόζουν ένα patch.
Αντιμετωπίστε τα προγραμματισμένα prompts ως αιτήματα εκτέλεσης κώδικα: επιβεβαιώστε τη μηχανή-στόχο, τον κατάλογο εργασίας, τη ζώνη ώρας και την έκφραση cron έξι πεδίων.
Κρατήστε τα API keys παρόχων εκτός prompts και σημειώσεων. Εισάγετε τα μυστικά μόνο μέσω της προβλεπόμενης ροής διαμόρφωσης παρόχου.
Εξετάστε την κάρτα έγκρισης εργαλείων MCP πριν επιτρέψετε καταστροφικές ή εξωτερικές ενέργειες.
Χρησιμοποιήστε το save_done για αρχεία καταγραφής εργασίας αντί να μαντεύετε χειροκίνητα τον σωστό χώρο εργασίας και τον φάκελο ημερομηνίας.

Αντιμετώπιση προβλημάτων

Ο πελάτης αναφέρει ότι το `pandanpc-mcp` δεν βρέθηκε

Ανοίξτε ένα νέο τερματικό μετά την εγκατάσταση και ελέγξτε τη διαδρομή του εκτελέσιμου. Οι εφαρμογές επιφάνειας εργασίας μερικές φορές κληρονομούν ένα παλαιότερο PATH· διαμορφώστε την απόλυτη διαδρομή ή επανεκκινήστε την εφαρμογή. Αν το npm εγκαταστάθηκε μέσω ενός διαχειριστή εκδόσεων, βεβαιωθείτε ότι ο πελάτης MCP ξεκινά με τον ίδιο χρήστη και περιβάλλον.

Ο διακομιστής είναι καταχωρημένος αλλά δεν εμφανίζονται εργαλεία

Επανεκκινήστε τον πελάτη και στη συνέχεια επιθεωρήστε το claude mcp get pandanpc ή το codex mcp get pandanpc. Αφαιρέστε και προσθέστε ξανά την εγγραφή αν η εντολή είναι λανθασμένη. Ελέγξτε επίσης ότι δεν διαμορφώσατε την τοπική διαδικασία stdio ως διεύθυνση URL HTTP.

Τα εργαλεία λένε ότι δεν έχετε πιστοποιηθεί

Επαναλάβετε τις δύο κλήσεις note_login. Χρησιμοποιήστε τον νεότερο κωδικό επαλήθευσης, ελέγξτε τον φάκελο ανεπιθύμητης αλληλογραφίας και επιβεβαιώστε ότι και οι δύο κλήσεις χρησιμοποιούν την ίδια διεύθυνση email.

Οι προγραμματισμένες εργασίες δεν μπορούν να βρουν μια μηχανή

Καλέστε πρώτα το list_scheduled_bridges. Αν δεν επιστρέφει διαθέσιμη συσκευή, επαληθεύστε την κατάσταση PandaPaw και τη συνδεσιμότητα συσκευής στη μηχανή-στόχο. Μια μηχανή που είναι απενεργοποιημένη, σε αναστολή, χωρίς ενεργή σύνδεση ή αποσυνδεδεμένη δεν μπορεί να ξεκινήσει μια προγραμματισμένη εκτέλεση.

Μια ενημέρωση σημείωσης αφαίρεσε υπάρχον κείμενο

Το update_note δέχεται ολόκληρο το σώμα αντικατάστασης. Επαναφέρετε τη σημείωση από το ιστορικό της ή τον κάδο όπου είναι διαθέσιμα, στη συνέχεια διαβάστε το τρέχον περιεχόμενο και υποβάλετε το συνδυασμένο έγγραφο.

Χρειάζεστε βοήθεια ειδική για τον λογαριασμό σας; Επικοινωνήστε με το support@pandanpc.com και συμπεριλάβετε το όνομα του πελάτη MCP, το λειτουργικό σύστημα, την έκδοση του πακέτου και το ακριβές μήνυμα σφάλματος χωρίς μυστικά.