MCP کے ذریعے دوسری ایپس سے Dvina استعمال کریں

Dvina کا اپنا MCP سرور ہے۔ Claude Code، ChatGPT یا Cursor جیسے MCP کلائنٹ کو جوڑیں، تو وہ ایپ آپ کی شناخت سے آپ کے Dvina میں تلاش کر سکتی ہے، آپ کی دستاویزات اور میموری پڑھ سکتی ہے، اور نوٹس، ٹاسکس اور یاددہانیاں شامل کر سکتی ہے۔

شروع کرنے سے پہلے

آپ کو سرور کا پتہ درکار ہے:

https://api.dvina.ai/mcp

اگر آپ کی کمپنی اپنے سرورز پر Dvina چلاتی ہے، تو اپنی کمپنی کے Dvina API پتے کے آخر میں /mcp لگا کر استعمال کریں۔ یہ پتہ اپنے ایڈمن سے پوچھیں۔

سرور Streamable HTTP استعمال کرتا ہے۔ اگر کلائنٹ ٹرانسپورٹ منتخب کرنے کو کہے، تو HTTP منتخب کریں۔

کلائنٹ جوڑیں

آپ کو کلائنٹ ID یا سیکرٹ کی ضرورت نہیں ہے۔ کلائنٹ پہلی بار جڑتے وقت خود کو Dvina کے ساتھ رجسٹر کر لیتا ہے۔

سائن ان کریں

Dvina کا MCP سرور آپ کے براؤزر میں OAuth کے ذریعے آپ کو سائن ان کراتا ہے:

1. Dvina میں معمول کے مطابق سائن ان کریں۔
2. اگر آپ ایک سے زیادہ ورک اسپیس کے رکن ہیں، تو ورک اسپیس منتخب کریں کے تحت ایک منتخب کریں، پھر جاری رکھیں منتخب کریں۔ کلائنٹ صرف اسی ورک اسپیس میں کام کرتا ہے۔
3. رسائی کی اجازت دیں کے تحت ایپ کا نام چیک کریں، پھر رسائی کی اجازت دیں منتخب کریں۔ اگر آپ ایپ کو نہیں پہچانتے، تو انکار کریں منتخب کریں۔

کلائنٹ جڑا رہتا ہے، اس لیے آپ کو ہر بار سائن ان نہیں کرنا پڑتا۔

کلائنٹ کیا کر سکتا ہے

کلائنٹ کو Dvina کے ٹولز دستیاب ہوتے ہیں، اور جب آپ کی درخواست کے لیے ان کی ضرورت ہو تو وہ انہیں استعمال کرتا ہے:

کلائنٹ کسی بھی چیز کو مستقل طور پر حذف نہیں کر سکتا، عوامی لنکس نہیں کھول سکتا، ایپس کو منسلک یا غیر منسلک نہیں کر سکتا، اور منتظم یا بلنگ کی ترتیبات نہیں بدل سکتا۔

تبدیلیوں کی منظوری دیں

کلائنٹ کی کارروائیوں پر وہی اصول لاگو ہوتے ہیں جو Dvina میں ہر جگہ لاگو ہوتے ہیں:

• پڑھنے کی کارروائی آپ سے پوچھے بغیر ہوتی ہے۔
• کوئی نئی چیز، جیسے نوٹ، میموری فائل یا کام، آپ سے پوچھے بغیر شامل کی جاتی ہے۔ اس سے پہلے سے موجود کسی چیز میں کبھی تبدیلی نہیں ہوتی۔
• کسی چیز کو بدلنے یا ہٹانے سے پہلے آپ سے پوچھا جاتا ہے، جیسے کسی دستاویز کو کوڑے دان میں منتقل کرنا، کینوس کے کسی صفحے کو دوبارہ لکھنا، کسی کام کو روکنا یا کوئی آئٹم شیئر کرنا۔ کلائنٹ اس تبدیلی کا Dvina کا اپنا خلاصہ دکھاتا ہے، اور آپ اسے منظور یا مسترد کرتے ہیں۔ جب آپ مسترد کرتے ہیں تو کچھ بھی نہیں بدلتا۔

آپ کی رسائی اور آپ کی کمپنی کے اصول

کلائنٹ آپ کی حیثیت سے کام کرتا ہے، اور Dvina میں صرف وہی چیزیں دیکھ سکتا ہے اور وہی کام کر سکتا ہے جو آپ دیکھ اور کر سکتے ہیں:

• یہ صرف تب تک کام کرتا ہے جب تک آپ ورک اسپیس کے رکن ہیں، اور صرف وہی کام کرتا ہے جن کی آپ کے کردار میں اجازت ہے۔
• اگر آپ کا منتظم کوئی خصوصیت، جیسے فائل اپ لوڈ کرنا، بند کر دے تو کلائنٹ بھی اسے استعمال نہیں کر سکتا۔
• کلائنٹ جو کچھ شامل کرتا ہے یا بدلتا ہے، اس پر آپ کی کمپنی کے ڈیٹا کے تحفظ کے اصول لاگو ہوتے ہیں، بالکل ایپ کی طرح۔
• یہ جو کچھ شامل کرتا ہے یا بدلتا ہے، وہ آپ کے آڈٹ لاگ میں آپ کے لیے اسسٹنٹ کی کارروائی کے طور پر درج ہوتا ہے، اور اس کلائنٹ کا نام بھی درج ہوتا ہے جس سے وہ کارروائی ہوئی۔
• اس کی کارروائیاں آپ کے استعمال میں شمار ہوتی ہیں اور آپ کی معمول کی حدود کے اندر رہتی ہیں۔

OAuth کے بجائے API کلید کے ذریعے منسلک کریں

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 رسائی دیکھیں۔

متعلقہ

• حسبِ ضرورت ایپس اور MCP سرورز
• API رسائی
• dvina کمانڈ استعمال کریں
• ٹیموں کا جائزہ