Brainy SocialBY IS&S

دليل إعداد MCP

اربط Brainy Social بأداة الذكاء الاصطناعي بتاعتك

Brainy Social سيرفر MCP بعيد. أي أداة بتتكلم MCP عن طريق Streamable HTTP تقدر تقرا الـ Brand Brain بتاعك، ولو معاها صلاحية النشر تقدر تعمل منشورات وتجدولها وتتابعها. اختار أداتك تحت وانسخ الإعداد.

19 نوفمبر 2026

رابط سيرفر MCP

https://brainy-social.com/api/mcp

طريقتين للدخول

  • تسجيل الدخول (OAuth): الأداة بتفتح Brainy Social، تسجّل دخولك، تختار مساحة عمل واحدة والصلاحية (قراءة، أو قراءة ونشر) وتدوس سماح. مفيش حاجة تنسخها. الأنسب للأشخاص.
  • مفتاح API للوكلاء: مفتاح bsk_… بيتبعت كـ Authorization: Bearer …. الأنسب للوكلاء اللي بتشتغل لوحدها، ومهام CI، والأدوات اللي مفيهاش تسجيل دخول.

اعمل مفتاح API لوكيل

  1. في Brainy Social افتح قائمة الترس ← الذكاء الاصطناعي وMCP ← سيرفر MCP ← مفاتيح API للوكلاء (للمالكين والمديرين).
  2. سمّي المفتاح باسم الوكيل اللي هيستخدمه، واختار قراءة بس أو قراءة ونشر، ومدة الصلاحية (أو من غير انتهاء).
  3. دوس اعمل مفتاح وانسخه: بيظهر مرة واحدة بس. بنخزن بصمته (hash) بس، والقائمة بتعرض أول حروفه وآخر مرة اتستخدم فيها.
  • المفتاح بيشتغل لمساحة عمل واحدة وبيتصرف باسم الشخص اللي عمله وبصلاحياته الحالية. بيقف لو الشخص ده ساب مساحة العمل أو اتوقف حسابه، أو لما مدته تخلص.
  • تقدر تلغي المفتاح من نفس الصفحة في أي وقت: الوكلاء اللي بتستخدمه بتفقد الوصول فورًا.
  • خلي المفاتيح في مخزن أسرار أو متغير بيئة، وأبدًا مش في مستودع مشترك. الأمثلة تحت فيها مفتاح وهمي، مش مفتاح حقيقي.

Claude (claude.ai وClaude Desktop)

الإعدادات ← Connectors

  1. افتح الإعدادات ← Connectors ← Add custom connector.
  2. الصق رابط سيرفر MCP، ودوس Add وبعدين Connect.
  3. سجّل دخولك في Brainy Social، واختار مساحة العمل والصلاحية، ودوس سماح.

لو عايز تستخدم مفتاح API بدل كده، Claude Desktop بيشغّل السيرفر عن طريق جسر mcp-remote في claude_desktop_config.json:

مفتاح API للوكلاء
{
  "mcpServers": {
    "brainy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://brainy-social.com/api/mcp",
        "--header",
        "Authorization:${BRAINY_AUTH}"
      ],
      "env": {
        "BRAINY_AUTH": "Bearer bsk_EXAMPLE_not_a_real_token"
      }
    }
  }
}

ChatGPT

الإعدادات ← Apps & Connectors

  1. شغّل وضع المطور (developer mode)، وبعدين افتح الإعدادات ← Apps & Connectors ← Create.
  2. الصق رابط سيرفر MCP واختار OAuth كطريقة الدخول.
  3. دوس Connect، وسجّل دخولك في Brainy Social، واختار مساحة العمل والصلاحية، ودوس سماح.

ChatGPT بيتربط بتسجيل الدخول بس. للكود بتاعك استخدم مفتاح API مع واجهة REST أو طلب MCP مباشر.

Claude Code

الطرفية (Terminal)

تسجيل الدخول (OAuth)
claude mcp add --transport http brainy https://brainy-social.com/api/mcp
# then, inside Claude Code: /mcp → brainy → Authenticate

زوّد --scope project عشان تشارك السيرفر في .mcp.json (متحطش مفتاح فيه أبدًا؛ استخدم تسجيل الدخول هناك).

مفتاح API للوكلاء
claude mcp add --transport http brainy https://brainy-social.com/api/mcp \
  --header "Authorization: Bearer bsk_EXAMPLE_not_a_real_token"

Cursor

~/.cursor/mcp.json (أو .cursor/mcp.json في المشروع)

تسجيل الدخول (OAuth)
{
  "mcpServers": {
    "brainy": {
      "url": "https://brainy-social.com/api/mcp"
    }
  }
}

من غير headers، Cursor بيعرض زرار Connect / Needs login لتسجيل الدخول.

مفتاح API للوكلاء
{
  "mcpServers": {
    "brainy": {
      "url": "https://brainy-social.com/api/mcp",
      "headers": {
        "Authorization": "Bearer bsk_EXAMPLE_not_a_real_token"
      }
    }
  }
}

VS Code (وضع الوكيل في GitHub Copilot)

.vscode/mcp.json (أو MCP: Add Server…)

تسجيل الدخول (OAuth)
{
  "servers": {
    "brainy": {
      "type": "http",
      "url": "https://brainy-social.com/api/mcp"
    }
  }
}

مع إعداد مفتاح API، VS Code بيطلب المفتاح مرة واحدة ويحفظه في مخزن الأسرار بتاعه.

مفتاح API للوكلاء
{
  "inputs": [
    {
      "type": "promptString",
      "id": "brainy-api-key",
      "description": "Brainy Social agent API key",
      "password": true
    }
  ],
  "servers": {
    "brainy": {
      "type": "http",
      "url": "https://brainy-social.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:brainy-api-key}"
      }
    }
  }
}

Codex (الـ CLI وإضافة المحرر)

الطرفية، أو ~/.codex/config.toml

تسجيل الدخول (OAuth)
codex mcp add brainy --url https://brainy-social.com/api/mcp
codex mcp login brainy

تسجيل الدخول محتاج متصفح. على جهاز من غير شاشة استخدم مفتاح API: Codex بيبعت قيمة المتغير كـ Bearer token.

مفتاح API للوكلاء
# ~/.codex/config.toml
[mcp_servers.brainy]
url = "https://brainy-social.com/api/mcp"
bearer_token_env_var = "BRAINY_API_KEY"

# in the shell that starts Codex:
export BRAINY_API_KEY=bsk_EXAMPLE_not_a_real_token

Windsurf

~/.codeium/windsurf/mcp_config.json (Cascade ← MCP servers ← View raw config)

تسجيل الدخول (OAuth)
{
  "mcpServers": {
    "brainy": {
      "serverUrl": "https://brainy-social.com/api/mcp"
    }
  }
}

Windsurf بيعمل تسجيل دخول لما الإعداد ميكونش فيه headers. في باقات Teams وEnterprise ممكن الأدمن يحتاج يسمح بسيرفرات MCP البعيدة.

مفتاح API للوكلاء
{
  "mcpServers": {
    "brainy": {
      "serverUrl": "https://brainy-social.com/api/mcp",
      "headers": {
        "Authorization": "Bearer bsk_EXAMPLE_not_a_real_token"
      }
    }
  }
}

أي أداة بتدعم stdio بس (جسر mcp-remote)

ملف إعداد MCP بتاع الأداة

تسجيل الدخول (OAuth)
{
  "mcpServers": {
    "brainy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://brainy-social.com/api/mcp"
      ]
    }
  }
}

mcp-remote بيشتغل على جهازك بـ Node.js، بيكلم أداتك بـ stdio ويكلم Brainy بـ Streamable HTTP. من غير header بيفتح المتصفح لتسجيل الدخول؛ ومع header بيبعت مفتاحك. المفتاح بيتحط في متغير بيئة لأن بعض الأدوات بتقسم الوسائط عند المسافات.

مفتاح API للوكلاء
{
  "mcpServers": {
    "brainy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://brainy-social.com/api/mcp",
        "--header",
        "Authorization:${BRAINY_AUTH}"
      ],
      "env": {
        "BRAINY_AUTH": "Bearer bsk_EXAMPLE_not_a_real_token"
      }
    }
  }
}

وكلاء من غير أداة MCP

السيرفر عبارة عن JSON-RPC عادي فوق HTTPS POST (من غير جلسة): الوكيل يقدر ينادي أي أداة مباشرة بمفتاحه. وللنشر من الكود بتاعك، واجهة REST في دليل المطورين بتاخد نفس المفتاح.

curl -s https://brainy-social.com/api/mcp \
  -H "Authorization: Bearer bsk_EXAMPLE_not_a_real_token" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_brand_prompt","arguments":{"language":"en"}}}'

لو مش بيتربط

  • 401: المفتاح غلط أو اتلغى أو مدته خلصت، أو تسجيل الدخول اتفصل. اعمل مفتاح جديد أو اربط تاني.
  • 403 "MCP access isn't included in this workspace's Brainy Social plan": الوصول لـ MCP محتاج باقة فيها الميزة دي.
  • أدوات النشر مش ظاهرة: المفتاح أو الربط صلاحيته قراءة بس. اعمل واحد بصلاحية قراءة ونشر.
  • الأدوات اللي شغالة في متصفح على موقع تاني بتترفض (فحص Origin)؛ أدوات سطح المكتب والطرفية والسيرفرات مش بتبعت Origin وشغالة عادي.

ارجع لدليل المطورين