שרת PTC MCP: חברו את סוכן הקידוד שלכם ל־PTC

שרת PTC MCP מחבר את Claude Code, Codex, Cursor וסוכני קידוד אחרים ל־PTC (Private Translation Cloud), שירות הלוקליזציה מבוסס בינה מלאכותית לתוכנה.

בעמוד זה

מה השרת מציע
מודל סשן
מה נאמר לסוכן
אימות
מגבלות
חיבור

עמוד זה כולל את נקודת הקצה, הטוקן, מה שהשרת מציע והמגבלות שלו. כדי להבין מה PTC עושה לאחר שהסוכן שלכם מחובר, קראו כיצד עובד מדריך הסוכן של PTC. לפקודות ההגדרה, ראו תחילת העבודה.

פריט	ערך
נקודת קצה	`https://app.ptc.wpml.org/mcp`
תעבורה	HTTP בסטרימינג: POST בלבד, תשובות JSON רגילות, ללא שמירת מצב (stateless)
אימות	`Authorization: Bearer <agent token>`
טוקן סוכן	אחד לכל אדם. PTC יוצרת אותו בפעם הראשונה שאתם פותחים את העמוד 'חיבור הסוכן שלכם ל־PTC', או כאשר אתם מאשרים את ההתחברות של כלי שורת הפקודה. העמוד מציג אותו כשהוא כבר מוזן בתוך קטע הקוד להגדרה עבור הלקוח שלכם
כלי נלווה	כלי שורת הפקודה של PTC, המותקן על ידי הסוכן בתוך המאגר בכתובת `.ptc/bin/ptc-cli.sh`; חובה
התחברות	אתם מריצים `ptc auth login` פעם אחת במסוף שלכם ומאשרים זאת בדפדפן. הסוכן לעולם אינו מטפל בטוקן
הגדרה מוכנה מראש עבור	Claude Code, Codex, Cursor, VS Code. כל לקוח MCP אחר שמסוגל להריץ פקודות מעטפת (shell) מתחבר עם נקודת הקצה והכותרת (header)
נבדק עם	Claude Code, Codex
שם השרת	`ptc-guide`; הגרסה שלו היא גרסת ה־CLI ש־PTC ממליצה עליה כרגע

מה השרת מציע

השרת הוא מדריך, לא API תרגום. הוא מוסר לסוכן שלכם משימה אחת בכל פעם ובודק כל תוצאה לפני שהוא מחלק את המשימה הבאה. הוא מציע חמש פעולות:

פעולה	מה היא עושה
משימה הבאה	מחזירה את המשימה הבאה עבור המאגר הזה יחד עם ההוראות והמטען (payload) שלה, או מודיעה לסוכן ש־PTC עדיין עובדת ולמה עליו להמתין. הקריאה הראשונה מציינת את שם המאגר (ה־remote שלו ב־Git, או "local" עם שם פרויקט) ומצטרפת מחדש לסשן הקיים של המאגר אם יש כזה. היא יכולה גם לציין שם פרויקט שהתחלתם באשף ההגדרה של PTC, וממשיכה אותו. כאשר פרויקט PTC כבר משתמש במאגר אך אף סשן סוכן לא משרת אותו, PTC אינה יוצרת דבר ושואלת את האדם: האם להמשיך את הפרויקט הזה, או להגדיר אחד חדש. כאשר הטוקן פועל במספר ארגונים, הקריאה הראשונה מחזירה את הרשימה שלהם והסוכן שואל את האדם באיזה מהם לבחור.
שליחה	שולחת תוצאה של משימה. PTC עונה עם פסק דין: התקבל (accepted), נדחה (rejected), נדרש עוד (needs more) או נדלג (skipped), כל אחד עם סיבות. כל תשובה מציינת מה מגיע בהמשך.
סטטוס	היכן הסשן עומד: השלב, התקדמות ההגדרה, המצב של כל משימה והשאלות שממתינות לאדם. כאשר נשאלת על משימה אחת, היא מחזירה את פסק הדין והסיבות של אותה משימה.
דילוג	מדלגת על משימה לפי הוראת האדם, יחד עם הסיבה שלו. לא ניתן לדלג על משימה שמכילה החלטה שרק האדם מקבל: המפקד (census), המוסכמות (conventions), ניקוי ההיקף (scope cleanup), ערוץ המסירה, הסנכרון הראשון, ההערכה בפרויקט בתשלום, ביקורת המוכנות כל עוד השער שלה פתוח, וכתיבת התצורה כאשר במאגר יש תרגומים קיימים לייבוא. העזרים של PTC עצמה יכולים לדלג.
המתנה	ממתינה בזמן ש־PTC מסיימת משהו בצד שלה (תרגום, בדיקה) ומחזירה את פסק הדין ואת המשימה הבאה כשהם מוכנים, או מבקשת שיקראו לה שוב.

רוב המשימות מבקשות מהסוכן להריץ פקודה של כלי שורת הפקודה של PTC ולשלוח את הפלט שלה: סריקת המאגר, ביקורת מחרוזות, אימות מילון מונחים, כתיבת הערות למתרגמים, דיווח על הרצה, סנכרון תרגומים. הכלי מדפיס מה לעשות בהמשך בכל יציאה. כאשר PTC דורשת גרסה חדשה יותר, היא מדפיסה את פקודת השדרוג והמדריך מורה לסוכן להתקין אותה.

מודל סשן

למאגר אחד יש סשן אחד. הוא מזוהה על ידי כתובת ה־URL של ה־remote של המאגר (בכל איות שהוא) או, במקרה של checkout ללא remote, על ידי טביעת אצבע של עץ העבודה ושם פרויקט. סוכן שני, מחשב אחר או יום מאוחר יותר מצטרפים מחדש לאותו סשן, ו־PTC אינה יוצרת עבורו פרויקט שני. החריג היחיד: כאשר רק פרויקט מאשף ההגדרה משתמש במאגר, האדם יכול לבחור להגדיר אחד חדש.
מאגר עם מספר מוצרים הוא חבילה (suite) אחת: פרויקט PTC, עם סשן משלו, לכל מוצר; חיבור MCP אחד וסוד CI אחד עבור כולם.
החלטות מתועדות פעם אחת ולעולם לא נשאלות שוב: שפות, מוסכמות, התשובה לגבי מילון המונחים, ההערכה, ערוץ המסירה.
לאחר ההגדרה, הסשן נשאר פתוח לעבודה רציפה: כל הרצת CI מאומתת פותחת מחדש רק את המחרוזות החדשות או אלו שהשתנו, והרצה ללא שום דבר חדש אינה פותחת דבר. בתקופת ניסיון, זה נפסק כאשר נעשה שימוש בשתי המסירות האוטומטיות החינמיות שלה.
הסשן, הפרויקט והטוקן נשמרים על ידי כלי שורת הפקודה בתצורת ה־PTC של המאגר ובקובץ אישורים (credentials) בספריית הבית של המשתמש; הסוכן לעולם אינו מטפל בטוקן.

מה נאמר לסוכן

כל משימה נושאת הוראות שנכתבו עבור הסוכן. שלושה כללים חלים על כולן:

העברת השאלות של PTC לאדם במילים של PTC, והחזרת המילים של האדם עצמו. PTC קוראת את התשובה בעצמה ולעולם אינה מסתמכת באופן עיוור על הקריאה של הסוכן.
לעולם אין לענות במקום האדם. שפות, מוסכמות, כסף, מונחים ומסירה נמצאים באחריות האדם. מה שהאדם כבר ציין בפרומפט, כגון שפות היעד, נחשב כתשובה שלו ולא נשאל שוב.
יש להמתין ל־PTC במקום לנסות שוב. שליחה שנדחתה חוזרת עם סיבות; הסוכן מתקן ושולח מחדש.

אימות

PTC מקבלת תוצאה רק כאשר היא יכולה לבדוק אותה: סריקה חייבת להגיע מהכלי של PTC עצמה; שורת קוד מצוטטת חייבת להיות קיימת בקבצים ש־PTC מחזיקה עבור אותה הרצה; תצורה חייבת לחזור בייט אחר בייט; עריכת מקור נחשבת כאשר העותק של PTC לאותו קובץ מציג אותה; הרצת CI מוכחת על ידי טוקן הזהות של פלטפורמת ה־CI עצמה (GitHub Actions, GitLab CI או Bitbucket Pipelines), והרצה בלעדיו מתועדת כלא מאומתת. ראו מדוע מודל LLM לבדו אינו מספיק.

מגבלות

הסוכן חייב להריץ פקודות מעטפת (shell). אין נתיב מבוסס MCP בלבד.
בקשות ההרשאה (prompts) של הסוכן עצמו, כגון אישור סקריפט שהורד או כלי MCP חדש, שייכות לסוכן, לא ל־PTC; צפו לאחת או שתיים בהגדרה חדשה. כלי שורת הפקודה דורש bash, curl ו־Python 3.6 או גרסה חדשה יותר.
הסקירה מכסה את התרגומים ש־PTC ביצעה. תרגומים שיובאו מהמאגר או נערכו ידנית נשארים כפי שהם.
הטוקן פועל בכל ארגון שהאדם מנהל; טוקן של מי שאינו מנהל אינו יכול ליצור פרויקטים.
כסף: PTC מציגה את המחיר וממתינה לאישור (yes) לפני כל עבודה בתשלום. תקופת ניסיון ממשיכה במסגרת המכסה החינמית שלה ונעצרת רק כאשר היא מגיעה למגבלה. לסוכן נאמר להעביר את הודעת השדרוג של PTC ולעולם לא לבצע רכישה בעצמו.
שגיאת שרת או היעדר תשובה מנוסים שוב על ידי כלי שורת הפקודה שלוש פעמים, החל מ־5 שניות והכפלה בכל פעם. הגבלת קצב (rate limit) שמציינת השהיה ממתינה את משך ההשהיה הזה, עד 300 שניות. כל שגיאת לקוח אחרת היא סופית באופן מיידי.
עמוד המדריך בתוך האפליקציה של PTC מיועד לצוות PTC. הלקוחות רואים את ההתקדמות בצ'אט של הסוכן ובלוח הבקרה של PTC.

חיבור

Claude Code

claude mcp add --transport http ptc https://app.ptc.wpml.org/mcp --header "Authorization: Bearer <your agent token>"

Codex

export PTC_API_TOKEN='<your agent token>'
codex mcp add ptc --url https://app.ptc.wpml.org/mcp --bearer-token-env-var PTC_API_TOKEN

Cursor ו־VS Code: העמוד 'חיבור הסוכן שלכם ל־PTC' מספק קובץ מוכן עבור כל אחד מהם (.cursor/mcp.json, .vscode/mcp.json) עם הטוקן שלכם כבר מוזן בפנים. עבור כל לקוח אחר, הוסיפו את נקודת הקצה יחד עם כותרת ה־Authorization בתצורת ה־MCP שלו.

ולאחר מכן פרומפט אחד: Set up PTC translations.

כדי להמשיך פרויקט שהתחלתם באשף ההגדרה של PTC, העתיקו את הפרומפט שלו מאותו עמוד, תחת Continue a project you began in the wizard (המשך פרויקט שהתחלתם באשף).

כלי שורת הפקודה עצמו הוא קוד פתוח (MIT): OnTheGoSystems/ptc-cli.