ربط Cursor والعملاء الآخرين

يتحدث كل خادم من GPT Workspace عبر بروتوكول HTTP القابل للبث مع OAuth 2.0، لذا يمكن لأي عميل يدعم خوادم MCP البعيدة استخدامه. الإعداد الوحيد المطلوب هو عنوان URL؛ يكتشف العميل نفسه نقاط نهاية OAuth ويفتح صفحة تسجيل الدخول من Google عند أول استخدام.

افتح Cursor Settings ➤ MCP ثم انقر على Add new global MCP server، أو حرّر ~/.cursor/mcp.json (إعدادات عامة) أو .cursor/mcp.json داخل مشروع:

{
  "mcpServers": {
    "google-sheets": {
      "url": "https://api.gpt.space/servers/google-sheets/mcp"
    },
    "gmail": {
      "url": "https://api.gpt.space/servers/gmail/mcp"
    }
  }
}

احفظ الملف، ثم انقر على Connect أو رابط تسجيل الدخول بجوار الخادم في إعدادات MCP. بعد شاشة موافقة Google، ستظهر الأدوات مع نقطة خضراء.

شغّل MCP: Add Server من لوحة الأوامر، واختر HTTP، ثم الصق عنوان URL واسمًا. أو أضِف إلى .vscode/mcp.json:

{
  "servers": {
    "google-docs": {
      "type": "http",
      "url": "https://api.gpt.space/servers/google-docs/mcp"
    }
  }
}

انقر على Start بجوار الخادم وسجّل الدخول عبر Google عندما يُطلب منك ذلك.

استخدم نفس البنية: إدخال خادم يحتوي على url (بعض العملاء يسمّون الحقل serverUrl أو يتطلبون "type": "streamable-http"). راجع وثائق عميلك لمعرفة المفاتيح الدقيقة.

بعض العملاء يشغّلون أوامر محلية فقط. اربط الخادم البعيد عبر mcp-remote، الذي يدير تدفق OAuth في متصفحك ويحتفظ بالرمز المميز:

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.gpt.space/servers/google-drive/mcp"]
    }
  }
}

استخدم أي حزمة SDK لـ MCP مع نقل HTTP القابل للبث ومزوّد عميل OAuth. يعرض الخادم بياناته الوصفية على:

• https://api.gpt.space/.well-known/oauth-protected-resource/servers/<name>/mcp
• https://api.gpt.space/.well-known/oauth-authorization-server/servers/<name>/mcp

التسجيل الديناميكي للعملاء مدعوم، لذلك لا يحتاج وكيلك إلى معرّف عميل مُسجّل مسبقًا. أي طلب بدون رمز مميز صالح يتلقى استجابة 401 مع ترويسة WWW-Authenticate تشير إلى البيانات الوصفية أعلاه.