חיבור סוכן AI לפקק (MCP)

השקה מוקדמת (Preview). שרת ה-MCP קיים ופעיל כשמשתנה הסביבה MCP_ENABLED מוגדר. עד אז, קליינטים יכולים להתחבר (initialize) אבל tools/list ו-tools/call מחזירים MCP is not enabled for this account. במהלך ההשקה המוקדמת, ה-tokens מונפקים על ידי צוות פקק (ראו "כתובת" למטה) ולא דרך הגדרות החשבון.

Model Context Protocol (MCP) מאפשר לקליינט AI לקרוא לכלים חיצוניים דרך ממשק סטנדרטי. שרת ה-MCP של פקק חושף את מנוע הביקורת כאוסף כלי MCP, כך שסוכן יכול להריץ ביקורת, לקרוא את הממצאים, ולפעול לפיהם בלי שאדם יעביר נתונים בין חלונות.

מה השרת חושף

• audit_money_page — הרצת סולם האבחון המלא מול כתובת אחת ומילת מפתח יעד. מחזיר את השכבה הנמוכה ביותר שנשברה, את חבילת הראיות, וממצא בשפה פשוטה.
• get_report — שליפת התוצאה המלאה של ביקורת קודמת לפי מזהה.
• compare_competitors — גריפת המתחרים העסקיים האמיתיים המובילים למילת מפתח, והחזרת פערי schema / Core Web Vitals / קישורים פנימיים.
• check_serp_intent — סיווג סוג התוצאה הדומיננטי למילת מפתח, והאם דף שירות יכול באמת לנצח אותה.
• validate_project_config — בדיקת קובץ pkak.json של המאגר: מחזיר את ברירות המחדל ואת דפי הכסף ככתובות מלאות, או את כל הבעיות שנמצאו. לא מריץ ביקורת ולא נספר במכסת הביקורות היומית (ראו הגדרה ברמת הפרויקט).
• list_skills — החזרת ה-Agent Skills הזמינים (ראו Agent Skills).

כל כלי הוא לקריאה בלבד מול העולם החיצון ומוגבל בקצב לכל חשבון. אף אחד מהם לא מפרסם דבר ולא מוציא כסף בלי תקרת הוצאה.

כתובת

https://shakuf.ltd/api/mcp

התעבורה היא JSON-RPC 2.0 מעל HTTP (בקשת POST אחת, תשובת JSON אחת — בלי session). האימות הוא token של bearer בפורמט sk_pkak_ ואחריו 48 תווים הקסדצימליים. במהלך ההשקה המוקדמת צוות פקק מנפיק אותו לכם; הוא מוצג פעם אחת בלבד ולא ניתן לשחזור (רק ה-hash שלו נשמר). token שהונפק לפני המעבר לשם פקק, בפורמט sk_shakuf_, ממשיך לעבוד.

Authorization: Bearer sk_pkak_...

ל-list_skills נדרש שה-token יכלול את ה-scope של skills; לשאר הכלים מספיק audit (ברירת המחדל).

חיבור כל קליינט

Claude (Claude Code / Claude Desktop)

הוסיפו את השרת לתצורת ה-MCP:

{
  "mcpServers": {
    "pkak": {
      "type": "http",
      "url": "https://shakuf.ltd/api/mcp",
      "headers": { "Authorization": "Bearer sk_pkak_YOUR_TOKEN" }
    }
  }
}

ב-Claude Code הקובץ הוא ~/.claude/mcp.json (או .mcp.json בפרויקט); ב-Claude Desktop זה החלונית Developer → Edit Config. הפעילו מחדש את הקליינט והכלים של pkak יופיעו.

Cursor

פתחו Settings → MCP → Add new server, בחרו HTTP, והדביקו את הכתובת ואת כותרת ה-Authorization. Cursor מציג את הכלים של פקק תחת שם השרת ברגע שהוא מתחבר.

Codex

הוסיפו ל-~/.codex/config.toml:

[mcp_servers.pkak]
url = "https://shakuf.ltd/api/mcp"
http_headers = { Authorization = "Bearer sk_pkak_YOUR_TOKEN" }

כל קליינט MCP אחר

כוונו אותו לכתובת שלמעלה עם כותרת ה-bearer. השרת מפרסם את סכמות הכלים שלו דרך הקריאה הסטנדרטית tools/list — אין הגדרה ספציפית לקליינט מעבר לחיבור.

בקשה ראשונה

אחרי החיבור, בקשו מהסוכן:

בצע ביקורת ל-https://example.com/service עבור מילת המפתח "example service tel aviv" ותגיד לי מה השכבה הנמוכה ביותר שנשברה.

הסוכן קורא ל-audit_money_page. ריצה נקייה מסתיימת תוך שניות והכלי מחזיר מיד את השכבה, הסיבה והראיות. אם הריצה נמשכת מעבר לחלון (~55 שניות), הכלי מחזיר status: "running" ו-run_id — הסוכן קורא ל-get_report עם ה-id הזה כדי לקבל את התוצאה כשהיא מוכנה. משם הוא יכול ליישם תיקונים ולקרוא שוב כדי לאשר.

פתרון תקלות

• 401 unauthorized — ה-token של ה-bearer חסר, שגוי, או בוטל. ייצרו אותו מחדש בהגדרות החשבון.
• not enabled for this account — גישת MCP עדיין לא הופעלה עבורכם (ראו את הערת ההשקה המוקדמת למעלה).
• הכלים לא מופיעים — הקליינט לא התחבר מחדש; הפעילו אותו מחדש לגמרי אחרי עריכת התצורה.
• 429 rate limited — הגעתם לתקרת הביקורות היומית לחשבון; היא מתאפסת ב-00:00 UTC.