الأدلة
خادم MCP
https://app.satrmail.com/mcpChatGPT
- 1افتح الإضافات (Plugins) في chatgpt.com/plugins، واضغط + ثم إضافة خادم MCP مخصّص (Add custom MCP server).
- 2سمّه Satr، وأدخل https://app.satrmail.com/mcp عنوانًا للخادم، واختر OAuth دون معرّف عميل أو سر. إذا طُلبت طريقة التسجيل، اختر Client ID Metadata Document.
- 3حدّد الموافقة على المتابعة (I understand and want to continue)، ثم اضغط إنشاء إضافة (Create as a plugin).
- 4ثبّت الإضافة، وسجّل الدخول إلى سطر عند الطلب، ثم اضغط السماح (Allow).
- 5في المحادثة، اكتب @ واختر Satr.
تتوفر خوادم MCP المخصّصة في ChatGPT على الويب لمساحات Business وEnterprise وEdu. في Business يضيفها المشرفون والمالكون، وفي Enterprise وEdu يمكن أيضًا للأعضاء الذين يسمح لهم المشرف إضافتها. في Pro يستخدم ChatGPT الأدوات المخصّصة للقراءة فقط حاليًا.
Claude
- 1افتح التخصيص ثم الموصلات (Customize › Connectors)، واضغط إضافة موصل مخصّص (Add custom connector).
- 2سمّه Satr وأدخل https://app.satrmail.com/mcp. إذا طلب Claude طريقة تعريف نفسه، أبقِ خيار هويته المنشورة (Use Claude's published identity)، ثم اضغط إضافة (Add).
- 3اضغط اتصال (Connect)، وسجّل الدخول إلى سطر، ثم اضغط السماح (Allow).
- 4يعمل الموصل في claude.ai وتطبيق Claude للحاسوب والهاتف. شغّله أو أوقفه في المحادثة من + ثم الموصلات (Connectors).
في خطتي Team وEnterprise، يضيفه المالك مرة واحدة من Organization settings › Connectors › Add › Custom › Web، ثم يضغط كل عضو Connect ضمن Customize › Connectors. تتيح الخطة المجانية موصلًا مخصّصًا واحدًا.
Grok Bot
- 1في المحادثة، اطلب من Grok Bot إضافة خادم MCP المخصّص https://app.satrmail.com/mcp.
- 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
[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
{
"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.
نظرة عامة
- get_overviewللقراءة فقط
- get_summaryللقراءة فقط
النشرات
- list_newslettersللقراءة فقط
- get_newsletterللقراءة فقط
- create_newsletter
- update_newsletterيمكن تكراره بأمان
- list_themesللقراءة فقط
- get_signup_formللقراءة فقط
- check_newsletter_slugللقراءة فقط
- send_welcome_test_email
- set_website_domainيمكن تكراره بأمان
- check_website_domainيمكن تكراره بأمان
- remove_website_domainلا يمكن التراجع عنهيمكن تكراره بأمان
الفريق
- list_team_membersللقراءة فقط
- invite_team_member
- update_team_memberيمكن تكراره بأمان
- remove_team_memberلا يمكن التراجع عنهيمكن تكراره بأمان
الإشعارات
- list_notificationsللقراءة فقط
- mark_notifications_readيمكن تكراره بأمان
- clear_notificationsلا يمكن التراجع عنهيمكن تكراره بأمان
- preview_summary_emailللقراءة فقط
- send_inbox_check_email
الحملات
- list_campaignsللقراءة فقط
- get_campaignللقراءة فقط
- get_campaign_reportللقراءة فقط
- list_campaign_recipientsللقراءة فقط
- create_campaign
- update_campaignيمكن تكراره بأمان
- delete_campaignلا يمكن التراجع عنهيمكن تكراره بأمان
- duplicate_campaign
- preview_campaignللقراءة فقط
- count_section_readersللقراءة فقط
- send_test_email
- get_campaign_tipsللقراءة فقط
- schedule_campaignلا يمكن التراجع عنهيمكن تكراره بأمان
- unschedule_campaignيمكن تكراره بأمان
- send_campaignلا يمكن التراجع عنه
- send_campaign_to_moreلا يمكن التراجع عنه
- pause_campaignيمكن تكراره بأمان
- resume_campaignلا يمكن التراجع عنه
- update_campaign_archiveيمكن تكراره بأمان
- unpublish_campaignلا يمكن التراجع عنهيمكن تكراره بأمان
- preview_campaign_cleanupللقراءة فقط
الكتّاب
- list_authorsللقراءة فقط
- create_author
- update_authorيمكن تكراره بأمان
- delete_authorلا يمكن التراجع عنهيمكن تكراره بأمان
جهات الاتصال
- list_contactsللقراءة فقط
- search_contactsللقراءة فقط
- get_contactللقراءة فقط
- list_contact_emailsللقراءة فقط
- add_contact
- update_contactيمكن تكراره بأمان
- update_contact_statusلا يمكن التراجع عنهيمكن تكراره بأمان
- update_contacts_statusلا يمكن التراجع عنهيمكن تكراره بأمان
- tag_contactsيمكن تكراره بأمان
- untag_contactsيمكن تكراره بأمان
- delete_contactلا يمكن التراجع عنهيمكن تكراره بأمان
- delete_contactsلا يمكن التراجع عنهيمكن تكراره بأمان
- import_contactsلا يمكن التراجع عنهيمكن تكراره بأمان
- get_importللقراءة فقط
- list_importsللقراءة فقط
- list_left_outللقراءة فقط
- bring_back_contactsيمكن تكراره بأمان
- export_contactsللقراءة فقط
- list_contact_tagsللقراءة فقط
- list_contact_sourcesللقراءة فقط
- list_contact_fieldsللقراءة فقط
- create_contact_field
- delete_contact_fieldلا يمكن التراجع عنهيمكن تكراره بأمان
الشرائح
- list_segmentsللقراءة فقط
- get_segmentللقراءة فقط
- count_segmentللقراءة فقط
- create_segment
- update_segmentيمكن تكراره بأمان
- delete_segmentلا يمكن التراجع عنهيمكن تكراره بأمان
النطاقات
- list_domainsللقراءة فقط
- add_domain
- check_domainيمكن تكراره بأمان
- remove_domainلا يمكن التراجع عنهيمكن تكراره بأمان
الصور
- list_imagesللقراءة فقط
- upload_image
مفاتيح API
- list_api_keysللقراءة فقط
- create_api_key
- revoke_api_keyلا يمكن التراجع عنهيمكن تكراره بأمان
- list_connected_appsللقراءة فقط
- revoke_connected_appلا يمكن التراجع عنهيمكن تكراره بأمان
الفوترة
البروتوكول
الخادم عديم الحالة: لا يحتفظ بجلسات، ويحمل كل طلب مفتاحًا أو رمزًا. يستخدم إصدار 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 يومًا بعد آخر استخدام.