المطوّرون

ربط وكيل ذكاء اصطناعي عبر MCP

أعدّ ChatGPT أو Claude أو Hermes أو Grok أو Codex، وتحقق من الاتصال، وتحكّم في إنفاق التحقق.

اختر عميلك

نقطة النهاية: https://mcp.fairvalid.com/mcp. النقل: Streamable HTTP.

اتصل باستخدام مفتاح API أو تسجيل الدخول عبر OAuth. يمكن لاتصالات ChatGPT وClaude وGrok المؤهَّلة استخدام OAuth؛ راجع متطلبات الحساب والدور الخاصة بعميلك أدناه. كما يدعم Codex وClaude Code وHermes الاتصال المباشر بمفتاح API.

بالنسبة إلى العملاء الذين يستخدمون مفاتيح API، أنشئ مفتاح Test باسم مميز في مفاتيح API بصفتك Owner أو Manager لمساحة العمل. واحفظه في بيانات الاعتماد المحمية للعميل أو في إعدادات البيئة الموثّقة. ولا تضع المفتاح أبدًا في موجّه أو وسيطة أداة أو عنوان URL أو إعدادات مُودَعة في المستودع.

يفتح مسار OAuth ‏fairvalid.com لتسجيل الدخول ومنح الموافقة. تختار مفتاح API مباشرًا (Live) موجودًا يغطي الأذونات المطلوبة، وتراجع مساحة العمل المرتبطة به وحدّ الإنفاق الإجمالي له. تمنح الموافقة الأذونات المطلوبة مجتمعةً، ضمن نطاقات ذلك المفتاح. ولا يُطلب منك لصق ذلك المفتاح في عميل الذكاء الاصطناعي. ويؤدي إلغاء المفتاح المحدد إلى إنهاء اتصالاته أيضًا. يستخدم OAuth المفاتيح المباشرة؛ أما لبيئة الاختبار المعزولة فاستخدم اتصالًا يعتمد على مفتاح الاختبار (Test) نفسه مباشرةً.

رُوجعت تعليمات العملاء في 23 أكتوبر 2026. اجتاز بروتوكول MCP المستضاف اختبار القبول في بيئة الإنتاج باستخدام SDK الرسمي. لا يعني ذلك أن كل عميل مذكور قد اختُبر؛ أكمل التحقق من الاتصال في عميلك قبل الاعتماد عليه.

ChatGPT

استخدم إعداد OAuth أدناه. تتطلب اتصالات MCP المخصصة حاليًا ChatGPT Business أو Enterprise/Edu على الويب، مع صلاحية إنشاء إضافات باستخدام MCP. يتطلب Business مسؤولًا أو مالكًا؛ ويمكن لـ Enterprise/Edu تفويض أعضاء محددين.

افتح Plugins، واختر زر الإضافة، ثم Add custom MCP server. لا يتطلب مسار Plugins الحالي تفعيل Developer Mode.
سمِّ الاتصال FairValid وأدخل https://mcp.fairvalid.com/mcp بوصفه نقطة نهاية HTTPS العامة.
اختر OAuth مع التسجيل التلقائي للعميل. تستخدم FairValid تسجيل العميل العام: لا تحتاج إلى تقديم معرّف عميل أو سر عميل. لا تُدخل مفتاح API في أي من الحقلين أبدًا.
أكمل تسجيل الدخول والموافقة في FairValid كما هو موضح أعلاه. راجع تحذير ChatGPT، ثم اختر «إنشاء كمكوّن إضافي» وافحص الأدوات الست المكتشفة.
ثبّت الإضافة، وافتح محادثة جديدة، واكتب @ واختر FairValid. نفّذ فحص الاتصال للقراءة فقط أدناه قبل طلب تحقق فعلي.

الوثائق الرسمية: OpenAI: ربط خادم MCP مخصص · OpenAI: المصادقة عبر OAuth

Claude على الويب وسطح المكتب

استخدم موصِّلًا مخصصًا عن بُعد مع OAuth. هذا هو الاتصال نفسه المرتبط بالحساب على Claude للويب وتطبيق سطح المكتب؛ ويعمل عبر خوادم Anthropic. في خطتَي Team وEnterprise، يضيف مالك (Owner) المؤسسة الموصِّل أولًا. ويمكن أيضًا لأعضاء Enterprise الذين لديهم دور مخصص يدير مكتبات المؤسسة إضافته.

Some organizations have a Request headers beta. For that alternative, choose No sign-in and add a required Authorization header with the full value Bearer <your FairValid API key>. If Request headers is absent, use OAuth or the Claude Code instructions below. The API key is not an OAuth client secret.

افتح Customize ← Connectors ← Add custom connector. بالنسبة إلى المؤسسات المُدارة، يبدأ المالك أو صاحب دور Enterprise المؤهَّل من Organization settings ← Connectors ← Add ← Custom ← Web.
أدخل FairValid وhttps://mcp.fairvalid.com/mcp.
اختر «تسجيل الدخول الآن». إذا ظهر خيار عميل OAuth، فاختر «التسجيل تلقائيًا». اترك حقلَي معرّف العميل وسرّه المسجّلين يدويًا فارغين.
سجّل الدخول على fairvalid.com، وراجع المفتاح المباشر المحدد وأذوناته، ثم وافق على الاتصال. فعّل FairValid من عناصر التحكم في الموصلات ضمن المحادثة.
شغّل فحص الاتصال للقراءة فقط أدناه. لا تستخدم فحص بيئة الاختبار إلا إذا كنت قد اتصلت باستخدام مفتاح Test API عبر Request headers.

الوثائق الرسمية: Anthropic: الموصلات المخصّصة والمصادقة · Anthropic: توفّر الموصلات البعيدة

Claude Code

يدعم Claude Code الاتصال المباشر عبر مفتاح API. اضبط FAIRVALID_API_KEY في البيئة التي تشغّل Claude Code، مستخدمًا مفتاح Test لأول عملية تحقق. أبقِ السر الفعلي خارج ملفات المشروع.

ادمج الإعداد أدناه في ملف ‎.mcp.json الخاص بالمشروع. احتفظ بأي خوادم موجودة. يجب أن يتضمن الملف مرجع متغير البيئة كما هو حرفيًا، لا قيمة المفتاح.
شغّل Claude Code مع إتاحة FAIRVALID_API_KEY. وافق على إعداد MCP الخاص بالمشروع إذا طُلب منك ذلك.
شغّل claude mcp list، ثم افحص /mcp في الجلسة. تأكد من أن FairValid متصل ويعرض ست أدوات، ثم أجرِ فحص بيئة الاختبار أدناه.

{
  "mcpServers": {
    "fairvalid": {
      "type": "http",
      "url": "https://mcp.fairvalid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FAIRVALID_API_KEY}"
      }
    }
  }
}

الوثائق الرسمية: Anthropic: إعداد MCP في Claude Code

Hermes Agent

هذه التعليمات مخصصة لـ NousResearch Hermes Agent. يدعم نقل HTTP البعيد الخاص به ترويسات bearer. تخزّن واجهة سطر الأوامر (CLI) المفتاح في ملف ‎.env الخاص بملفك الشخصي النشط باسم MCP_FAIRVALID_API_KEY، وتحتفظ بمرجع لمتغير البيئة في config.yaml.

شغّل أمر الإضافة أدناه. أجب بنعم عند سؤالك عمّا إذا كانت المصادقة مطلوبة، ثم أدخل مفتاح Test API في المطالبة المخفية API key / Bearer token.
راجع الأدوات المكتشفة وفعّل أدوات FairValid التي تحتاج إليها. يجب أن يتم الاتصال في الإعداد بنجاح؛ فحفظ اتصال معطّل بعد حدوث خطأ لا يُعدّ إعدادًا ناجحًا.
شغّل hermes mcp test fairvalid، ثم ابدأ جلسة جديدة أو شغّل /reload-mcp. أجرِ فحص بيئة الاختبار أدناه. قد يضيف Hermes بادئة اسم الخادم إلى أسماء الأدوات.

hermes mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --auth header

hermes mcp test fairvalid

الوثائق الرسمية: NousResearch: إعداد MCP · NousResearch: فحوصات اتصال MCP · NousResearch: تنفيذ CLI بمصادقة الترويسة

Grok Bot وGrok

لكلٍّ من Grok Bot وGrok.com واجهات إعداد مختلفة. في Grok Bot الشخصي، اطلب من البوت إضافة FairValid باستخدام الطلب أدناه. تعمل هذه الطريقة أيضًا عندما لا تعرض لوحة المعلومات سوى Details وLibrary وComputer، دون قسم Setup.

تُتيح Team Bots أيضًا لمالك الـ Bot أو مديريه الوصول إلى لوحة المعلومات ← الإعداد ← المكونات الإضافية. وتتطلب واجهة الإعداد هذه صلاحية الوصول إلى Team Bot في تطبيق سطح المكتب. ويسجّل كل زميل دخوله بحسابه الخاص عند استخدام OAuth.

يستخدم Grok.com المسار grok.com/connectors ← New Connector ← Custom. أدخل https://mcp.fairvalid.com/mcp وأكمل المصادقة. قد تحتاج فرق Business وEnterprise إلى أن يُهيّئ المسؤول الموصِّل أولًا. هذا اتصال منفصل عن إضافة Grok Bot.

البوت المبني باستخدام xAI API منفصل أيضًا: إذ يضبط مطوّره ترويسات MCP البعيدة في شيفرة الخادم. ولا تزعم هذه التعليمات أن Grok Bot يوفّر حقلًا عامًا لترويسة Authorization.

اطلب من الـ Bot إضافة اتصال Remote HTTPS MCP المخصّص باستخدام الطلب أدناه. وفي حالة Team Bot، يمكن لمالكه أو مديره أيضًا استخدام Setup → Plugins.
When the Bot shows the FairValid authorization card, select Authorize to open OAuth sign-in. Keep API keys out of the request and any server command.
أكمل موافقة FairValid على fairvalid.com. يربط كل عضو في الفريق حسابه الخاص حيثما يلزم ذلك.
اطلب من الـ Bot عرض أدوات FairValid وتشغيل فحص الاتصال للقراءة فقط أدناه. اكتشاف الأدوات وحده لا يثبت اكتمال عملية تحقق.

Add FairValid as a custom Remote HTTPS MCP server at
https://mcp.fairvalid.com/mcp using OAuth.
Show me the sign-in flow, then list its tools.
Do not submit any email verification yet.

الوثائق الرسمية: xAI: إضافات Grok Bot وRemote HTTPS · xAI: الموصلات المخصصة في Grok.com · xAI: خادم MCP البعيد لمطوري API

Codex

استخدم اتصالًا مباشرًا بمفتاح API من Codex. عيّن FAIRVALID_API_KEY في البيئة المتاحة لعملية Codex، مستخدمًا مفتاح اختبار (Test) لأول عملية تحقق. قد لا يرث تطبيق سطح المكتب الذي يتم تشغيله بشكل مستقل بيئة الطرفية لديك.

شغّل الأمر أدناه لتسجيل خادم Streamable HTTP البعيد. يخزّن الأمر اسم متغير البيئة، وليس مفتاح API.
شغّل codex mcp list وابدأ جلسة Codex جديدة حتى تحمّل الاتصال. تأكد من ظهور FairValid ضمن أدوات MCP في الجلسة.
إذا كنت تستخدم تطبيق Codex، فاجعل المتغير متاحًا لمضيف التنفيذ الخاص به، وأعد تشغيل التطبيق أو افتح جلسة جديدة حسب الحاجة. لا تفترض أن نجاح الإعداد عبر CLI قد غيّر بيئة تطبيق قيد التشغيل بالفعل.
أكِّد الأدوات الست المكتشفة وأجرِ فحص بيئة الاختبار أدناه.

codex mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --bearer-token-env-var FAIRVALID_API_KEY

codex mcp list

الوثائق الرسمية: OpenAI: إعداد Codex MCP

تحقّق من الاتصال قبل إرسال العمل

تأكّد من اكتشاف الأدوات الست المدرجة أدناه جميعها. قد يضيف العميل بادئة خاصة به إلى أسماء الأدوات. يؤكد الاكتشاف وجود اتصال، لا نجاح التحقق.

عند استخدام OAuth أو مفتاح Live API، امنح صلاحية الاطلاع على الرصيد، واطلب من الوكيل أولًا استدعاء fairvalid_get_balance دون أي وسائط. لا تستهلك قراءة الرصيد أي رصيد تحقق. لا ترسل أمثلة بيئة الاختبار (sandbox) عبر اتصال مباشر.

عند استخدام مفتاح Test API، اتبع بدلًا من ذلك خطوات التحقق في بيئة الاختبار (sandbox) أدناه. قد يحجز التحقق المباشر الرصيد ويستهلكه؛ لذا اختر عنوانًا مصرّحًا لك بالتحقق منه واطلب الإرسال صراحةً.

إذا فشل الاتصال، فتحقق من أذونات الموصِّل في الحساب، ونقطة النهاية، ومتغيرات البيئة المفقودة، وما إذا كان المفتاح أو التفويض قد أُلغي. وعند ظهور أخطاء الأذونات أو حد الإنفاق، راجع النطاقات الممنوحة أو الحد قبل إعادة المحاولة؛ فاستخدام مفتاح عدم تكرار جديد لا يعالج السبب.

ابدأ بتحقّق تجريبي مجاني في بيئة الاختبار

استخدم مفتاحًا يبدأ بـ fv_test_ واستدعِ fairvalid_verify_email باستخدام المثال أدناه. تُرجع عملية التحقق من عنوان واحد بمفتاح الاختبار نتيجة محاكاة مباشرةً. لا تُجري أي استدعاء لمزوّد الخدمة، ولا تُنشئ أي عملية تحقق فعلية، ولا تستهلك أي أرصدة.

من الأمثلة المحجوزة الأخرى: undeliverable@example.com وrisky@example.com وunknown@example.com وpending@example.com وerror@example.com. حالتا pending وerror محاكاة متعمدة، وليستا فحصًا حقيقيًا لصناديق البريد. ولا توجد مهمة يمكن الاستعلام عنها لمثال pending الخاص بالعنوان الواحد.

{
  "email": "deliverable@example.com",
  "idempotency_key": "agent-demo-2026-10-23"
}

الأدوات والصلاحيات

تأخذ fairvalid_verify_email المعاملين email وidempotency_key. تأخذ fairvalid_submit_job المعاملات emails وidempotency_key والمعامل الاختياري name، لعدد يتراوح من 1 إلى 5,000 عنوان. تتطلب عمليات الإرسال المباشرة نطاق submit.

تأخذ fairvalid_get_job المعامل job_id لقراءة الحالة. تأخذ fairvalid_get_results المعامل job_id والمعاملات الاختيارية cursor وfilter وsearch لقراءة ما يصل إلى 50 نتيجة في كل مرة. تتطلب القراءات المباشرة نطاق read.

تأخذ fairvalid_cancel_job المعامل job_id وتطلب الإلغاء؛ وقد تكتمل الفحوصات الجارية. يتطلب الإلغاء في الوضع المباشر نطاق submit. لا تأخذ fairvalid_get_balance أي معاملات وتتطلب مفتاحًا مباشرًا بنطاق balance. لا يمكن لمفاتيح الاختبار قراءة رصيد مباشر.

تحدد المفاتيح مساحة العمل. لا تقبل الأدوات أي وسيط لمفتاح API أو لمساحة العمل. تنطبق عمليات التحقق من النطاق والإلغاء وحدود الإنفاق وقواعد أرصدة مساحة العمل على MCP تمامًا كما تنطبق على واجهة API للعملاء.

تابع مهمة جارية حتى ظهور نتائجها

عند استخدام OAuth أو مفتاح fv_live_، يُرسل كلٌّ من التحقق الفردي والمجمّع مهامّ غير متزامنة. تعني الاستجابة accepted مع job_id أن العمل قد قُبل، لا أن التحقق من صندوق البريد قد انتهى. يعتمد وقت المعالجة على قائمة الانتظار ومزوّد خدمة التحقق.

لإجراء تجربة لسير عمل المهام في بيئة الاختبار، استدعِ fairvalid_submit_job مع عناوين أمثلة محجوزة. تدعم مهام بيئة الاختبار الحالة والنتائج والإلغاء وإعادة التشغيل دون استدعاءات للمزوّدين أو استهلاك للأرصدة.

أرسل مرة واحدة باستخدام idempotency_key ثابت واحتفظ بقيمة job_id المُعادة.
استدعِ fairvalid_get_job باستخدام قيمة job_id تلك. باعِد بين طلبات الاستعلام الدوري، وأطِل فترات الانتظار تدريجيًا أثناء الأعطال المؤقتة.
استدعِ fairvalid_get_results باستخدام قيمة job_id نفسها. مرّر كل next_cursor مجددًا بوصفه cursor إلى أن تصبح قيمة next_cursor هي null. يحتفظ المؤشر بعامل التصفية والبحث الأصليين.
راجع حالة المهمة وكل نتيجة على حدة. النتائج غير المعروفة وCatch-all والتي لا تزال قيد التحقق ليست دليلًا على صلاحية صندوق البريد.

إعادة المحاولة دون إنشاء أعمال مكررة

تتطلب كلتا أداتي الإرسال قيمة idempotency_key مكوّنة من 8 إلى 128 حرفًا أو رقمًا أو نقطة أو نقطتين رأسيتين أو شرطة سفلية أو واصلة. عند تلقّي استجابة غير مؤكدة، أعد المحاولة باستخدام مفتاح API أو اتصال OAuth نفسه، وقيمة idempotency_key نفسها، ومدخلات دون تغيير. يقتصر نطاق إعادة التنفيذ على مفتاح API الأساسي: فتدوير رمز وصول OAuth يحافظ على تلك الهوية، أما اختيار مفتاح API مختلف وإعادة الإرسال فقد ينشئ تشغيلًا آخر. يُرفض أي تغيير في بيانات المهمة مع مفتاح عدم تكرار مستخدم مسبقًا. استخدم مفتاح عدم تكرار جديدًا فقط عندما تقصد إنشاء تشغيل جديد.

تحقّق من isError قبل قراءة النتيجة. تتضمن الاستدعاءات التي تصل إلى واجهة API الخاصة بالعملاء استجابتها وحالة HTTP في structuredContent؛ أما أخطاء التحقق من الوسائط فقد لا تُرجع سوى محتوى نصي. افحص رمز خطأ API والتزم بأي تلميح لإعادة المحاولة. انتهاء المهلة أو حدوث خطأ مؤقت لا يُثبت أن الإرسال الأصلي لم يتم.

يمكن للمفاتيح المباشرة إنفاق أرصدة مساحة العمل. عيّن حدًا إجماليًا قبل ربط وكيل مستقل: تُحتسب الأرصدة المخصومة والمحجوزة معًا. تستهلك عمليات التحقق المكتملة ذات النتيجة الصالحة أو غير الصالحة رصيدًا واحدًا؛ أما النتائج غير المعروفة، وعناوين Catch-all غير المحسومة، والإخفاقات التقنية فلا يُخصم عنها أي رصيد تحقق في المحصلة.

هل ما زلت بحاجة إلى مساعدة؟

سجّل الدخول لفتح تذكرة دعم خاصة.

التواصل مع الدعم