OpenRouter / Open WebUI | التكاملات

الإعداد

اربط OpenRouter بـ Open WebUI كاتصال متوافق مع OpenAI، ثم أضف Minds كخادم أدوات MCP ‏(Streamable HTTP) باستخدام مفتاح API من Minds كرمز Bearer.

ربط OpenRouter بـ Open WebUI

1. أنشئ مفتاح API من openrouter.ai/keys.
2. في Open WebUI افتح Settings ← Admin ← Connections وانقر + Add Connection ضمن اتصالات OpenAI API.
3. العنوان: https://openrouter.ai/api/v1. مفتاح API: مفتاح OpenRouter الخاص بك.
4. أضف معرّفات النماذج التي تريدها إلى قائمة Model IDs، مثل anthropic/claude-sonnet-5. يعيد OpenRouter آلاف النماذج، لذلك توصي Open WebUI بقائمة سماح وتفعيل Cache Base Model List ‏(توثيق Open WebUI).
5. احفظ، ثم اختر نموذجًا من OpenRouter في محدد النماذج في المحادثة.

إضافة Minds إلى Open WebUI كخادم أدوات MCP

يدعم Open WebUI بروتوكول MCP أصليًا منذ الإصدار v0.6.31، ولا يمكن إضافة خوادم MCP إلا للمسؤولين ‏(توثيق MCP في Open WebUI).

1. أنشئ مفتاح API لـ Minds من الإعدادات ← مفاتيح API (بالصيغة minds_…).
2. في Open WebUI افتح Settings ← Admin ← Integrations وانقر + Add Connection ضمن External Tool Servers.
3. النوع: MCP (Streamable HTTP)، وليس OpenAPI.
4. العنوان: https://getminds.ai/mcp.
5. المصادقة: Bearer، ثم الصق مفتاح minds_…. اختيار Bearer دون مفتاح يرسل ترويسة فارغة يرفضها الخادم.
6. احفظ، ثم فعّل أدوات Minds لنموذجك أو محادثتك. اختر نموذجًا موثوقًا في استدعاء الأدوات الأصلي؛ فالنموذج الضعيف قد يتجاهل الأدوات حتى لو كان الاتصال يعمل.

استخدام Minds عبر واجهة OpenRouter البرمجية

عندما ينفّذ مزوّد النموذج (مثل openai/* عبر OpenRouter) استدعاء MCP من جانب الخادم، لا يمكنه إتمام مصافحة OAuth. يصل الطلب إلى Minds بدون ترويسة Authorization فيعيد الخطأ 401. مرّر بدلًا من ذلك واصف خادم MCP مع حقل headers ثابت:

{
  "type": "mcp",
  "server_label": "minds",
  "server_url": "https://getminds.ai/mcp",
  "headers": {
    "Authorization": "Bearer minds_YOUR_API_KEY"
  }
}

خادم MCP الخاص بـ OpenRouter شيء مختلف

يشغّل OpenRouter أيضًا خادم MCP على https://mcp.openrouter.ai/mcp. يتيح لمساعدي البرمجة الاطلاع على نماذج OpenRouter وأسعارها والأرصدة والتوثيق، ولا يربط Minds ‏(توثيق MCP في OpenRouter).

عنوان خادم MCP

https://getminds.ai/mcp

عرض وثائق MCP الكاملة