دليل الربط

اربط مساعدك بمتقن

اختر تطبيقك واتبع خطواته. لا تحتاج إلى تثبيت متقن، ولا إلى حساب فيه.

رابط متقن

https://mutqin.dev/mcp

Claude

في claude.ai وتطبيق Claude على سطح المكتب، أو في Claude Code.

claude.ai وتطبيق سطح المكتب

الربط متاح في كل الخطط، والخطة المجانية تسمح بموصل مخصص واحد فقط. في خطط Team وEnterprise يضيفه مالك المؤسسة من Organization settings ثم Connectors، ثم يضغط كل عضو Connect. وما تضيفه في حسابك يظهر في تطبيق سطح المكتب أيضًا.

  1. افتح Customize، ثم Connectors.
  2. اضغط «+ Add» ثم «Add custom connector».
  3. اكتب الاسم mutqin، وضع الرابط https://mutqin.dev/mcp، ثم اضغط Continue.
  4. راجع إعدادات المصادقة التي يعرضها، ثم اضغط Continue.
  5. في Authentication اختر «No sign in»، ثم اضغط Add.
  6. في المحادثة، افتح + ثم Connectors وفعّل متقن.
الدليل الرسمي (claude.ai وتطبيق سطح المكتب)
الإعداد من سطر الأوامر - للمطورين

Claude Code

  1. نفّذ هذا الأمر في الطرفية، ثم اكتب ‎/mcp داخل Claude Code لتتأكد من الاتصال.
claude mcp add --transport http quran https://mutqin.dev/mcp
الدليل الرسمي (Claude Code)

ChatGPT

من موقع ChatGPT على الويب، في خطط Business وEnterprise وEdu.

ChatGPT على الويب

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

  1. افتح Plugins.
  2. اضغط + ثم «Add custom MCP server».
  3. اكتب الاسم mutqin، ووصفًا إن شئت.
  4. في Connection ضع الرابط https://mutqin.dev/mcp.
  5. اضبط المصادقة على «بلا مصادقة»، فمتقن لا يحتاج إلى تسجيل دخول.
  6. اختر «I understand and want to continue».
  7. اضغط «Create as a plugin»، ثم راجع الأدوات التي اكتشفها ChatGPT.
  8. ثبّت الإضافة، ثم ابدأ محادثة جديدة واكتب @ واختر متقن.

لا تحتاج إلى وضع المطوّر (Developer Mode).

الدليل الرسمي (ChatGPT على الويب)

Gemini

في تطبيق Gemini على الويب، أو في سطر الأوامر.

تطبيق Gemini

تقول Google إن التطبيقات المخصصة متاحة اليوم لمن بلغ 18 عامًا فأكثر في الولايات المتحدة، بحساب Google شخصي لا حساب عمل أو دراسة، مع تفعيل Keep Activity، وبالإنجليزية فقط. فإن لم تكن في الولايات المتحدة فلا يمكنك حاليًا ربط متقن بتطبيق Gemini؛ استخدم سطر الأوامر.

  1. افتح gemini.google.com على الحاسوب، ثم Settings، ثم Connected Apps.
  2. في Custom apps ضع الرابط https://mutqin.dev/mcp (أو اضغط «Add a custom app» إن كان لديك تطبيق مخصص)، ثم Next واتبع التعليمات.
  3. اكتب @ في طلبك واختر متقن. ويعمل بعدها في تطبيق الجوال أيضًا.
الدليل الرسمي (تطبيق Gemini)
الإعداد من سطر الأوامر - للمطورين

Gemini CLI

  1. نفّذ هذا الأمر، ثم اكتب ‎/mcp داخل Gemini CLI لتتأكد من الاتصال.
gemini mcp add --transport http --scope user quran https://mutqin.dev/mcp

أتستخدم Antigravity CLI؟ فاتبع خطواته أدناه.

الدليل الرسمي (Gemini CLI)

Antigravity CLI

  1. أضف هذا إلى الملف ‎~/.gemini/config/mcp_config.json، ثم اكتب ‎/mcp لتتأكد من الاتصال.
{
  "mcpServers": {
    "quran": {
      "serverUrl": "https://mutqin.dev/mcp"
    }
  }
}
الدليل الرسمي (Antigravity CLI)

الخطوة الأخيرة

تأكد أن الربط يعمل

ابدأ محادثة جديدة وأرسل هذا الطلب:

طلب للتجربة

استخدم متقن لجلب تفسير الآية 255 من سورة البقرة، واذكر المصدر.

  • سترى أن المساعد استدعى أداة من أدوات متقن قبل أن يجيب.
  • وفي الجواب نص التفسير مع اسم الكتاب ومؤلفه كما أعادهما متقن.

إن أجاب دون أن يستدعي متقن، فانظر «المساعد أجاب دون أن يستخدم متقن» أدناه.

إن لم يعمل الربط

أكثر ما يقع فيه الناس، وحلّه في سطرين.

لا يظهر متقن في قائمة الموصلات

تأكد أنك حفظت الرابط كما هو: https://mutqin.dev/mcp، ثم أعد تحميل الصفحة. في ChatGPT لا تظهر الخوادم المخصصة إلا في خطط Business وEnterprise وEdu، وقد يلزم أن يضيفه مسؤول مساحة العمل. وفي خطة Claude المجانية موصل مخصص واحد فقط.

المساعد أجاب دون أن يستخدم متقن

فعّل متقن في المحادثة نفسها: في Claude من + ثم Connectors، وفي ChatGPT وGemini اكتب @ واختر متقن. ثم اذكر متقن في طلبك صراحةً، كأن تبدأه بـ«استخدم متقن». والأفضل أن تبدأ محادثة جديدة بعد الربط.

ظهرت رسالة خطأ عند الاتصال

تأكد أن الرابط يبدأ بـ https وينتهي بـ /mcp بلا مسافة أو حرف زائد، وأنك اخترت الربط بلا تسجيل دخول. فإن بقي الخطأ فأخبرنا بما ظهر لك.

راسلنا

هل أحتاج إلى حساب أو مفتاح في متقن؟

لا. متقن لا يطلب تسجيل دخول ولا مفتاحًا، ولهذا تختار في خطوة المصادقة الربط بلا تسجيل دخول.

لا أجد التطبيقات المخصصة في Gemini

تقول Google إنها متاحة حاليًا في الولايات المتحدة فقط، لمن بلغ 18 عامًا فأكثر، بحساب Google شخصي وبالإنجليزية. إن لم يتوفر لك ذلك فاستخدم Gemini CLI من قسم سطر الأوامر في تبويب Gemini.