الأدلة

خادم MCP

يتصل ChatGPT وClaude وGrok Bot بالعنوان أدناه: تسجّل الدخول إلى سطر وتمنحها الإذن دون نسخ مفتاح. يستخدم Claude Code وCodex وCursor مفتاح وصول كامل. يحصل كل منها على أداة لكل نقطة نهاية، بالمدخلات والفحوص والأخطاء نفسها.
عنوان الاتصال
https://app.satrmail.com/mcp

ChatGPT

  1. 1افتح الإضافات (Plugins) في chatgpt.com/plugins، واضغط + ثم إضافة خادم MCP مخصّص (Add custom MCP server).
  2. 2سمّه Satr، وأدخل https://app.satrmail.com/mcp عنوانًا للخادم، واختر OAuth دون معرّف عميل أو سر. إذا طُلبت طريقة التسجيل، اختر Client ID Metadata Document.
  3. 3حدّد الموافقة على المتابعة (I understand and want to continue)، ثم اضغط إنشاء إضافة (Create as a plugin).
  4. 4ثبّت الإضافة، وسجّل الدخول إلى سطر عند الطلب، ثم اضغط السماح (Allow).
  5. 5في المحادثة، اكتب @ واختر Satr.

تتوفر خوادم MCP المخصّصة في ChatGPT على الويب لمساحات Business وEnterprise وEdu. في Business يضيفها المشرفون والمالكون، وفي Enterprise وEdu يمكن أيضًا للأعضاء الذين يسمح لهم المشرف إضافتها. في Pro يستخدم ChatGPT الأدوات المخصّصة للقراءة فقط حاليًا.

Claude

  1. 1افتح التخصيص ثم الموصلات (Customize › Connectors)، واضغط إضافة موصل مخصّص (Add custom connector).
  2. 2سمّه Satr وأدخل https://app.satrmail.com/mcp. إذا طلب Claude طريقة تعريف نفسه، أبقِ خيار هويته المنشورة (Use Claude's published identity)، ثم اضغط إضافة (Add).
  3. 3اضغط اتصال (Connect)، وسجّل الدخول إلى سطر، ثم اضغط السماح (Allow).
  4. 4يعمل الموصل في claude.ai وتطبيق Claude للحاسوب والهاتف. شغّله أو أوقفه في المحادثة من + ثم الموصلات (Connectors).

في خطتي Team وEnterprise، يضيفه المالك مرة واحدة من Organization settings › Connectors › Add › Custom › Web، ثم يضغط كل عضو Connect ضمن Customize › Connectors. تتيح الخطة المجانية موصلًا مخصّصًا واحدًا.

Grok Bot

  1. 1في المحادثة، اطلب من Grok Bot إضافة خادم MCP المخصّص https://app.satrmail.com/mcp.
  2. 2سجّل الدخول إلى سطر عند الطلب، ثم اضغط السماح (Allow).

Claude Code

الطرفية
claude mcp add --transport http --scope user mailcheap https://app.satrmail.com/mcp \
  --header "Authorization: Bearer $MAILCHEAP_API_KEY"

تضع الصدفة المفتاح في إعدادات Claude Code عند تشغيل الأمر. يجعل --scope user الخادم متاحًا في كل مشروع. شغّل /mcp داخل Claude Code للتحقق من الاتصال.

Codex

~/.codex/config.toml
[mcp_servers.mailcheap]
url = "https://app.satrmail.com/mcp"
bearer_token_env_var = "MAILCHEAP_API_KEY"

يقرأ Codex المفتاح من MAILCHEAP_API_KEY كلما بدأ، لذا صدّره في ملف إعداد الصدفة. لإضافة الخادم نفسه من الطرفية: codex mcp add mailcheap --url https://app.satrmail.com/mcp --bearer-token-env-var MAILCHEAP_API_KEY

Cursor

~/.cursor/mcp.json
{
  "mcpServers": {
    "mailcheap": {
      "url": "https://app.satrmail.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAILCHEAP_API_KEY}"
      }
    }
  }
}

يقرأ Cursor المتغير MAILCHEAP_API_KEY من البيئة التي فُتح منها. إن لم يكن مضبوطًا فيها، ضع المفتاح نفسه بعد Bearer، وأبقِ الملف خارج نظام التحكم بالإصدارات.

لا يمكن التراجع عن الإرسال

تُصنّف الأدوات schedule_campaign, send_campaign, send_campaign_to_more, resume_campaign بأنها غير قابلة للتراجع، وتطلب أوصافها من المساعد تأكيد رغبتك أولًا. يطلب معظم العملاء الإذن قبل تشغيلها. ترسل send_test_email إلى مالك الحساب افتراضيًا، وإذا حُدّدت عناوين أخرى يطلب وصفها من المساعد تأكيدها معك.

التطبيقات المتصلة

يحصل التطبيق الذي تسمح له على صلاحيات مفتاح الوصول الكامل، داخل حسابك فقط. تعرض صفحة مفاتيح API التطبيقات المتصلة وآخر وقت استُخدمت فيه. ألغِ وصول تطبيق هناك فتتوقف رموزه فورًا، ويحتاج إلى طلب إذنك مجددًا للاتصال.

الأدوات

لا يرى مفتاح الاشتراكات فقط سوى add_contact. تجد مدخلات كل أداة ومخرجاتها في مرجع API.

نظرة عامة

النشرات

الفريق

الإشعارات

الحملات

الكتّاب

جهات الاتصال

الشرائح

النطاقات

الصور

مفاتيح API

البروتوكول

الخادم عديم الحالة: لا يحتفظ بجلسات، ويحمل كل طلب مفتاحًا أو رمزًا. يستخدم إصدار 2026-07-28 ويستجيب لعملاء إصدارات 2025 بالطريقة نفسها. يشير /api/mcp إلى الخادم نفسه للعملاء الذين يحتاجون إلى مسار يبدأ بـ /api.

يتبع OAuth مواصفة تفويض MCP. يتلقى الطلب دون بيانات اعتماد حالة 401 تشير إلى /.well-known/oauth-protected-resource/mcp، وخادم التفويض فيه هو https://app.satrmail.com. تعرّف التطبيقات نفسها بوثيقة بيانات العميل، بينما يسجّل Grok Bot، عبر وكلاء Cursor، نفسه بدلًا من ذلك. يسجّل المستخدم الدخول بتدفق رمز التفويض وPKCE، ويحصل التطبيق على رموز مرتبطة بـ https://app.satrmail.com/mcp ضمن النطاق mailcheap:full. تدوم رموز الوصول ساعة، وتُدوّر رموز التحديث وتُبقي الاتصال صالحًا لمدة 90 يومًا بعد آخر استخدام.