שרת ה-MCP של PandaNpc מחבר סוכן קידוד תואם MCP למאגר הידע של PandaNote, ליומני העבודה, למשימות המתוזמנות, לתצורת המודלים ולמרכז שירות הסוכנים. הוא שימושי כאשר סוכן זקוק להקשר פרויקט מתמשך במקום להתחיל משיחה ריקה בכל פעם.
השרת פועל מקומית על גבי תעבורת הקלט/פלט הסטנדרטית של MCP. לקוח ה-MCP שלך מריץ את תהליך pandanpc-mcp כאשר נפתחת סשן; אין צורך לחשוף פורט או להפעיל שרת אינטרנט נפרד.
לפני ההתקנה
תזדקק ל:
- Node.js ו-npm זמינים באותה סביבה שבה לקוח ה-MCP פועל.
- חשבון PandaNpc עם גישה לכתובת הדוא"ל המשמשת לאימות.
- Claude Code, OpenAI Codex, Cursor, או לקוח אחר התומך בשרתי MCP מקומיים מסוג stdio.
אם ברצונך שהסוכן יתזמן עבודה על אחד מהמחשבים שלך, התקן וחבר קודם את PandaPaw. כלי ההערות וכלי סביבת העבודה אינם דורשים מכשיר PandaPaw מקוון.
התקנה או עדכון של שרת ה-MCP
התקן את החבילה באופן גלובלי על macOS, Linux, או Windows:
npm install -g @pandanpc/mcp-serverודא שהקובץ ההרצה נראה ל-shell שלך:
pandanpc-mcp --helpהפעל את אותה פקודת npm כאשר ברצונך לעדכן. הפעל מחדש את לקוח ה-MCP לאחר עדכון, כיוון שלקוח שכבר רץ שומר על גרסת התהליך שהושק במקור.
בדוק את היסטוריית הגרסאות של שרת ה-MCP כאשר כלי או ההתנהגות שלו שונים מצילום מסך או מדריך ישנים יותר.
הוספת PandaNpc ל-Claude Code
השיטה האמינה ביותר היא פקודת התצורה של Claude Code עצמו. השתמש בהיקף משתמש אם ברצונך ש-PandaNpc יהיה זמין בכל פרויקט:
claude mcp add --scope user pandanpc -- pandanpc-mcpהשתמש ב---scope project במקום זאת כאשר התצורה צריכה להיות משותפת דרך המאגר הנוכחי, או ב---scope local כאשר היא צריכה לחול רק עליך בפרויקט הנוכחי.
בדוק את השרת הרשום:
claude mcp get pandanpc
claude mcp listניתן גם להגדיר את שרת ה-stdio ידנית בתצורת ה-MCP שבה משתמשת התקנת Claude Code שלך:
{
"mcpServers": {
"pandanpc": {
"command": "pandanpc-mcp"
}
}
}הוספת PandaNpc ל-OpenAI Codex
Codex יכול לרשום את אותו תהליך מקומי משורת הפקודה:
codex mcp add pandanpc -- pandanpc-mcpאמת את התצורה השמורה:
codex mcp get pandanpc
codex mcp listהערך המקביל ב-~/.codex/config.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 שעובר בירושה ליישום הגרפי. אם הוא עובד בטרמינל אבל לקוח שולחן העבודה מדווח "הפקודה לא נמצאה", השתמש בנתיב המוחלט של הקובץ ההרצה המוחזר על ידי הפקודה הבאה:
command -v pandanpc-mcpב-Windows PowerShell, השתמש:
Get-Command pandanpc-mcpהתחברות מהסוכן
PandaNpc משתמש בתהליך אימות דוא"ל דו-שלבי. בקש מהסוכן לבצע את הפעולות הבאות לפי הסדר:
- קרא ל-
note_loginעם כתובת הדוא"ל שלך. PandaNpc שולח קוד אימות. - קרא ל-
note_loginשוב עם אותה כתובת דוא"ל ועם הקוד.
פרטי הכניסה המקומיים נשמרים במטמון, כך שלא תצטרך להתחבר בכל סשן. לעולם אל תדביק את קוד האימות בתמליל ציבורי או בהנחיה משותפת.
אימות חיבור ה-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 חייבת להיות מקוונת; ביטויי cron משתמשים בשישה שדות |
| ספקים ומודלים | list_providers, list_models, כלי יצירה/עדכון/מחיקה |
עשה רשימה תחילה כדי להשתמש ב-ID עדכניים ובסוגי מודלים תקינים |
| חוקים ומיומנויות | sync_rules |
מסנכרן הוראות פרויקט נתמכות תוך דילוג על קבצים שלא השתנו |
עבור הגדרות שדות של ספקים ומודלים, ראה ספקי AI מותאמים אישית ו-API keys. עבור גבולות חשבון וחיוב, ראה חשבונות, תוכניות ועלויות API של PandaNpc.
נהלי עבודה בטוחים
- התחל עם כלי רשימה, קריאה או חיפוש לפני פעולות יצירה, עדכון, מחיקה או תזמון.
- קרא הערה לפני עדכונה, משום שעדכוני הערות מחליפים את כל מסמך ה-Markdown במקום להחיל תיקון.
- התייחס להנחיות מתוזמנות כאל בקשות להרצת קוד: אשר את המכונה היעד, תיקיית העבודה, אזור הזמן וביטוי ה-cron בעל ששת השדות.
- שמור על מפתחות API של ספקים מחוץ להנחיות ולהערות. הזן סודות רק דרך זרימת התצורה הייעודית של הספק.
- סקור את כרטיס אישור הכלים של MCP לפני מתן אישור לפעולות הרסניות או חיצוניות.
- השתמש ב-
save_doneעבור יומני עבודה במקום לנחש ידנית את סביבת העבודה ותיקיית התאריך הנכונות.
פתרון בעיות
הלקוח מדווח ש-`pandanpc-mcp` לא נמצא
פתח טרמינל חדש לאחר ההתקנה ובדוק את נתיב הקובץ ההרצה. יישומי שולחן עבודה לעיתים יורשים PATH ישן יותר; הגדר את הנתיב המוחלט או הפעל מחדש את היישום. אם npm הותקן דרך מנהל גרסאות, ודא שלקוח ה-MCP מופעל תחת אותו משתמש ואותה סביבה.
השרת רשום אך לא מופיעים כלים
הפעל מחדש את הלקוח, ולאחר מכן בדוק את claude mcp get pandanpc או codex mcp get pandanpc. הסר והוסף את הערך שוב אם הפקודה שגויה. כמו כן, בדוק שלא הגדרת את תהליך ה-stdio המקומי ככתובת HTTP.
הכלים אומרים שאינך מאומתח
חזור על שתי קריאות ה-note_login. השתמש בקוד האימות העדכני ביותר, בדוק את תיקיית הספאם, וודא ששתי הקריאות משתמשות באותה כתובת דוא"ל.
משימות מתוזמנות לא מוצאות מכונה
קרא קודם ל-list_scheduled_bridges. אם הוא לא מחזיר מכשיר זמין, ודא את סטטוס PandaPaw וקישוריות המכשיר במכונה היעד. מכונה שכבויה, ישנה, מנותקת או מנותקת חשבון לא יכולה להתחיל הרצה מתוזמנת.
עדכון הערה הסיר טקסט קיים
update_note מקבל את כל גוף ההחלפה. שחזר את ההערה מההיסטוריה או מהפח אם קיים, ולאחר מכן קרא את התוכן הנוכחי ושלח את המסמך המשולב.
זקוק לעזרה ספציפית לחשבון? צור קשר עם support@pandanpc.com וצרף את שם לקוח ה-MCP, מערכת ההפעלה, גרסת החבילה ואת הודעת השגיאה המדויקת ללא סודות.