امنح وكيلك مهمة صغيرة واضحة

اربط عميلًا

أنشئ اتصالًا في صفحة المطورون واختر MCP. نقطة النهاية هي https://<your host>/mcp (تظهر في الصفحة نفسها). لا يحتاج العميل الذي يقبل خادم HTTP مع ترويسات إلا إلى العنوان والرمز:

{
  "mcpServers": {
    "small-world": {
      "url": "https://<your host>/mcp",
      "headers": { "Authorization": "Bearer sw_mcp_..." }
    }
  }
}

تختلف شاشة الإعدادات الدقيقة بحسب العميل. لا يمكن بعد للعملاء الذين لا يستطيعون تسجيل الدخول إلا باستخدام OAuth الاتصال.

إصدارات البروتوكول

• 2026-07-28 (دون حالة): طلب POST /mcp واحد لكل طلب مع MCP-Protocol-Version: 2026-07-28 وMcp-Method، وعند استخدام tools/call مع Mcp-Name. نُفذت server/discover وtools/list وtools/call وresources/list وresources/read.
• التوافق مع 2025-11-25: initialize ثم tools/list وtools/call. لا تُصدر معرفات جلسات، ويجيب GET /mcp بالرمز 405.

الأدوات تعكس API

كل عملية REST أداة باسم sw_<operation>، مثل sw_list_worlds أو sw_publish_world. تتلقى الأداة المدخلات نفسها التي يتلقاها استدعاء REST: معاملات المسار وidempotency_key وif_match عند الحاجة وbody الخاص بالطلب. تعود النتائج بصيغة structuredContent: {data, request_id}، والإخفاقات بصيغة isError: true مع تفاصيل المشكلة نفسها في REST.

لا يعرض tools/list إلا الأدوات التي تسمح بها نطاقات أذونات رمزك، لذا يرى اتصال القراءة فقط أدوات القراءة فقط.

قدم للوكيل تعليمات واضحة

أخبره بالكازا أو النطاقات التي يجوز له التعامل معها وقواعد التصميم التي عليه الحفاظ عليها وما يجب ألا يغيره. اطلب منه قراءة sw_list_capabilities أولًا وعرض خطة عليك قبل الكتابة. يُعاد النص الآتي من الزوار أو المشتركين أو الاستيراد أو الموجزات الاجتماعية موسومًا بـ untrusted_data ولا يُعد تعليمات أبدًا.

ما لا يستطيع الوكيل فعله

• اعتماد خططه بنفسه: يستطيع طلب موافقة، لكن المالك وحده يقررها بعد تسجيل دخول جديد.
• إنفاق المال: يعيد الدفع رابطًا يكمله شخص.
• إرسال بريد إلى الناس: تُحفظ الردود على الاستفسارات كمسودات.
• حذف الكازا والحسابات أو استعادتها.
• الوصول إلى مساحة عمل أخرى: تجيب المعرفات الأخرى بالرمز 404.

عند انتهاء العمل، ألغِ الاتصال من صفحة المطورين. يتوقف عند الطلب التالي.