> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# الاتصال بخادم MCP

> قم بتوصيل أي عميل MCP بخادم MCP من Ayrshare — النقل ونقطة النهاية والمصادقة.

يتيح [خادم MCP](/additional/mcp-action-server) من Ayrshare لوكيل الذكاء الاصطناعي تشغيل واجهة برمجة تطبيقات Ayrshare. تشرح هذه الصفحة كيفية الاتصال به وكيفية عمل المصادقة.

## نقطة النهاية والنقل

يتوفر خادم MCP للإنتاج على:

`https://api.ayrshare.com/mcp`

يستخدم النقل **Streamable HTTP** وهو **عديم الحالة** — لا توجد جلسة يجب الحفاظ عليها بين المكالمات.

## المصادقة

يتم فرض المصادقة بواسطة سلسلة Ayrshare API نفسها التي تشغل REST API.

<ul class="custom-bullets">
  <li>**مطلوب:** `Authorization: Bearer YOUR_API_KEY` — مفتاح API الخاص بحسابك (مفتاح خطة Business للملفات الشخصية والملفات الفرعية).</li>
  <li>**اختياري:** `Profile-Key: YOUR_PROFILE_KEY` — يستهدف ملفًا فرعيًا لكل مكالمة على الاتصال.</li>
  <li>**اختياري لكل مكالمة:** وسيطة أداة `profileKey` — تستهدف ملفًا فرعيًا لمكالمة أداة واحدة.</li>
</ul>

### الأسبقية: الوسيطة تتفوق على الترويسة

عندما تتضمن مكالمة أداة وسيطة `profileKey` **و** يحتوي الاتصال على ترويسة `Profile-Key`، فإن **وسيطة `profileKey` لكل مكالمة تفوز**. يتم استخدام الترويسة فقط عندما لا يتم توفير وسيطة صالحة.

استثناء واحد: في `get_platform_history` و`get_social_network_analytics`، يجب أن يستخدم البحث عن `userId`/`userName` في X/Twitter مفتاح API الخاص بالحساب فقط؛ توفير وسيطة `profileKey` أو ترويسة `Profile-Key` هناك يُرجع الخطأ 400.

<Note>
  يمكن الوصول إلى طريقتي MCP `initialize` و`tools/list` **قبل** المصادقة — فهما تُرجعان البيانات الوصفية فقط ولا تنفذان شيئًا. **يتم مصادقة كل مكالمة أداة.**
</Note>

### أخطاء المصادقة

يُرجع مفتاح غير مصادق أو غير صالح في مكالمة أداة **خطأ Ayrshare 403 / رمز 102** مع الرسالة **"API Key not valid"**. وفقًا لمواصفة MCP، يتم إرجاع أخطاء تنفيذ الأداة داخل النطاق: تحمل نتيجة الأداة `isError: true` وهذه الرسالة، بينما يستجيب نقل MCP نفسه بـ **HTTP 200**. (يعد `403`/`102` خطأ تطبيق Ayrshare، وليس حالة النقل.)

## الاتصال

### الخيار أ: مكوّن Claude Code

إذا كنت تستخدم Claude Code، فقم بتثبيت مكوّن Ayrshare. يجمع تكوين خادم MCP وأمر الإعداد والوكلاء والمهارات وخطاف التأكيد. راجع صفحة [مكوّن Claude Code](/additional/mcp-claude-code-plugin) لخطوات التثبيت الكاملة.

### الخيار ب: أي عميل MCP

لأي عميل MCP يدعم Streamable HTTP، سجل الخادم مباشرة. في Claude Code:

```bash theme={"system"}
claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
```

لاستهداف ملف فرعي عند كل مكالمة، أضف ترويسة `Profile-Key` الاختيارية:

```bash theme={"system"}
claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Profile-Key: YOUR_PROFILE_KEY"
```

<Warning>
  يتم تهيئة اتصال MCP في بداية الجلسة. **أعد تشغيل عميل MCP** بعد تثبيت الخادم أو تغيير المفتاح حتى يسري التكوين الجديد.
</Warning>

## بيانات اعتماد X/Twitter الخاصة بك (BYO)

منذ 31 مارس 2026، تتطلب عمليات X/Twitter عبر Ayrshare بيانات اعتماد OAuth 1.0a الخاصة بك. عندما تستهدف مكالمة أداة X/Twitter، مرر هاتين الترويستين على الاتصال إلى جانب ترويسة `Authorization` (و`Profile-Key` الاختيارية):

| الترويسة                      | الوصف                                                 |
| ----------------------------- | ----------------------------------------------------- |
| `X-Twitter-OAuth1-Api-Key`    | مفتاح API الخاص بك في OAuth 1.0a (Consumer Key)       |
| `X-Twitter-OAuth1-Api-Secret` | سر مفتاح API الخاص بك في OAuth 1.0a (Consumer Secret) |

هذه هي نفس الترويسات المستخدمة من قبل REST API — زوج مفاتيح OAuth 1.0a واحد لكل حساب Ayrshare، يُرسل في كل طلب يستهدف X (ينطبق نفس الزوج على جميع الملفات الفرعية). لا تستخدم Ayrshare OAuth 2.0 هنا. راجع [نظرة عامة على API](/apis/overview#xtwitter-byo-credentials) و[دليل إعداد مفتاح X BYO](/dashboard/connect-social-accounts/x-twitter-byo-keys) للإعداد والسياسة واستكشاف الأخطاء وإصلاحها.

<Warning>
  بدون هذه الترويسات، تُرجع مكالمة أداة X/Twitter الخطأ `419` (`x_credentials_required`).
</Warning>

### الاتصال باستخدام ترويسات BYO

لإعداد بيانات اعتماد X/Twitter BYO من البداية، أضف الخادم مع كلتا ترويستي OAuth 1.0a إلى جانب ترويسة `Authorization` (أضف `Profile-Key` أيضًا إذا كنت تستهدف ملفًا فرعيًا عند كل مكالمة):

```bash theme={"system"}
claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \
  --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET"
```

### إضافة ترويسات BYO إلى اتصال موجود

يتم تثبيت ترويسات الاتصال عند إضافة الخادم، لذا إذا كنت قد اتصلت بالفعل بدون ترويسات BYO، فأزل الخادم وأعد إضافته بالمجموعة الكاملة (أعد تضمين أي ترويسات كنت تستخدمها بالفعل، مثل `Profile-Key`):

```bash theme={"system"}
claude mcp remove ayrshare
claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \
  --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET"
```

أعد تشغيل عميل MCP بعد تغيير الترويسات حتى يسري التكوين الجديد. هل تستخدم مكوّن Claude Code بدلاً من الاتصال الخام؟ راجع [مكوّن Claude Code ← بيانات اعتماد X/Twitter BYO](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials).

## الخطوات التالية

<CardGroup cols={2}>
  <Card title="كتالوج الأدوات" icon="list" href="/additional/mcp-action-tools" horizontal>
    الأدوات الـ 27 مجمعة حسب المجال، مع النطاق والغرض.
  </Card>

  <Card title="مكوّن Claude Code" icon="terminal" href="/additional/mcp-claude-code-plugin" horizontal>
    قم بتثبيت مكوّن Ayrshare لـ Claude Code.
  </Card>
</CardGroup>