# פרק 5 - חיבורים: MCP, קונקטורים, API, ארטיפקטים ותוסף הכרום

> "עד עכשיו הסוכן עובד בתוך התיקייה. MCP מאפשר לו לפתוח דלת למערכת נוספת."

---

## 5.1 MCP - השקע המשותף

**האנלוגיה:** לפני שהיה תקן לשקעי חשמל, כל מכשיר הגיע עם תקע משלו. MCP (Model Context Protocol) הוא **התקן**. במקום שכל שירות ימציא דרך אחרת לדבר עם AI, MCP נותן מבנה משותף: אילו כלים יש, מה הם מקבלים, מה מחזירים.

**בשפה פשוטה:** שרת MCP הוא "מתאם" שאומר לקלוד: "אני יודע לקרוא את היומן שלך, ליצור אירוע, ולמחוק אירוע. הנה איך קוראים לי." קלוד לא צריך ללמוד את ה-API של גוגל. הוא רואה שלושה כלים.

**האם MCP זה API?** MCP משתמש ב-API מאחורי הקלעים, אבל הוא שכבה שמציגה יכולות לסוכן בפורמט משותף. **מקומי או ענן?** שניהם: `npx ...` מריץ שרת קטן על המחשב שלכם, `https://...` פונה לשרת רחוק (עם OAuth).

**מה יש היום (2026):** GitHub, Figma, Notion, Slack, Google Drive/Calendar/Gmail, Playwright (דפדפן), Supabase, Cloudflare, Context7 (תיעוד ספריות), Blender, Consensus (מאמרים), NotebookLM, כלי מדיה (fal, Magnific), ועוד מאות. אצלי מחוברים בין השאר: פיגמה, קנבה, גאמה, יומן, ג'ימייל, דרייב, בלנדר, Netlify, HuggingFace, Consensus, מנוע מדיה.

**איך מוסיפים (טרמינל):**
```bash
claude mcp add --transport http figma https://mcp.figma.com/mcp        # שרת רחוק
claude mcp add notebooklm -- npx -y notebooklm-mcp@latest              # שרת מקומי
claude mcp list
```
scopes: `local` (רק אני, רק כאן), `project` (קובץ `.mcp.json` בריפו, לצוות), `user` (כל הפרויקטים שלי). `/mcp` בתוך סשן מראה מה מחובר, מאפשר להתחבר (OAuth), ולכבות. באפליקציה: `+` -> Connectors (זה בדיוק MCP עם ממשק גרפי).

**קודקס:** אותם שרתים, ב-`~/.codex/config.toml` תחת `[mcp_servers.<שם>]`, או `codex mcp add`.

**שני דברים שכדאי לדעת:**
- **טוקנים.** כל שרת MCP מוסיף את שמות הכלים שלו לשולחן. היום זה "deferred" (רק שמות, הסכמות נטענות בשימוש), אבל 15 שרתים עדיין מרגישים. `/context` יראה. לכבות מה שלא בשימוש.
- **אבטחה.** שרת MCP = קוד שרץ עם הרשאות. שרת לא מוכר יכול לקרוא קבצים או להוציא מידע. אותם כללים: מקור מוכר, לקרוא מה הוא מבקש, OAuth ולא מפתחות ידניים בקבצים.

**מה זה נותן לי?** "תבדוק ביומן מתי פנוי לשרון, תציע 3 זמנים, ותכתוב לה מייל." שלוש דלתות (יומן, ג'ימייל, קובץ סיכום) בבקשה אחת.

---

## 5.2 קונקטורים - הדלת עם הידית המוכנה

**Connector** = שרת MCP עם **הגדרה גרפית**: לוחצים, מתחברים עם גוגל/סלאק/פיגמה, סיימתם. "MCP הוא התקן, Connector הוא המימוש."

**איפה:** באפליקציית הדסקטופ `+` -> Connectors (סשנים מקומיים ו-SSH; בענן מגדירים בזמן יצירת רוטינה). ניהול: Settings -> Connectors. ב-claude.ai (הצ'אט הרגיל) יש ספריית קונקטורים באותו חשבון, וטאב Cowork שואב מאותה הגדרה ("Customize"), שמסונכרנת דרך החשבון ולא מ-`~/.claude`.

**מה חשוב:** אחרי חיבור בודקים שלושה דברים: **מה אפשר לקרוא, מה אפשר לשנות, מה דורש אישור.** ולפני חיבור כותבים שלושה דברים: מה הוא חוסך, איזו הרשאה נדרשת, מה ה-fallback. אם אין תשובה טובה - לא מחברים.

**הכלל שחוזר:** מה שקונקטור מחזיר הוא **נקודת כניסה** למקור (כותרת, קישור), לא הראיה עצמה. Consensus מוצא מאמרים; הוא לא מכניס אותם אוטומטית לטבלה. אתם פותחים ובודקים.

**קודקס:** ה"פלאגינים" של קודקס (gmail, calendar, drive, figma, canva, github, vercel...) הם בערך קונקטורים + סקילים. אצלי מופעלים 26.

---

## 5.3 API ו-Agent SDK - למי שרוצה לבנות, לא רק להשתמש

**"API זה מפתח לשער שמאפשר לי לייבא טכנולוגיה ממקור אחד לאפליקציה שלי."** (זה מהרצאה שלי מ-2025, עדיין עומד.)

**מתי אתם צריכים API ולא מנוי?**
- כשאתם בונים **מוצר** שמישהו אחר משתמש בו (בוט וואטסאפ ללקוח, אתר שמייצר תוכן, אוטומציה שרצה בשרת 24/7).
- כשאתם רוצים לשלם לפי שימוש ולא מכסה.

**המנוי (Pro/Max)** = קלוד קוד, הצ'אט, Cowork, האפליקציות. יש מכסה. **API** (console.anthropic.com) = מפתח, משלמים לפי טוקנים, בלי חלונות של 5 שעות. קלוד קוד עצמו יכול לרוץ גם על מפתח API במקום login (למי שרוצה לעקוף מכסות בכסף).

**מודלים באוגוסט 2026** (למי שכותב קוד): `claude-fable-5` (החזק ביותר), `claude-opus-5`, `claude-sonnet-5` (היחס הכי טוב), `claude-haiku-4-5` (מהיר וזול). כולם עם קונטקסט של עד מיליון, prompt caching (חלק זול בהרבה כשחוזרים על אותו הקשר), Batch API (חצי מחיר לעבודה לא דחופה).

**Claude Agent SDK** (Python / TypeScript) = **קלוד קוד כספרייה**. אותו לולאת סוכן, אותם כלים (קריאה, כתיבה, טרמינל, חיפוש), אותם הוקים וסקילים - אבל אתם מארחים. זה מה שהייתי משתמש בו לבנות סוכן וואטסאפ ללקוח: Agent SDK + Twilio + Supabase. יש גם **Managed Agents** - אנתרופיק מארחת את הסוכן בשבילכם.

**מה לא צריך לדעת:** אם אתם רק משתמשים בקלוד קוד - לא צריך API בכלל. אם צריך - יש סקיל `claude-api` מובנה שיודע את כל המחירים והפרמטרים; פשוט תשאלו את קלוד "תבנה לי בוט טלגרם קטן עם Agent SDK".

---

## 5.4 ארטיפקטים - התוצר שעומד בפני עצמו

**מה זה:** "במקום להשאיר הכל בתוך השיחה, מקבלים חלון נפרד שאפשר לערוך ולשתף." בצ'אט ובקלוד קוד: קלוד יכול **לפרסם דף** (HTML או Markdown) לכתובת ב-claude.ai. פרטי כברירת מחדל; אתם מחליטים אם לשתף.

**מתי:** דוח, מדריך, דשבורד, השוואה - כל דבר שקורא-אחר צריך לפתוח בלי להתקין כלום. "תפרסם את סיכום האנליטיקס כארטיפקט ותן לי לינק לשלוח לצוות."

**מגבלות שכדאי לדעת:** הדף מבודד (CSP): לא יכול לקרוא לשרתים חיצוניים, לא פונטים מ-CDN, לא מצלמה/מיקרופון. הכל inline. עד 16MB. יש "capabilities" מתקדמות (נתונים חיים, מצב משותף) למי שיש. אפליקציית ווב אמיתית עם מצלמה? Netlify (אצלי מחובר), לא ארטיפקט.

**באפליקציית הדסקטופ** יש גם **פריוויו** של אפליקציות (השרת המקומי שלכם רץ בפאנל) ו**דפדפן פנימי** לגלישה - זה לא ארטיפקט, זה בשביל לבדוק מה בניתם.

---

## 5.5 Claude in Chrome - ידיים בדפדפן שלכם

**מה זה:** תוסף לכרום. קלוד יכול לפתוח טאבים, לקרוא דפים, ללחוץ, למלא טפסים, לצלם מסך, לקרוא console. **בדפדפן האמיתי שלכם, עם ההתחברויות שלכם.** (יש גם "Browser" פנימי באפליקציה, נקי בלי cookies - לגלישה כללית. הכרום - כשצריך את החשבונות שלכם.)

**התקנה:** תוסף Claude מחנות כרום -> באפליקציה/CLI הוא מופיע כ-MCP `claude-in-chrome`. בטרמינל `claude --chrome`.

**מתי:** "תיכנס ל-YouTube Studio ותוריד לי את הנתונים של השבוע", "תעלה את 15 הקבצים לדרייב דרך הדפדפן" (עשיתי את זה אתמול), "תבדוק שהאתר נראה טוב ב-3 רזולוציות". חילוץ מידע מאתרים שאין להם API. וגם: כשyt-dlp נכשל, הכרום מביא תמלול.

**"אני מעדיף לומר 'לעבוד בדפדפן' ולא 'להשתלט על הדפדפן'."** והזהירות: דף אינטרנט יכול להכיל הוראה זדונית שמנסה להשפיע על הסוכן. לכן מתחילים ב-Ask before acting, ומה שכתוב בדף = מידע, לא פקודה. קלוד לא ימלא סיסמאות/כרטיסי אשראי, לא יעבור CAPTCHA, ויבקש אישור לפני שליחה/פרסום/מחיקה. זה בכוונה.

---

## 5.6 מפה: איזו דלת למה

| אני רוצה ש... | הדלת |
|---|---|
| קלוד יקרא/יכתוב ביומן, מייל, דרייב, נושן, סלאק | **Connector** (`+` -> Connectors) |
| שירות שאין לו קונקטור מוכן | **MCP** ידני (`claude mcp add`) |
| לעבוד באתר בדפדפן שלי עם ההתחברות שלי | **Claude in Chrome** |
| לגלוש/לבדוק אתר בלי החשבונות שלי | **Browser** הפנימי |
| לתת למישהו דף לקרוא | **Artifact** |
| אפליקציה אמיתית עם מצלמה/שרת | Netlify / Cloudflare (דרך קלוד קוד) |
| לבנות מוצר/בוט למישהו אחר | **API / Agent SDK** |
| קובץ מהמק | `@` או גרירה. בלי דלת בכלל |