תיעוד למפתחים

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

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

נבדק על ידי צוות SosoAPI · 2026-10-21

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

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

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

הפצות npm
חבילה	מטרה	פקודה
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

חיבור לקוח 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

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

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

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

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

אימות והרשאות

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

בדקו 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

פתרון בעיות