Dvina سرور MCP مخصوص خود را دارد. یک کلاینت MCP مانند Claude Code، ChatGPT یا Cursor را متصل کنید تا آن برنامه بتواند از طرف شما در Dvina جست‌وجو کند، اسناد و حافظهٔ شما را بخواند و یادداشت، کار و یادآوری اضافه کند.
پیش از شروع
به نشانی سرور نیاز دارید:
https://api.dvina.ai/mcp
اگر شرکت شما Dvina را روی سرورهای خودش اجرا می‌کند، از نشانی API اختصاصی Dvina شرکت خود استفاده کنید و /mcp را به انتهای آن اضافه کنید. این نشانی را از مدیر سیستم بخواهید.
سرور از Streamable HTTP استفاده می‌کند. اگر کلاینت از شما می‌خواهد نوع انتقال را مشخص کنید، HTTP را انتخاب کنید.
اتصال کلاینت
Claude Code
در ترمینال، این دستور را اجرا کنید:
claude mcp add --transport http dvina https://api.dvina.ai/mcpClaude Code را اجرا کنید، دستور
/mcpرا اجرا کنید، dvina را انتخاب کنید و وارد Dvina شوید.
ChatGPT
- بخشی از ChatGPT را باز کنید که امکان افزودن سرور MCP را به شما می‌دهد.
- نشانی
https://api.dvina.ai/mcpرا به‌عنوان نشانی سرور وارد کنید و اگر روش ورود را از شما پرسید، OAuth را انتخاب کنید. - وقتی ChatGPT از شما خواست، وارد Dvina شوید.
Cursor
- Open the place where Cursor lets you add an MCP server.
- Add a server named
dvinawith the addresshttps://api.dvina.ai/mcp. - Sign in to Dvina when Cursor asks.
به شناسهٔ کلاینت یا کلید محرمانه نیاز ندارید. کلاینت هنگام اولین اتصال، خودش را در Dvina ثبت می‌کند.
ورود
سرور MCP در Dvina شما را با استفاده از OAuth و در مرورگرتان وارد می‌کند:
- مثل همیشه وارد Dvina شوید.
- اگر عضو بیش از یک فضای کاری هستید، در بخش انتخاب فضای کاری یکی را انتخاب کنید و سپس ادامه را انتخاب کنید. کلاینت فقط در همان فضای کاری کار می‌کند.
- در بخش اعطای مجوز دسترسی، نام برنامه را بررسی کنید و سپس اجازهٔ دسترسی را انتخاب کنید. اگر برنامه را نمی‌شناسید، رد کردن را انتخاب کنید.
اتصال کلاینت برقرار می‌ماند، بنابراین لازم نیست هر بار وارد شوید.
کلاینت چه کارهایی می‌تواند انجام دهد
کلاینت ابزارهای Dvina را می‌بیند و هر وقت درخواست شما به آن‌ها نیاز داشته باشد، از آن‌ها استفاده می‌کند:
| بخش | کارهایی که کلاینت می‌تواند انجام دهد |
|---|---|
| جستجو | هم‌زمان در گفتگوها، اسناد، حافظه و جهان شما جستجو کند. |
| حافظه | فایل‌های حافظهٔ شما را فهرست کند و بخواند، فایل جدیدی اضافه کند یا فایلی را تغییر دهد. |
| جهان | موضوعات شما را فهرست کند، آنچه Dvina دربارهٔ یک موضوع یا هر چیز دیگری می‌داند نشان دهد و فید شما را فهرست کند. |
| اسناد | محتوای کتابخانهٔ شما را فهرست کند، بخواند و در آن جستجو کند؛ یادداشت و پوشه بسازد؛ فایل بارگذاری کند؛ و سندی را جایگزین کند، جابه‌جا کند، تغییر نام دهد یا به سطل زباله منتقل کند. |
| بوم | بوم‌های شما را فهرست کند و بخواند، بومی بسازد یا صفحه‌ای را بازنویسی کند. |
| وظایف و اهداف | وظایف شما را فهرست کند و کارهایی را که انجام داده‌اند بخواند، وظیفه‌ای یا وظیفه‌ای در راستای یک هدف را شروع کند، کار بیشتری به یک وظیفه بسپارد یا آن را متوقف کند. |
| پیام‌های زمان‌بندی‌شده | آن‌ها را فهرست کند، پیام یا یادآوری را برای یک بار یا به‌صورت تکرارشونده زمان‌بندی کند یا یکی را لغو کند. |
| عامل‌ها و مهارت‌ها | عامل‌ها و مهارت‌های شما را فهرست کند و بخواند، عاملی بسازد، مهارتی اضافه کند یا هرکدام را تغییر دهد. |
| پروژه‌ها | پروژه‌های شما را فهرست کند و پوشه و وظایف اخیر یک پروژه را نشان دهد. |
| اشتراک‌گذاری | ببیند چه کسانی به یک مورد دسترسی دارند و دیگران چه چیزهایی با شما به اشتراک گذاشته‌اند، یا به کسی دسترسی بدهد یا دسترسی او را حذف کند. |
| تنظیمات | ترجیحات شما را نشان دهد یا حافظه را روشن یا خاموش کند. |
کلاینت نمی‌تواند چیزی را برای همیشه حذف کند، پیوندهای عمومی را باز کند، برنامه‌ها را متصل یا اتصالشان را قطع کند، یا تنظیمات مدیریت یا صورتحساب را تغییر دهد.
تأیید تغییرات
کارهای کلاینت از همان قواعدی پیروی می‌کنند که در همه‌جای Dvina اعمال می‌شوند:
- خواندن بدون درخواست تأیید انجام می‌شود.
- افزودن چیزی جدید، مثل یادداشت، فایل حافظه یا وظیفه، بدون درخواست تأیید انجام می‌شود. این کار هرگز محتوای موجود را تغییر نمی‌دهد.
- تغییر دادن یا حذف چیزی، مثل انتقال سند به سطل زباله، بازنویسی صفحه‌ای از بوم، توقف وظیفه یا اشتراک‌گذاری یک مورد، ابتدا به تأیید شما نیاز دارد. کلاینت خلاصه‌ای را که خود Dvina از تغییر تهیه کرده نشان می‌دهد و شما آن را تأیید یا رد می‌کنید. اگر رد کنید، چیزی تغییر نمی‌کند.
یادداشت
اگر کلاینت نتواند از شما تأیید بخواهد، Dvina تغییر درخواستی آن را انجام نمی‌دهد. در عوض، تغییر را در برنامهٔ Dvina انجام دهید یا از کلاینتی استفاده کنید که بتواند تأیید بخواهد.
دسترسی شما و قواعد شرکتتان
کلاینت به نمایندگی از شما و با همان دسترسی‌هایی کار می‌کند که برای دیدن محتوا و انجام کارها در Dvina دارید:
- فقط تا زمانی کار می‌کند که عضو فضای کاری باشید و فقط در محدودهٔ مجوزهای نقش شما.
- اگر مدیر شما قابلیتی مثل بارگذاری فایل را خاموش کند، کلاینت هم نمی‌تواند از آن استفاده کند.
- هر چیزی که کلاینت اضافه می‌کند یا تغییر می‌دهد، مانند برنامه، مشمول قواعد حفاظت از داده‌های شرکت شما می‌شود.
- هر چیزی که اضافه می‌کند یا تغییر می‌دهد، در گزارش ممیزی شما به‌عنوان کار دستیار به نمایندگی از شما، همراه با نام کلاینتی که درخواست از آن آمده، ثبت می‌شود.
- کارهای آن جزو مصرف شما حساب می‌شود و در محدودهٔ محدودیت‌های معمول شما قرار دارد.
اتصال با کلید API به‌جای OAuth
در طرح Enterprise، کلاینت می‌تواند به‌جای ورود به حساب، با توکن دسترسی شخصی متصل شود. برای کلاینتی که نمی‌تواند با OAuth وارد شود یا برای یک اسکریپت از این روش استفاده کنید.
- تنظیمات را باز کنید و دسترسی API را انتخاب کنید.
- در بخش توکن‌های دسترسی شخصی، ایجاد توکن را انتخاب کنید.
- یک نام وارد کنید، دسترسی و زمان انقضا را انتخاب کنید، سپس ایجاد توکن را انتخاب کنید.
- در بخش کپی کردن توکن شما، توکن را کپی کنید. توکن فقط همین یک بار نمایش داده می‌شود.
دسترسی موردنیاز کلاینت را انتخاب کنید:
- فقط خواندن: کلاینت فقط ابزارهای خواندن را می‌بیند. می‌تواند در Dvina شما جستجو کند و محتوا را بخواند، اما نمی‌تواند چیزی اضافه کند یا تغییر دهد.
- خواندن و نوشتن: کلاینت همهٔ ابزارها را می‌بیند و تغییرات همچنان، مانند OAuth، به تأیید شما نیاز دارند.
توکن را در هدر Authorization، پس از Bearer ارسال کنید. برای مثال، در Claude Code:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
در کلاینتی دیگر، همین هدر را در جایی اضافه کنید که امکان تنظیم هدرها برای سرور MCP را می‌دهد.
توکن به نمایندگی از شما، در همان فضای کاری که آن را ساخته‌اید و با نقش فعلی شما در آنجا کار می‌کند. برای جایگزین کردن آن، توکن را در بخش توکن‌های دسترسی شخصی باز کنید و تعویض… را انتخاب کنید: توکن جدید جایگزین می‌شود و توکن قبلی بلافاصله از کار می‌افتد. برای غیرفعال کردن آن، لغو… را انتخاب کنید: هر چیزی که از آن استفاده می‌کند بلافاصله از کار می‌افتد.
برای اطلاعات بیشتر دربارهٔ توکن‌ها، دسترسی API را ببینید.