התקנת גישת AIבחמש דקות
ארבעה שלבים קצרים. צרו מפתח API, הדביקו ב-Cursor או Claude Desktop, אמתו את החיבור, ובדקו ב-FAQ אם משהו לא עובד.
בחרו את הכלי
לחצו על כלי ה-AI שלכם כדי לקפוץ ישר להוראות. כל הזרמים עם אותם scopes - ההבדל היחיד הוא איך הכלי מאמת.
1. השגת פרטי גישה
שני זרמים, אותם scopes. בחרו לפי הכלי.
מפתח API (X-API-Key + X-API-Secret)
ל-Cursor, Claude Desktop, ולסקריפטים שאתם כותבים. עצמאי בפאנל: פתחו תיעוד API → צרו מפתח API. בחרו בסט Standard. הסוד מוצג פעם אחת - העתיקו לפני שתסגרו.
פתיחת תיעוד APIOAuth 2.1
ל-ChatGPT, Zapier, Make.com, n8n ושאר פלטפורמות ה-no-code שצריכות כפתור Login במקום מפתח API. בפאנל: פתחו את אפליקציות OAuth → רישום אפליקציה. ה-client_id וה-client_secret מוצגים פעם אחת - העתיקו לפני סגירה.
פתיחת אפליקציות OAuth2. חיבור Cursor או Claude Desktop
פתחו את קובץ ההגדרות של הלקוח שלכם והוסיפו את הרשומה של פרוגינטר. Native remote MCP עובד בגרסאות חדשות; ה-shim של mcp-remote הוא הגיבוי לגרסאות ישנות. הפעילו מחדש את הלקוח אחרי העריכה.
Cursor
ערכו את ~/.cursor/mcp.json (אם אין - צרו אותו).
Native remote (Cursor חדש)
{
"mcpServers": {
"proginter": {
"url": "https://proginter.com/mcp",
"headers": {
"X-API-Key": "pk_your_public_key",
"X-API-Secret": "sk_your_secret_key"
}
}
}
}Stdio shim כגיבוי (Cursor ישן)
{
"mcpServers": {
"proginter": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://proginter.com/mcp",
"--header",
"X-API-Key:pk_your_public_key",
"--header",
"X-API-Secret:sk_your_secret_key"
]
}
}
}Claude Desktop
ערכו את claude_desktop_config.json - הנתיב משתנה לפי מערכת ההפעלה, ראו את התיעוד של Claude Desktop.
Native remote (Claude Desktop חדש)
{
"mcpServers": {
"proginter": {
"url": "https://proginter.com/mcp",
"headers": {
"X-API-Key": "pk_your_public_key",
"X-API-Secret": "sk_your_secret_key"
}
}
}
}Stdio shim כגיבוי (Claude Desktop ישן)
{
"mcpServers": {
"proginter": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://proginter.com/mcp",
"--header",
"X-API-Key:pk_your_public_key",
"--header",
"X-API-Secret:sk_your_secret_key"
]
}
}
}3. אמתו את ההתקנה
הפעילו מחדש את לקוח ה-AI ושאלו שאלת קריאה בלבד. אם הוא עונה עם מידע אמיתי מהחשבון, סיימתם.
שאלו את ה-AI
"תראה לי את פרופיל החשבון שלי בפרוגינטר."
מה לצפות
תשובה נקייה עם השם והאימייל שלכם - זה 200 OK מהכלי account_profile. אם רואים 401, קפצו ל-FAQ למטה.
4. חיבור ChatGPT
פעולות Custom GPT של ChatGPT צריכות כותרת Authorization יחידה, אז הן משתמשות ב-OAuth במקום במפתח API. רישמו את ה-GPT לבד בפאנל ואז הדביקו את הפרטים בבונה ה-GPT.
א. רישום אפליקציית OAuth
בפאנל, פתחו אפליקציות OAuth → רישום אפליקציה. הכניסו את כתובת ה-redirect ש-ChatGPT ייתן לכם (בדרך כלל https://chat.openai.com/aip/...) ואת ה-scopes שצריך (למשל websites:files, servers:plan). בעת השמירה תקבלו client_id ו-client_secret - הסוד מוצג פעם אחת.
ב. הגדרת הפעולה ב-Custom GPT
ב-GPT builder, בחרו Authentication: OAuth. הדביקו:
- Client ID: ה-client_id שהעתקתם מאפליקציות OAuth
- Client Secret: ה-client_secret שהעתקתם בעת הרישום (חד פעמי)
- Authorization URL:
https://proginter.com/client/oauth/authorize - Token URL:
https://proginter.com/oauth/token - Scope: רשימה מופרדת ברווחים של ה-scopes שאישרתם בעת הרישום
- Token Exchange Method:
POST request (default)
להעלאת ה-OpenAPI schema, השתמשו ב-https://proginter.com/api/v1/openapi.json.
ג. בדיקה
שמרו את ה-GPT, לחצו "Test", ובקשו: "תראה לי את פרופיל החשבון שלי בפרוגינטר." ChatGPT יפנה אתכם בפעם הראשונה למסך אישור של פרוגינטר. אשרו, ואז ChatGPT מקבל טוקן ועונה עם הנתונים האמיתיים שלכם.
5. FAQ
תשובות קצרות לדברים שלרוב משתבשים.
OAuth או X-API-Key - מה לבחור?
שני הזרמים פונים לאותן נקודות קצה עם אותם scopes - הבחירה היא לפי הכלי. X-API-Key: הכי טוב ל-Cursor, Claude Desktop, וסקריפטים שאתם כותבים - בכל מקום שאתם שולטים בשני הצדדים. OAuth: נדרש על ידי ChatGPT Custom GPT Actions ורוב הפלטפורמות ללא קוד (Zapier, Make.com, n8n) כי הן מקבלות רק כותרת Authorization אחת. אפשר להישאר עם X-API-Key לעולם אם זה עובד לכם - אנחנו לא מסירים אותו.
מקבל 401 - מה עכשיו?
פרטי הגישה שגויים, פגי תוקף או שכותרת חסרה. במסלול X-API-Key: ודאו ש-X-API-Key וגם X-API-Secret מוגדרים. אם זה ממשיך ליפול, סובבו את המפתח מעמוד תיעוד ה-API. במסלול OAuth: טוקן הגישה אולי פג תוקף (שעה), הכלי שלכם אמור לרענן אוטומטית. אם לא, המשתמש יצטרך לאשר מחדש.
איך מבטלים גישת OAuth שאישרתי קודם?
פתחו את עמוד "אפליקציות מחוברות" בסיידבר של פאנל הלקוח. הוא מציג כל הרשאת OAuth - שם האפליקציה, scopes, מתי אושרה, מתי שומשה לאחרונה. לחיצה על Disconnect מבטלת את כל הטוקנים מיידית. האפליקציה תצטרך להתחבר מחדש.
יש CDN או פרוקסי בדרך - מה עושים?
חלק מהקצוות מסירים כותרות X-* מותאמות. שני פתרונות: (א) אפשרו ל-X-API-Key ו-X-API-Secret לעבור דרך ה-CDN, או (ב) השתמשו ב-stdio shim שלמעלה - ה-shim שולח כותרות מהמכונה המקומית כך שאף קצה לא יכול להסיר. כותרת ה-Authorization של OAuth היא תקנית ולכן רוב ה-CDNs לא נוגעים בה.
איך אני רואה מה הלקוח שלי באמת שולח?
פנו לנקודת הקצה האבחונית עם הכותרות שלכם - היא מחזירה את מה שקיבלנו עם סודות מוסתרים: https://proginter.com/mcp-diagnostic/echo-headers
מה זה "אישור הרסני"?
כל פעולה שמוחקת, מחייבת או מחליפה נתונים דורשת אישור מפורש. רוב הלקוחות מציגים אישור. אם הלקוח שלכם לא, ה-AI חייב להוסיף _confirm: true בקריאה. פעולות קריאה בלבד לעולם לא דורשות זאת.
הכל מחובר?
צרו מפתח בפאנל, הדביקו אותו בהגדרות הלקוח, ובקשו את פרופיל החשבון לאימות.
