MCP · التثبيت

اربط وكيل الذكاء الاصطناعي

الصق mcp.busymate.dev مرة واحدة. 454 أداة. بلا مفاتيح API.

نقرة واحدة أو لصقة واحدة

Pick your client

Cursor وVS Code بنقرة واحدة. البقية يلصقون الرابط نفسه ويصرّحون عند أول استخدام.

Claude Code

أضف الخادم من طرفيتك. أول نداء أداة يفتح متصفحك للتصريح.

  1. 01

    شغّل الأمر أدناه في الطرفية — يُضاف افتراضيًا إلى هذا المشروع فقط؛ أضف --scope user لجعله متاحًا في كل مشاريعك.

  2. 02

    يفتح أول استدعاء لأداة متصفحك لتسجيل الدخول والتفويض — وافِق، وسيؤكد Claude Code الاتصال.

الطرفية
bash
# Claude Code — add the server, then authorize in your browser:
claude mcp add --transport http busymate-devtools https://mcp.busymate.dev

التحقق:شغّل claude mcp list (أو /mcp داخل Claude Code) — سيظهر busymate-devtools متصلاً، وستكون جميع أدوات 454 جاهزة للاستدعاء.

Claude.ai & Claude Desktop

Settings → Connectors → Add custom connector، الصق الرابط، انقر Connect، وصرّح في المتصفح. لا ملف لتحريره.

  1. 01

    افتح الإعدادات ← الموصلات، ثم اضغط + واختر إضافة موصل مخصص.

  2. 02

    الصق الرابط أدناه كعنوان URL للخادم البعيد واضغط Add — اترك حقلي OAuth Client ID/Secret فارغين، فـBusymate لا يحتاجهما.

  3. 03

    يفتح Claude متصفحك لتسجيل الدخول — وافِق، وسيظهر الموصل متصلاً.

رابط الموصّل
text
https://mcp.busymate.dev

التحقق:افتح الموصل مرة أخرى — سيسرد جميع أدوات 454، ويمكن لـClaude استدعاءها في منتصف المحادثة.

Cursor
أضف إلى Cursor

نقرة واحدة تضيفه وتصرّح عبر OAuth. أو أضفه يدويًا إلى ~/.cursor/mcp.json (عالمي) أو .cursor/mcp.json للمشروع:

  1. 01

    اضغط Add to Cursor للتثبيت بنقرة واحدة، أو أضف الكتلة أدناه يدويًا إلى ~/.cursor/mcp.json (عام) أو إلى .cursor/mcp.json الخاص بمشروع.

  2. 02

    افتح Cursor Settings → MCP وفعّل الخادم إذا لم يكن مفعّلًا بعد.

  3. 03

    يفتح أول استدعاء لأداة متصفحك للتفويض — يكمل Cursor عملية تبادل OAuth بنفسه، فلا حاجة للصق أي client ID أو secret.

~/.cursor/mcp.json (or .cursor/mcp.json in a project)
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

التحقق:في Cursor Settings → MCP، سيظهر busymate-devtools مفعّلًا، مع عدد الأدوات ظاهرًا بجانبه.

VS Code (Copilot)
ثبّت في VS Code

نقرة واحدة تثبّته في VS Code. أو أضفه يدويًا إلى .vscode/mcp.json لمساحة العمل (المفتاح الجذر هو servers):

  1. 01

    اضغط Install in VS Code للتثبيت بنقرة واحدة، أو أضف الكتلة أدناه إلى .vscode/mcp.json الخاص بمساحة العمل — أو شغّل MCP: Open User Configuration لإضافته لكل مساحات العمل.

  2. 02

    في المرة الأولى، سيسألك VS Code عن الوثوق بالخادم — وافِق، ثم اضغط Start في code lens أعلى الإدخال (أو شغّل MCP: List Servers من لوحة الأوامر).

  3. 03

    يفتح VS Code متصفحك لإجراء تبادل OAuth — سجّل الدخول ووافِق.

.vscode/mcp.json (root key: servers)
json
{
  "servers": {
    "busymate-devtools": {
      "type": "http",
      "url": "https://mcp.busymate.dev"
    }
  }
}

التحقق:شغّل MCP: List Servers من لوحة الأوامر — سيظهر busymate-devtools بحالة Running، مع سرد جميع أدوات 454.

ChatGPT

حيث تتوفر موصّلات وضع المطور: Settings → Connectors → Add، الصق الرابط وصرّح. التوفر يختلف حسب الخطة.

  1. 01

    فعّل موصلات وضع المطوّر — في إعدادات ChatGPT، ابحث عن Developer mode أو Connectors (موضع القائمة الدقيق تغيّر من قبل؛ يتطلب خطة Plus أو Pro أو Business فأعلى، ويمكن لمسؤول مساحة العمل تقييده).

  2. 02

    أضف موصلًا مخصصًا وألصق الرابط أدناه.

  3. 03

    فوّض العملية في تبويب المتصفح الذي يُفتح.

رابط الموصّل
text
https://mcp.busymate.dev

التحقق:سيظهر الموصل متصلاً. اطلب من ChatGPT استخدام أداة من Busymate DevTools، ويجب أن يستدعيها دون أي خطأ.

أي عميل MCP آخر

ناقل Streamable-HTTP قياسي — Continue وCline وZed أو روبوتك الخاص تستخدم الإعداد نفسه. وجّهه إلى الرابط:

  1. 01

    تأكد أن عميلك يدعم نقل Streamable HTTP (لا stdio فقط) ويدعم OAuth 2.1 مع Dynamic Client Registration — معظم العملاء الحاليين يدعمون ذلك.

  2. 02

    وجّهه إلى الرابط أدناه، بصيغة الإعداد التي يتوقعها عميلك — الكتلة تستخدم الصيغة الشائعة mcpServers التي تقرأها معظم العملاء مباشرة.

  3. 03

    وافِق على مطالبة المتصفح عند أول استخدام، تمامًا كما في كل عميل أعلاه.

mcp.json
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

التحقق:سيعيد استدعاء tools/list جميع أدوات 454 بعد أن تُفوّض الوصول.

The handshake

What happens on first connect

The whole OAuth 2.1 flow, demystified — four steps, all standard, no console to visit first.

  1. 01

    Your client registers itself

    Dynamic Client Registration (RFC 7591): the client POSTs its own metadata and receives a client id. There's nothing to create in a console first.

  2. 02

    You authorize in the browser

    A browser window opens on Busymate's own sign-in. You approve once; PKCE protects the code exchange end to end.

  3. 03

    Tools appear

    The client lists the tools and your agent starts calling them — as you, scoped to your role, with destructive tools confirm-gated.

  4. 04

    The token keeps working

    Refresh rotation keeps the grant alive, and the same token also authenticates REST, WebSockets and Edge Functions. Revoke it any time — every call it made is in your audit trail.

كيف يبقى آمنًا

Your account, your rules

الوصول عبر OAuth 2.1 مع التسجيل الديناميكي للعملاء وPKCE — لا مفاتيح ملصوقة ولا سر مشترك. الرمز الوحيد الذي يحصل عليه الوكيل يصادق على كل واجهات Busymate (MCP وREST وWebSockets وEdge Functions) ومقيّد بدورك أنت: لا يستطيع الوكيل إلا ما تستطيعه أنت في لوحة التحكم.

  • مقيّد بصلاحيات RBAC
  • مقيّد بالتأكيد
  • الأسرار محجوبة

OAuth 2.1، بلا مفاتيح

تسجيل ديناميكي للعملاء (RFC 7591) + PKCE (S256) + تدوير رموز التحديث. يصرّح المستخدمون في المتصفح عبر تسجيل دخول Busymate — لا يوجد مفتاح API ليُلصق أو يُسرّب.

مقيّد بدورك

كل نداء تصرّح به قاعدة البيانات نفسها (RBAC). الأدوات المدمرة تطلب تأكيدًا صريحًا، وقيم الأسرار لا تُعاد أبدًا — فهي للكتابة فقط ومحجوبة.

مسجّل للتدقيق بالكامل

كل نداء أداة — كل وكيل، كل إجراء — يسجّل في سجل تدقيق حسابك، فترى دائمًا ما فعله الوكيل باسمك.

اقرأ المزيد: الخصوصيةالشروطنموذج RBAC وسجل التدقيق

الأدوات الـ454

What your agent can drive

إذا استطاع إنسان فعله في الواجهة، استطاع الوكيل فعله عبر MCP.

التقط وافحص المرور

ابحث وافحص ووسِم وصدّر (HAR) ولخّص واحذف الطلبات والاستجابات المُلتقطة — لكل جهاز أو عبر أسطولك كله.

تحكّم بالأجهزة

اسرد وأعد التسمية وفك الاقتران وبدّل VPN وعيّن نوع اتصال أو وجّه خروج جهاز عبر وكيل أمامي.

قُد متصفحًا عن بُعد

تمرير خام لبروتوكول Chrome DevTools — افتح وقيّم والتقط لقطات شاشة ولقطات حالة لمتصفح Chrome على جهاز متصل.

أتمت مزارع الهواتف

أتمتة مزارع أجهزة Android وiOS — نقر وكتابة وسحب وتثبيت وإدارة دورة حياة التطبيقات، مع عرض مرآتي حي.

برمج الطلبات وشكّلها

سكربتات طلب/استجابة معزولة، وقواعد حظر تلقائي، ونقاط توقف، ونطاقات موقوفة — عدّل أو ركّب المرور أثناء الطيران.

أدر المنصة

الأدوار والصلاحيات (RBAC)، وإدارة بيتا TestFlight، والفوترة، وسجل تدقيق قابل للاستعلام، والإشعارات، والمهام، ومساحات العمل، وذاكرة فريق BusyBro.

Troubleshooting

If something looks stuck

The answers below cover every first-connect snag we've actually seen — most are the protocol working as designed.

The endpoint answers 401 in my browser — is it down?

No — that's the spec working. A bare GET on mcp.busymate.dev returns 401 with the OAuth challenge, because the URL is the OAuth resource identifier your client reads to find the sign-in flow. MCP clients proceed from that challenge automatically.

My client lists the tools but every call fails.

Tool discovery is served before authentication; calling anything requires OAuth. Finish the browser authorization your client started (or trigger it again if the token was revoked), then retry the call.

The browser window never opened.

Most clients also print the authorization URL — copy it into any browser. The flow is a normal web sign-in and hands control back to the client when it finishes.

Should I use mcp.busymate.dev or mcp.busymate.net?

Use mcp.busymate.dev for new configs. The older mcp.busymate.net serves the same server permanently and OAuth issues host-matched metadata on whichever host you connected to — existing setups never break.

Claude Code says the server already exists.

Remove the old entry first — claude mcp remove busymate-devtools — then add it again. Your OAuth grant survives; you won't have to re-authorize.

Do I need separate credentials for a bot and my editor?

No. Each client registers itself and gets its own OAuth grant against your account — individually revocable, all acting under your one role, all visible in the audit trail.

Connect in under a minute

أضف mcp.busymate.dev، وصرّح مرة واحدة، ونادِ أيًا من الأدوات الـ454.

Ask your mate