חיבור כלים חיצוניים עם Composio MCP
לעולם לא תצטרכו להעתיק-הדביק בין Gmail, Notion ו-Slack בעצמכם. MCP נותן ל-Claude Code “ידיים” — והמדריך הזה מלמד איך לחבר אותן.
מה זה MCP, בעברית פשוטה
MCP — השפה המשותפת של סוכני AI
MCP (Model Context Protocol) הוא תקן פתוח שפרסמה Anthropic ב-2024. תחשבו עליו כ"USB לכלים דיגיטליים" — כל כלי שמדבר MCP יכול להתחבר לכל סוכן AI שמדבר MCP, בלי חיבורים מיוחדים לכל זוג.
לפני MCP: Claude ידע לכתוב טיוטת אימייל, אבל לא יכול היה לשלוח אותה. ידע לתכנן פגישה, אבל לא יכול היה לפתוח אירוע בקלנדר. בכל פעם הייתם צריכים להעתיק, להדביק, לפתוח טאב אחר.
עם MCP: Claude Code מחובר ישירות ל-Gmail, ל-Google Calendar, ל-Slack, ל-Notion — ויכול לבצע פעולות בתוכם. לא רק לכתוב, אלא לשלוח, ליצור, לעדכן ולחפש.
כל חיבור כזה נקרא MCP Server — שירות חיצוני שמספק ל-Claude Code יכולות חדשות. Composio מספקת עשרות MCP Servers מוכנים מראש, בלי שתצטרכו לבנות כלום בעצמכם.
אותה גישה עובדת גם על Codex (מוצר ה-AI של OpenAI) — אז אם עובדים עם שניהם, ההשקעה בחיבור היא חד-פעמית.
הזרימה: שלושה שלבים
מאשרים כלים ב-Composio
נכנסים ל-composio.dev, בוחרים אילו כלים לחבר (Gmail, Slack וכד'), ומאשרים גישה דרך OAuth — בדיוק כמו "כניסה עם Google". Composio לא שומרת סיסמאות.
Composio מייצרת URL ומפתח API
לאחר האישור, Composio מספקת כתובת MCP ייחודית ומפתח API. אלה שני "כרטיסי הכניסה" שתצטרכו בשלב הבא.
מחברים עם פקודה אחת
מריצים claude mcp add עם ה-URL והמפתח. Claude Code מכיר את כל הכלים שחיברתם — מאותו רגע ואילך.
לפני שמתחילים
- Claude Code מותקן על המחשב — ראו מדריך ההתקנה (חלק 2)
- חשבון Composio (חינמי): composio.dev — צרו לפני שממשיכים
- אינטרנט פעיל לאימות OAuth בשלב 1
ה-skill agent-onboarding-wizard ב-Claude Code בודק MCP Server חדש לפני שמתקינים אותו: הוא מסביר מה הוא עושה, ממליץ על scope מתאים (פרויקט ספציפי או גלובלי), ומזהיר מפני התקנת עשרות כלים שלא תשתמשו בהם. הפעילו אותו לפני כל חיבור MCP חדש — הוא רשת הביטחון שלכם.
שלב 1 — צרו חשבון ואשרו כלים
הרשמה וחיבור הכלים הראשונים
היכנסו ל-composio.dev וצרו חשבון חינמי (ניתן להרשם עם Google).
לאחר ההרשמה, תגיעו ל-Dashboard. משם בחרו Integrations ואז חפשו את הכלים שתרצו לחבר. נקודות פתיחה טובות: Gmail, Google Calendar, Notion, Slack, GitHub, Linear.
לכל כלי, Composio יפתח חלון OAuth סטנדרטי — תהליך מוכר של "אשר גישה". בחרו בחשבון שלכם ואשרו. חשוב להבין: Composio לא מקבלת את הסיסמה שלכם. OAuth נותן לה token גישה מוגבל — אפשר לבטל אותו בכל עת מהגדרות Google, Slack, או כל שירות אחר.
התחילו עם 2–3 כלים בלבד. קל להוסיף עוד אחר כך, ואין טעם לחבר כלים שלא תשתמשו בהם.
שלב 2 — השיגו את ה-MCP URL ומפתח ה-API
שני פרטים שצריך לשמור
בממשק Composio, נווטו אל MCP Servers ולחצו Create MCP Server (או Add MCP Server — התפריט עשוי להשתנות בגרסאות שונות). בחרו אילו כלים לכלול ב-Server.
Composio תייצר כתובת MCP בצורה:
https://mcp.composio.dev/your-unique-token
בנוסף, תצטרכו את מפתח ה-API שלכם ב-Composio. תמצאו אותו תחת Settings → API Keys (או הוא מוצג ישירות בדף ה-MCP Server). צרו מפתח חדש אם עדיין אין לכם.
שלב 3 — חברו עם פקודה אחת
claude mcp add
פתחו Terminal (ב-Windows: PowerShell או Command Prompt). הריצו:
claude mcp add --transport http composio-composio "https://YOUR_MCP_URL" \ --headers "X-API-Key:YOUR_COMPOSIO_API_KEY"
החליפו https://YOUR_MCP_URL ב-URL מ-Composio, ו-YOUR_COMPOSIO_API_KEY במפתח ה-API שלכם.
לאחר הרצת הפקודה, הפעילו מחדש את Claude Code — סגרו לגמרי ופתחו שוב.
בחרו את הscope המתאים
ברירת המחדל היא local scope (מאוחסן ב-~/.claude.json, זמין רק בפרויקט הנוכחי). אפשר לשנות:
| Scope | מתי להשתמש | איפה מאוחסן |
|---|---|---|
ברירת מחדל |
לבדיקה ראשונה, פרויקט ספציפי | ~/.claude.json |
--scope project |
שיתוף עם הצוות דרך Git | .mcp.json בשורש הפרויקט |
--scope user |
כל הפרויקטים שלכם, רק אתם | הגדרות משתמש גלובליות |
לשיתוף עם צוות, הריצו עם --scope project ואז ה-.mcp.json שנוצר אפשר לעלות ל-Git:
claude mcp add --transport http composio-composio "https://YOUR_MCP_URL" \ --headers "X-API-Key:YOUR_COMPOSIO_API_KEY" --scope project
הערה: עריכה ידנית של קובץ .claude.json אפשרית אך מוגדרת כגישה מורשת/ישנה. מומלץ תמיד להשתמש ב-CLI.
שלב 4 — וודאו ואמתו
שני שלבי אימות
בדקו שה-MCP רשום:
claude mcp list
אתם אמורים לראות composio-composio ברשימה, עם הסטטוס connected.
אמתו OAuth (לכלים שדורשים זאת):
בתוך Claude Code, הקלידו:
/mcp
פקודה זו פותחת את ממשק ניהול ה-MCP ומאפשרת לכם להשלים זרימות OAuth שנותרו פתוחות. אם חיברתם Gmail — ייתכן שתתבקשו לאשר שוב דרך Claude Code ספציפית.
לאחר ה-/mcp, הפעילו מחדש את Claude Code.
סימן הצלחה: Claude Code עונה על שאלות כמו "כמה אימיילים לא נקראים יש לי היום?" עם נתונים אמיתיים מ-Gmail.
מה אפשר לבקש עכשיו
חמש בקשות שהפכו אפשריות
- סכם את האימיילים הלא-נקראים של היום ושלח את הסיכום לערוץ #team ב-Slack.
- ענה לאימייל האחרון מאבי בסגנון מקצועי ואמור שנענה תוך יומיים.
- צור אירוע בקלנדר ל-15 ביוני, 14:00–16:00, עם הזמנה לדנה ולרון.
- עדכן את המשימה "בדיקת עיצוב" ב-Linear לסטטוס "In Review" והוסף הערה: "ממתין לפידבק".
- פתח Issue ב-GitHub בפרויקט landing-ai עם כותרת "תיקון layout מובייל" ותייג אותו כ-bug.
כלים נתמכים
150+ אינטגרציות לפי קטגוריה
הקטלוג המלא — כולל כלים של CRM, מסדי נתונים ופלטפורמות פיתוח — נמצא בכתובת composio.dev.
Composio לא שומרת את הסיסמאות שלכם — לא פעם אחת. כל חיבור נעשה דרך OAuth, שמייצר token גישה מוגבל שנשלח ישירות מהשירות (Google, Slack וכד'). אפשר לבטל גישה בכל עת מהגדרות הכלי עצמו — למשל מ-Google Account Security. Claude Code עצמו לא שומר אישורים, הוא מדבר עם ה-MCP Server בלבד.
פתרון בעיות נפוצות
הבעיות הנפוצות ביותר
ה-MCP לא מופיע ב-claude mcp list
בדקו שהפקודה claude mcp add רצה ללא שגיאות. אם יש שגיאת "permission denied" ב-Windows, נסו להריץ את PowerShell כמנהל. לאחר מכן הפעילו מחדש את Claude Code לחלוטין.
חלון ה-OAuth נסגר לפני שסיימתם
הריצו /mcp בתוך Claude Code כדי לפתוח מחדש את זרימת האימות. אם הבעיה נמשכת, היכנסו לממשק Composio, שחררו את הגישה לאותו כלי ואשרו מחדש.
הוספתם ל-scope הלא נכון
אם הוספתם ל-local scope בטעות, הריצו claude mcp remove composio-composio ואז הוסיפו שוב עם ה-scope הנכון.
מפתח ה-API פג
היכנסו ל-Composio תחת Settings → API Keys, צרו מפתח חדש, ועדכנו את הפקודה claude mcp add עם המפתח החדש (הסירו קודם עם claude mcp remove).
Claude Code עונה "אין לי גישה"
זה בדרך כלל אומר שהכלי הספציפי לא נכלל ב-MCP Server ב-Composio. היכנסו לממשק, ערכו את ה-Server והוסיפו את הכלי שחסר.
לאן ממשיכים
החלק הבא — יועץ ה-AI לרפוזיטורי
עכשיו שיש לכם Claude Code מחובר לכלים, חלק 5 בסדרה מלמד איך לבחור אילו רפוזיטורי להתקין ואיך AI יועץ-קוד מוסיף ערך מעבר ל-MCP.
חזרה לחלק 3? ראו שם איפה ה-MCP Servers ממוקמים בתוך ארכיטקטורת ה-Workspace — תיקיית .claude ו-CLAUDE.md שלכם הם שורת הפיקוד של כל הכלים האלה.