התקנת גישת AIבחמש דקות
Claude מתחבר בלחיצה אחת עם כתובת אינטרנט בלבד. ל-Cursor או ChatGPT, עברו כמה שלבים קצרים עם מפתח API או התחברות. כך או כך אתם מוכנים תוך כחמש דקות.
בחרו את הכלי
לחצו על כלי ה-AI שלכם כדי לקפוץ ישר להוראות. כל הזרמים עם אותם scopes - ההבדל היחיד הוא איך הכלי מאמת.
הדרך בלחיצה אחת: הוספת connector
אם אתם משתמשים ב-Claude, זו הדרך הכי קלה. Claude מתחבר ל-Proginter עם כתובת אחת בלבד - בלי מפתח API ובלי קובץ הגדרות. ל-Cursor, ChatGPT או סקריפטים משלכם, השתמשו בשלבי פרטי הגישה למטה.
א. פתחו את הגדרות ה-Connectors
ב-Claude, היכנסו ל-Settings → Connectors (ב-claude.ai או ב-Claude Desktop), או הפעילו את תהליך הוספת ה-connector ב-Claude Code. לחצו על Add custom connector.
ב. הדביקו את הכתובת של Proginter
תנו שם כמו Proginter והדביקו את הכתובת הזו. השאירו את שאר השדות ריקים - לא צריך כאן client ID, סוד או טוקן. לחצו על Add.
https://proginter.com/mcpג. התחברו ואשרו
Claude יפתח דף התחברות של Proginter בדפדפן. התחברו לחשבון אם עוד לא, עברו על ההרשאות ש-Claude מבקש, ולחצו על Approve. אם הדף לא נפתח לבד, העתיקו את הקישור ש-Claude מציג ופתחו אותו ידנית.
ד. פשוט תשאלו
בחזרה ב-Claude, הכלים של Proginter מוכנים. בקשו "תראה לי את פרופיל החשבון שלי בפרוגינטר." תשובה נקייה עם השם והאימייל שלכם - אתם מחוברים.
1. השגת פרטי גישה
שני זרמים, אותם scopes. בחרו לפי הכלי.
מפתח API (X-API-Key + X-API-Secret)
ל-Cursor, Claude Desktop, ולסקריפטים שאתם כותבים. עצמאי בפאנל: פתחו תיעוד API → צרו מפתח API. בחרו באפשרות MCP (AI assistant) כדי שהמפתח יעבוד מכל מכשיר, ואז בחרו את ההרשאות שאתם צריכים. הסוד מוצג פעם אחת - העתיקו לפני שתסגרו. כשהמפתח מוצג תקבלו גם כרטיס Connect your AI assistant עם הגדרות מוכנות להעתקה.
פתיחת תיעוד APIOAuth 2.1
ל-ChatGPT, Zapier, Make.com, n8n ושאר פלטפורמות ה-no-code שצריכות כפתור Login במקום מפתח API. בפאנל: פתחו את אפליקציות OAuth → רישום אפליקציה. ה-client_id וה-client_secret מוצגים פעם אחת - העתיקו לפני סגירה.
פתיחת אפליקציות OAuth2. חיבור Cursor או Claude Desktop
פתחו את קובץ ההגדרות של הלקוח שלכם והוסיפו את הרשומה של פרוגינטר. Cursor קורא את צורת ה-url + headers ישירות. Claude Desktop לא תמיד מעביר כותרות מותאמות, אז שם השתמשו ב-shim של mcp-remote. הפעילו מחדש את הלקוח אחרי העריכה.
קיצור דרך: העתיקו הגדרה מוכנה
כשאתם יוצרים או מחליפים מפתח בתיעוד API, הפאנל מציג כרטיס Connect your AI assistant עם בלוק הגדרות שכבר ממולא במפתחות שלכם. העתיקו אותו והדביקו בלקוח, בלי עריכה ידנית. התבניות שלמטה הן לעיון, או אם אתם משתמשים שוב במפתח קיים.
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.
מומלץ - shim של mcp-remote (שולח את הכותרות בכל קריאה)
{
"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"
]
}
}
}Native remote (רק אם הגרסה שלכם מעבירה כותרות מותאמות)
{
"mcpServers": {
"proginter": {
"url": "https://proginter.com/mcp",
"headers": {
"X-API-Key": "pk_your_public_key",
"X-API-Secret": "sk_your_secret_key"
}
}
}
}שימו לב: הרבה גרסאות של Claude Desktop מתחברות ל-URL אבל לא שולחות את ה-headers בקריאות לכלים, וזה נכשל בשגיאת אימות. אם זה קורה, השתמשו בשיטת mcp-remote שלמעלה.
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
תשובות קצרות לדברים שלרוב משתבשים.
באיזו שיטת חיבור לבחור?
בחרו לפי הכלי - כל הדרכים מגיעות לאותן פעולות עם אותם scopes. Claude: ה-connector בלחיצה אחת הוא הכי פשוט - מוסיפים עם כתובת אחת בלבד, בלי מפתח לנהל. Cursor וסקריפטים משלכם: X-API-Key הוא הבחירה הקלה. ChatGPT ופלטפורמות ללא קוד (Zapier, Make.com, n8n): OAuth, כי הן מקבלות רק כפתור Login אחד. אפשר להישאר עם X-API-Key כמה שתרצו - אנחנו לא מסירים אותו.
מקבל 401 - מה עכשיו?
פרטי הגישה שגויים, פגי תוקף או שכותרת חסרה. במסלול X-API-Key: ודאו ש-X-API-Key וגם X-API-Secret מוגדרים. אם זה ממשיך ליפול, סובבו את המפתח מעמוד תיעוד ה-API. במסלול OAuth: טוקן הגישה אולי פג תוקף (שעה), הכלי שלכם אמור לרענן אוטומטית. אם לא, המשתמש יצטרך לאשר מחדש.
האם Proginter עובד כ-connector ב-Claude?
כן. הוסיפו את Proginter כ-custom connector ב-Claude עם כתובת אחת בלבד - פתחו Connectors, בחרו Add custom connector, הדביקו https://proginter.com/mcp, ואז התחברו ואשרו. לדרך הזו לא צריך מפתח API ולא קובץ הגדרות. אם אתם מעדיפים מפתח API, שיטת ה-mcp-remote שלמעלה עדיין עובדת והכלים מופיעים יחד עם שאר כלי ה-MCP שלכם.
איך מבטלים גישת 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 בקריאה. פעולות קריאה בלבד לעולם לא דורשות זאת.
הכל מחובר?
Claude מתחבר בלחיצה אחת. ל-Cursor או ChatGPT, צרו מפתח או התחברו. ואז בקשו את פרופיל החשבון לאימות.
