# התקנת SosoAPI: חבילות, לקוחות ו-MCP מרוחק

כתובת URL קנונית: https://sosoapi.ai/he/docs/installation

חברו את הסוכן שלכם ל-SosoAPI באמצעות חבילה מקומית או MCP מתארח. המדריך מכסה התקנה, בדיקות חיבור ועדכונים.

## איזו חבילת npm להתקין?

להגדרה חדשה התקינו sosoapi. החבילות @sosoapi/cli, ‏sosoapi-cli ו-sosoapi-mcp הן כינויים שמתקינים בדיוק את אותה גרסת sosoapi. הן מפעילות את אותם כלי CLI ו-MCP, לכן נדרשת חבילה אחת בלבד.

MCP מקומי דורש Node.js 20 ואילך ו-npm/npx. ‏MCP מתארח אינו דורש חבילה מקומית. לאחר ההתקנה או החיבור, היכנסו כדי להעניק גישה לחשבונות שלכם.

הפצות npm

| Package | Purpose | Command |

| --- | --- | --- |

| sosoapi | שרת CLI ו-MCP קנוני | npx -y sosoapi --help |

| @sosoapi/cli | כינוי של sosoapi באותה גרסה בדיוק | npx -y @sosoapi/cli --help |

| sosoapi-cli | כינוי של sosoapi באותה גרסה בדיוק | npx -y sosoapi-cli --help |

| sosoapi-mcp | כינוי של sosoapi באותה גרסה בדיוק | npx -y sosoapi-mcp --help |

- [sosoapi](https://www.npmjs.com/package/sosoapi)

- [@sosoapi/cli](https://www.npmjs.com/package/@sosoapi/cli)

- [sosoapi-cli](https://www.npmjs.com/package/sosoapi-cli)

- [sosoapi-mcp](https://www.npmjs.com/package/sosoapi-mcp)

## חיבור לקוח MCP מקומי

השתמשו בפקודות שלהלן להוספת חיבור בפרופיל core. אם SosoAPI כבר מחובר ועובד, שמרו על החיבור הזה. הרצת sosoapi ללא ארגומנטים מפעילה את שרת MCP stdio; הוא ממתין ללקוח ב-stdin.

ל-Claude Desktop, ל-Cursor או ללקוח stdio אחר, הוסיפו את ה-JSON שלהלן בהגדרות ה-MCP שלו. מיקום ההגדרות ושלבי האישור משתנים בין לקוחות. הפעילו מחדש או חברו שוב את הלקוח לפי הצורך, ואז בדקו שכלי SosoAPI זמינים בשיחה שלכם.

```
claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

```
codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

```
{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}
```

- [תיעוד כלי MCP](https://sosoapi.ai/he/docs/mcp)

## חיבור MCP מרוחק עם OAuth

בלקוח התומך ב-MCP מרוחק, ב-OAuth וברישום לקוח דינמי, הוסיפו את ה-URL שלהלן. היכנסו דרך הדפדפן ובחרו סביבות עבודה ופעולות שתרצו לאפשר. אין צורך להדביק מפתח API, מזהה לקוח או סוד לקוח. כדי לספק מדיה דרך HTTP, ייבאו URL ציבורי; העלאת קובץ מקומי דורשת את שרת ה-MCP המקומי.

אפליקציות מותאמות ב-ChatGPT ומחברים מרוחקים ב-Claude תלויים במסלול ובהגדרות המחברים הזמינות בלקוח הזה. ההוראות מגדירות חיבור מותאם; הן אינן מתארות רישום בספריית אפליקציות.

```
https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp
```

- [אימות והרשאות](https://sosoapi.ai/he/docs/authentication)

## אימות ההגדרה בלי לפרסם

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

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

```
npx sosoapi auth status
```

```
npx sosoapi api contract --route /identity-api/workspace/list --summary
```

## עדכון גרסה או קיבועה

הריצו npx -y sosoapi@latest --help לקבלת ה-CLI העדכני, ואז הפעילו מחדש את לקוח ה-MCP. אם ללקוח יש פקודה שמורה, הכניסו את הגרסה הרצויה ב-args שלה. כינויים נשארים קשורים לגרסת sosoapi המדויקת שלהם; עדכון התקנה גלובלית נפרדת לא יעדכן אותם.

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

```
npx -y sosoapi@latest --help
```

```
npx sosoapi api contract --summary
```

- [פתרון בעיות](https://sosoapi.ai/he/docs/troubleshooting)