מחבר MCP

מחבר Model Context Protocol‏ (MCP) מאפשר לכם ליצור ולקבוע את ההגדרות של חיבור MCP ב-Integration Connectors. אתם יכולים להשתמש בחיבור הזה באפליקציות העסקיות שלכם כדי להחליף נתונים בצורה מאובטחת ולבצע פעולות באמצעות MCP.

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

גרסאות של מחברי MCP

מחבר ה-MCP תומך בשתי גרסאות:

  • ‫MCP v1: משתמשים בגרסת המחבר הזו כדי לגשת ל-MCP v1 API.
  • ‫MCP v2: משתמשים בגרסת המחבר הזו כדי לגשת ל-API של MCP v2.

מידע על יצירת חיבור MCP זמין במאמר יצירה והגדרה של מחבר MCP.

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

  • פעולה: פעולה היא הפעילות שאפשר לבצע בישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

    בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה Operations.

  • פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

ישויות ופעולות נתמכות

מחבר ה-MCP תומך בישויות ובפעולות, והזמינות שלהן תלויה בכלי שמחובר דרך ה-MCP.

דוגמאות לפעולות על ישויות

בקטע הזה מובאות דוגמאות לפעולות על ישויות בכלים שונים.

רשימת ישויות של בעיות ב-Jira

בדוגמה הזו מוצגת רשימה של כל הבעיות בישות הבעיות באמצעות חיבור Jira MCP.

  1. בחלון Configure Connector Task (הגדרת משימת מחבר), לוחצים על Entities (ישויות).
  2. בוחרים באפשרות בעיות מהרשימה ישות.
  3. בוחרים בפעולה רשימה ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value (ערך ברירת מחדל): 
    {
      "operation": "LIST_ENTITIES",
      "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
      "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
      "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
      "entity": "Issues",
      "entity_id": "Issues",
      "page_token": ""
    }

הצגת כל הבקשות

בדוגמה הזו מופיעה רשימה של כל הבקשות בישות הבקשות.

  1. בחלון Configure Connector Task (הגדרת משימת מחבר), לוחצים על Entities (ישויות).
  2. ברשימה ישות, בוחרים באפשרות בקשות.
  3. בוחרים בפעולה רשימה ולוחצים על סיום.

אחזור משתמש לפי מזהה

בדוגמה הזו, המשתמש עם AccountId כ-`6035864ce2020c0070b5285b` מתקבל מהישות Users. ‫`AccountId` הוא המפתח הראשי של הישות Users. כדי לקבל ישות ספציפית, משתמשים בפעולה List עם filterClause במפתח הראשי, כי הפעולה Get לא נתמכת עבור הישות הזו.

  1. בחלון Configure Connector Task (הגדרת משימת מחבר), לוחצים על Entities (ישויות).
  2. ברשימה Entity, בוחרים באפשרות Users.
  3. בוחרים בפעולה רשימה ולוחצים על סיום.
  4. בקטע Task Input במשימה Connectors, לוחצים על filterClause ומזינים את הערך ‎ `AccountId`=6035864ce2020c0070b5285b בשדה Default Value.

פעולות

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

דוגמאות לפעולות

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

פעולות ב-Jira: קבלת קריאות

בדוגמה הזו נסביר איך לפרט קריאות ב-Jira באמצעות חיבור MCP שהוגדר ל-Jira.

  1. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
  2. בוחרים בפעולה get_issues ולוחצים על סיום.
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value (ערך ברירת מחדל): 
      {
    "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
  }

Linear actions: List issues

בדוגמה הזו נראה איך מציגים רשימה של בעיות ב-Linear באמצעות חיבור MCP שהוגדר ל-Linear.

  1. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
  2. בוחרים בפעולה list_issues ולוחצים על Done (סיום).
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value (ערך ברירת מחדל): 
      {
    "limit": 50
  }

Sentry Actions: Whoami

בדוגמה הזו מוסבר איך לקבל פרטי משתמש מ-Sentry באמצעות חיבור MCP שהוגדר ל-Sentry.

  1. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
  2. בוחרים בפעולה whoami ולוחצים על סיום.
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value (ערך ברירת מחדל): 
      {
    "name": "example-org"
  }

חיפוש ארגונים

בדוגמה הזו נראה איך למצוא ארגונים ב-Sentry באמצעות חיבור MCP שהוגדר ל-Sentry.

  1. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
  2. בוחרים בפעולה find_organizations ולוחצים על סיום.
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value (ערך ברירת מחדל): 
      {}

פעולות באינטרקום: חיפוש שיחות

בדוגמה הזו מוסבר איך לחפש פרטים של שיחות ב-Intercom באמצעות חיבור MCP שהוגדר ל-Intercom.

  1. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
  2. בוחרים את הפעולה חיפוש ולוחצים על סיום.
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value (ערך ברירת מחדל): 
      {
    "query": "object_type:conversations state:open created_at:gt:2024-01-01"
  }

מגבלות המערכת

למחבר MCP יש מגבלות מערכת שעשויות להשתנות בהתאם לכלי הספציפי שמחובר. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.