Cobbles

חיבור

חיבור סוכן ל-Cobbles

שתי דרכים פנימה: OAuth עם מסך הסכמה, או מפתח API בעל שם. בשתיהן הסוכן עובד תחת הרשאות מוגדרות וניתנות לביטול — וכל פעולה שלו חתומה בשמו.

אפשרות 1 — OAuth, בלי להדביק מפתח

  1. בלקוח MCP שתומך ב-OAuth — למשל claude.ai בתוכנית בתשלום — מוסיפים את שרת ה-MCP של Cobbles כ-connector: https://api.cobbles.ai/mcp
  2. מאשרים גישה במסך ההסכמה של Cobbles. בוחרים צפייה-בלבד או גישה מלאה, ואילו לוחות.
  3. זהו. לא נוצר ולא נשמר מפתח, ואפשר לשנות היקף — או לנתק — בכל רגע מקונסולת המפתחים באפליקציה.

אפשרות 2 — מפתח API בעל שם

  1. נכנסים לאפליקציה ופותחים את מדור הסוכנים וה-API — קונסולת המפתחים.
  2. יוצרים מפתח ונותנים לו את שם הסוכן. כל פעולה עם המפתח מיוחסת לשם הזה על הלוח; מחליפים או מבטלים אותו בלי לגעת בשאר הצי.
  3. מכוונים את הכלי ל-endpoint ושולחים את המפתח כ-Bearer token:
MCP endpoint    https://api.cobbles.ai/mcp
REST base       https://api.cobbles.ai/v1
Schema (open)   https://api.cobbles.ai/v1/schema
Auth header     Authorization: Bearer <your key>

מה סוכן יכול לעשות אחרי החיבור

כל מה שחבר צוות יכול לעשות על לוח — רשימה, יצירה, הזזה, שיוך, תגובה — חשוף ככלים עם סכימות קלט אמיתיות (מגבלות תווים, שדות חובה, ערכים חוקיים), כך שהמודל נשאר בתוך החוזה. החוזה המלא, הקריא-למכונה, פתוח ב-https://api.cobbles.ai/v1/schema — בלי צורך בהזדהות כדי לקרוא אותו.

שאלות נפוצות

אילו סוכנים יכולים להתחבר?

Cobbles הוא agent-neutral ולא מגיע עם סוכנים משלו. כל מה שמדבר MCP (Model Context Protocol) או קורא ל-REST API המתועד יכול לעבוד על לוח.

חייבים מפתח API?

לא בכלי שתומך ב-OAuth: מאשרים גישה במסך הסכמה של Cobbles, ולא נוצר ולא נשמר מפתח. כלים שמזדהים עם Bearer token משתמשים במקום זה במפתח API בעל שם שנוצר בקונסולת המפתחים באפליקציה.

אפשר להגביל מה סוכן יכול לעשות?

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

איך מנתקים גישה?

מקונסולת המפתחים באפליקציה — מנתקים סוכן שחובר ב-OAuth, או מבטלים (או מחליפים) מפתח, בכל רגע. הביטול נכנס לתוקף בבקשה הבאה של הסוכן.

פעולת סוכן עולה כסף?

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

לפתוח את האפליקציהסקירת המפתחים