Dvina MCP

שימוש ב-Dvina מאפליקציות אחרות עם MCP

חברו לקוח MCP כמו Claude Code, ChatGPT או Cursor ל-Dvina, התחברו לחשבון ואפשרו לו לקרוא תוכן ולהוסיף תוכן ל-Dvina שלכם באישורכם.

הצגה כמרקדאון

ל-Dvina יש שרת MCP משלה. חברו לקוח MCP, כמו Claude Code, ChatGPT או Cursor, והאפליקציה תוכל לחפש ב-Dvina שלכם, לקרוא את המסמכים והזיכרון שלכם ולהוסיף הערות, משימות ותזכורות בשמכם.

לפני שמתחילים

תצטרכו את כתובת השרת:

https://api.dvina.ai/mcp

אם החברה שלכם מפעילה את Dvina בשרתים שלה, השתמשו בכתובת ה-API של Dvina בחברה שלכם, עם /mcp בסוף. בקשו את הכתובת ממנהל המערכת שלכם.

השרת משתמש ב-Streamable HTTP. אם הלקוח מבקש לבחור פרוטוקול תעבורה, בחרו HTTP.

חיבור לקוח

Claude Code

  1. בטרמינל, הריצו:

    claude mcp add --transport http dvina https://api.dvina.ai/mcp

  2. פתחו את Claude Code, הריצו /mcp, בחרו dvina והתחברו ל-Dvina.

ChatGPT

  1. פתחו ב-ChatGPT את המקום שבו אפשר להוסיף שרת MCP.
  2. הזינו את https://api.dvina.ai/mcp ככתובת השרת, ובחרו OAuth אם תתבקשו לבחור איך להתחבר.
  3. התחברו ל-Dvina כש-ChatGPT יבקש זאת.

Cursor

  1. פתחו ב-Cursor את המקום שבו אפשר להוסיף שרת MCP.
  2. הוסיפו שרת בשם dvina עם הכתובת https://api.dvina.ai/mcp.
  3. התחברו ל-Dvina כש-Cursor יבקש זאת.

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

התחברות

שרת ה-MCP של Dvina משתמש ב-OAuth כדי לחבר אתכם לחשבון דרך הדפדפן:

  1. התחברו ל-Dvina כרגיל.
  2. אם אתם שייכים ליותר מסביבת עבודה אחת, בחרו אחת תחת בחירת סביבת עבודה, ואז בחרו המשך. הלקוח פועל רק בסביבת העבודה הזו.
  3. תחת אישור גישה, בדקו את שם האפליקציה ואז בחרו אפשר גישה. בחרו דחה אם אינכם מזהים אותה.

הלקוח נשאר מחובר, כך שלא צריך להתחבר בכל פעם.

מה הלקוח יכול לעשות

הלקוח רואה את הכלים של Dvina ומשתמש בהם כשהבקשה שלכם מצריכה זאת:

תחום מה יישום הלקוח יכול לעשות
חיפוש לחפש בשיחות, במסמכים, בזיכרון ובעולם שלכם בבת אחת.
זיכרון להציג את רשימת קובצי הזיכרון שלכם ולקרוא אותם, להוסיף קובץ חדש או לשנות קובץ קיים.
עולם להציג את רשימת הנושאים שלכם, להראות מה Dvina יודעת על נושא מסוים או על כל דבר אחר, ולהציג את רשימת הפריטים בפיד שלכם.
מסמכים להציג את רשימת הפריטים בספרייה שלכם, לקרוא ולחפש בה, ליצור הערות ותיקיות, להעלות קבצים, ולהחליף, להעביר או לשנות שם של מסמך, או להעביר אותו לאשפה.
קנבס להציג את רשימת הקנבסים שלכם ולקרוא אותם, ליצור קנבס או לשכתב עמוד.
משימות ויעדים להציג את רשימת המשימות שלכם ולקרוא מה הן עשו, להתחיל משימה או משימה שמקדמת יעד, לשלוח למשימה עבודה נוספת או לעצור אותה.
הודעות מתוזמנות להציג את רשימת ההודעות המתוזמנות, לתזמן הודעה או תזכורת חד־פעמית או חוזרת, או לבטל אותן.
סוכנים ומיומנויות להציג את רשימת הסוכנים והמיומנויות שלכם ולקרוא אותם, ליצור סוכן, להוסיף מיומנות או לשנות סוכן או מיומנות.
פרויקטים להציג את רשימת הפרויקטים שלכם ולהראות את התיקייה ואת המשימות האחרונות של פרויקט.
שיתוף לראות למי יש גישה לפריט ומה אחרים שיתפו איתכם, או להעניק למישהו גישה או להסיר אותה.
הגדרות להציג את ההעדפות שלכם או להפעיל או לכבות את הזיכרון.

יישום הלקוח לא יכול למחוק דבר לצמיתות, לפתוח קישורים ציבוריים, לחבר או לנתק אפליקציות, או לשנות הגדרות ניהול או חיוב.

אישור שינויים

הפעולות של יישום הלקוח כפופות לאותם כללים שחלים בכל מקום ב-Dvina:

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

הערה

אם יישום לקוח לא יכול לבקש מכם אישור, Dvina לא מבצעת את השינוי דרכו. בצעו את השינוי באפליקציית Dvina במקום זאת, או השתמשו ביישום לקוח שיכול לבקש אישור.

הגישה שלכם והכללים של החברה שלכם

יישום הלקוח פועל בשמכם, עם הגישה וההרשאות שיש לכם ב-Dvina:

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

חיבור באמצעות מפתח API במקום OAuth

בתוכנית Enterprise, יישום לקוח יכול להתחבר באמצעות אסימון גישה אישי במקום כניסה לחשבון. השתמשו באפשרות הזו עבור יישום לקוח שלא יכול להיכנס באמצעות OAuth, או עבור סקריפט.

  1. פתחו את ההגדרות ובחרו גישה ל-API.
  2. תחת אסימוני גישה אישיים, בחרו יצירת אסימון.
  3. הזינו שם, בחרו את הגישה ומתי תוקפו יפוג, ואז בחרו יצירת אסימון.
  4. תחת העתקת האסימון שלכם, העתיקו את האסימון. זו הפעם היחידה שבה הוא מוצג.

בחרו את הגישה שיישום הלקוח צריך:

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

שלחו את האסימון בכותרת Authorization, אחרי Bearer. ב-Claude Code, למשל:

claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"

ביישום לקוח אחר, הוסיפו את אותה כותרת במקום שבו אפשר להגדיר כותרות עבור שרת MCP.

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

למידע נוסף על אסימונים, ראו גישה ל-API.