مین مواد پر جائیں

AI ایجنٹس کے لیے MCP

Model Context Protocol (MCP) AI اسسٹنٹس کو ٹولز اور ڈیٹا تک محفوظ، منظم رسائی دینے کے لیے ایک کھلا معیار ہے۔ گلو کوڈ لکھنے کے بجائے، آپ Claude جیسے اسسٹنٹ کو کسی MCP سرور کی طرف اشارہ کرتے ہیں اور یہ دستیاب ٹولز دریافت کر سکتا ہے اور انہیں آپ کی طرف سے کال کر سکتا ہے۔ imatic مصنوعات MCP سرورز ظاہر کرتی ہیں تاکہ کوئی ایجنٹ حقیقی کام کر سکے — دستیابی جانچے اور میٹنگ بک کرے، سروے کے جوابات جمع اور خلاصہ کرے، ایک لائیو پول چلائے — آپ کے اکاؤنٹ کی اجازتوں کا استعمال کرتے ہوئے۔

MCP آپ کو کیا دیتا ہے​

  • ٹول دریافت — اسسٹنٹ سرور سے پوچھتا ہے کہ یہ کیا کر سکتا ہے اور ٹولز کی ایک ٹائپ شدہ فہرست حاصل کرتا ہے، تاکہ آپ کو انٹیگریشنز ہاتھ سے نہ لکھنی پڑیں۔
  • حقیقی اقدامات، صرف چیٹ نہیں — ٹولز آپ کے اصل ڈیٹا کو پڑھتے اور لکھتے ہیں (ان اسکوپس کے اندر جو آپ دیتے ہیں)۔
  • ایک پروٹوکول، کئی مصنوعات — وہی کنکشن پیٹرن Calendar، Survey، اور Voice Portal کے لیے کام کرتا ہے۔

ہر پروڈکٹ کون سے ٹولز ظاہر کرتا ہے​

Calendar​

Calendar ایک پروڈکشن MCP سرور کے ساتھ آتا ہے جس میں 7 ٹولز ہیں:

  • list_event_types — آپ کی پیش کردہ میٹنگ ٹائپس کی فہرست بنائیں۔
  • list_slots — کسی وقت کی ونڈو میں کسی ایونٹ ٹائپ کے لیے کھلے سلاٹس تلاش کریں۔
  • create_booking — کسی مدعو کے لیے ایک سلاٹ بک کریں۔
  • cancel_booking — ایک بکنگ منسوخ کریں۔
  • reschedule_booking — ایک بکنگ کو نئے وقت پر منتقل کریں۔
  • list_bookings — موجودہ بکنگز کی فہرست بنائیں۔
  • get_booking — id کے ذریعے ایک واحد بکنگ پڑھیں۔

یہ Calendar کو ایک AI شیڈولنگ اسسٹنٹ کے لیے قدرتی طور پر موزوں بناتا ہے: یہ آپ کی ایونٹ ٹائپس دریافت کر سکتا ہے، حقیقی دستیابی جانچ سکتا ہے، اور دوہری بکنگ کیے بغیر بک کر سکتا ہے۔ دیکھیں ڈویلپرز کے لیے Calendar۔

Survey​

Survey ایک لائیو MCP سرور POST /mcp پر چلاتا ہے (JSON-RPC 2.0) جس میں فارمز، جوابات، اور پولز کے ساتھ کام کرنے کے لیے 10 ٹولز ہیں:

  • whoami — تصدیق شدہ کالر اور تنظیم کی شناخت کریں۔
  • list_forms — اپنی تنظیم کے فارمز کی فہرست بنائیں۔
  • get_form — ایک واحد فارم کی ساخت پڑھیں۔
  • submit_response — کسی فارم کا جواب جمع کرائیں۔
  • list_responses — کسی فارم کے جوابات کی فہرست بنائیں۔
  • get_response — ایک واحد جواب پڑھیں۔
  • get_response_stats — کسی فارم کے لیے جوابات کے اعداد و شمار جمع کریں۔
  • create_poll — ایک فوری پول بنائیں۔
  • cast_vote — کسی پول میں ووٹ ڈالیں۔
  • live_poll_results — کسی پول کی لائیو گنتی پڑھیں۔

دیکھیں ڈویلپرز کے لیے Survey۔

Voice Portal​

Voice Portal MCP کو دوسری سمت سے دیکھتا ہے: (صرف) ایک MCP سرور ہونے کے بجائے، یہ آپ کو بیرونی MCP سرورز رجسٹر کرنے دیتا ہے تاکہ آپ کے وائس ایجنٹس کسی کال کے دوران ان کے ٹولز استعمال کر سکیں۔ پورٹل میں، کسی سرور کو رجسٹر کرنے، اس کے کریڈینشلز محفوظ کرنے، اس کے فنکشنز دریافت کرنے، اور ان ٹولز کو کسی ایجنٹ سے باندھنے کے لیے Integrations → MCP Servers پر جائیں۔ دیکھیں ایجنٹس کے لیے ٹولز اور MCP۔

ٹرانسپورٹ​

Calendar MCP HTTP اور stdio دونوں کی حمایت کرتا ہے، تاکہ آپ یا تو کوئی دور دراز اسسٹنٹ یا کوئی مقامی اسسٹنٹ جوڑ سکیں؛ Survey MCP صرف HTTP (JSON-RPC) کی حمایت کرتا ہے۔

  • HTTP — اسسٹنٹ HTTPS پر سرور کے /mcp اینڈ پوائنٹ سے جڑتا ہے۔ اسے میزبان شدہ/دور دراز ایجنٹس کے لیے استعمال کریں۔
  • stdio — سرور ایک مقامی پروسیس کے طور پر چلتا ہے جسے اسسٹنٹ لانچ کرتا ہے اور معیاری ان پٹ/آؤٹ پٹ پر بات کرتا ہے۔ اسے مقامی ڈیسک ٹاپ ٹولز کے لیے استعمال کریں۔

تصدیق اور علیحدگی​

کوئی MCP سرور جس کریڈینشل کی توقع کرتا ہے وہ پروڈکٹ پر منحصر ہے:

  • Calendar — ایک اسکوپ شدہ API کلید سے تصدیق کرتا ہے جو mcp اسکوپ رکھتی ہے، جو ایک Bearer ٹوکن کے طور پر بھیجی جاتی ہے۔ کلید کے اسکوپس اب بھی پابند کرتے ہیں کہ ہر ٹول کال کیا کر سکتی ہے، اور کالز کلید کی تنظیم تک محدود ہوتی ہیں۔ Developers → API keys میں ہر ایجنٹ کے لیے ایک مخصوص کلید تیار کریں۔
  • Survey — آپ کے پورٹل JWT (ایک سیشن ٹوکن) سے تصدیق کرتا ہے، جو ایک Bearer ٹوکن کے طور پر بھیجا جاتا ہے۔ ٹوکن کی تنظیم ہر کال کو محدود کرتی ہے، اس لیے ایک ایجنٹ صرف اسی تنظیم کے فارمز اور جوابات دیکھتا ہے۔
  • Voice Portal — آپ کسی Voice MCP سرور کو تصدیق نہیں کرتے؛ بلکہ آپ پورٹل میں بیرونی MCP سرورز رجسٹر کرتے ہیں اور ان کے کریڈینشلز وہاں محفوظ کرتے ہیں (نیچے دیکھیں)۔

ہر صورت میں، کالز اس اکاؤنٹ یا تنظیم تک محدود ہوتی ہیں جس سے کریڈینشل تعلق رکھتا ہے — کوئی ایجنٹ کسی دوسرے گاہک کے ڈیٹا تک نہیں پہنچ سکتا۔

ایجنٹس کو سب سے تنگ کریڈینشل دیں

Calendar کے لیے، ہر ایجنٹ کے لیے صرف اس کے درکار اسکوپس والی ایک مخصوص API کلید بنائیں، اور یاد رکھیں کہ کلید تخلیق کے وقت صرف ایک بار دکھائی جاتی ہے — اسے اسی وقت کاپی کریں۔ اگر کوئی ایجنٹ بدسلوکی کرے یا اس کی کلید لیک ہو جائے، تو اس کلید کو ڈویلپر علاقے میں منسوخ کریں بغیر آپ کی دیگر انٹیگریشنز کو متاثر کیے۔

Claude سے جڑیں​

MCP کلائنٹس (جیسے Claude Desktop) ایک چھوٹا JSON کنفگ پڑھتے ہیں جو انہیں بتاتا ہے کہ کسی سرور تک کیسے پہنچنا ہے۔ نیچے کی شکل وضاحتی ہے — درست اینڈ پوائنٹ اور کوئی بھی فلیگز پروڈکٹ کے ڈویلپر صفحے سے استعمال کریں، اور اس مقصد کے لیے بنائی گئی ایک API کلید چسپاں کریں:

{
  "mcpServers": {
    "imatic-calendar": {
      "url": "https://<calendar-host>/mcp",
      "headers": {
        "Authorization": "Bearer cal_abc123.s3cr3t_keymaterial"
      }
    }
  }
}

کسی مقامی (stdio) کنکشن کے لیے، کلائنٹ کسی URL سے جڑنے کے بجائے سرور کمانڈ لانچ کرتا ہے — دوبارہ، درست کمانڈ کے لیے پروڈکٹ کے ڈویلپر صفحے کی پیروی کریں۔ ایک بار جڑ جانے کے بعد، اسسٹنٹ سے پوچھیں کہ اس کے پاس کون سے ٹولز ہیں؛ Calendar کے لیے اسے اوپر درج سات ٹولز کی اطلاع دینی چاہیے، اور آپ اس سے کہہ سکتے ہیں، مثال کے طور پر، "میرا اگلا فارغ 30 منٹ کا سلاٹ تلاش کرو اور اسے alex@example.com کے لیے بک کرو۔"

متعلقہ​