ربط عميل MCP

متاح فيFreeProResearch

تشغّل Readsira خادم Model Context Protocol، فتستطيع المساعدات البحث في مكتبتك وقراءتها أثناء عملك. يأتي المساعد بنموذجه الخاص: لا تعيد Readsira سوى المقاطع والمستندات، مع رابط يعود إلى كل مصدر.

عنوان الخادم: https://api.readsira.com/mcp
النقل: Streamable HTTP، بلا حالة (لا توجد جلسة يُحتفظ بها)
المصادقة: تسجيل الدخول بحساب Readsira (OAuth) لـ Claude وChatGPT، أو مفتاح MCP يُرسل بصيغة Authorization: Bearer pk_... لـ Claude Code وCursor وغيرهما من العملاء الذين يقبلون ترويسة. كلاهما يصل إلى الأدوات والنطاقات والحدود نفسها.

Claude (الويب وسطح المكتب)

في Claude، افتح Settings, Connectors واختر Add custom connector.
الصق https://api.readsira.com/mcp وأضفه. يفتح Claude موقع Readsira في متصفحك.
سجّل الدخول إذا طُلب منك ذلك. تعرض شاشة الموافقة ما يطلبه Claude بكلمات واضحة؛ ألغِ تحديد أي شيء لا تريده (الكتابة غير مطلوبة أبداً للبحث)، ثم اختر السماح.
اطلب من Claude "search my Readsira library for sodium-ion storage".

لا يُلصق أي مفتاح. يظهر الاتصال تحت الواجهة البرمجية وMCP في الإعدادات، ضمن القائمة التطبيقات المرتبطة.

ChatGPT

في ChatGPT، افتح Settings, Apps and connectors وأنشئ موصلاً (يجب تفعيل وضع المطور للموصلات المخصصة).
الصق https://api.readsira.com/mcp عنواناً للخادم واختر OAuth للمصادقة.
يفتح ChatGPT موقع Readsira: سجّل الدخول، وراجع الأذونات، واختر السماح.
فعّل الموصل في محادثة واطلب منه البحث في مكتبتك.

تتغير أسماء القوائم في Claude وChatGPT من حين لآخر؛ أما عنوان الخادم وشاشة موافقة Readsira فيبقيان كما هما.

العملاء الذين يستخدمون ترويسة: أنشئ مفتاح MCP

في التطبيق، افتح الإعدادات، واختر الواجهة البرمجية وMCP ثم اختر إنشاء مفتاح MCP.

المفتاح الافتراضي يستطيع القراءة فقط (mcp + read:library). أضف read:projects لاستخدام مشاريعك. أضف write:bookmarks أو write:notes فقط إذا أردت من المساعد حفظ الروابط أو إضافة ملاحظات، وفقط إذا كنت تراجع ما يفعله: قد يحاول النص في صفحات الويب توجيه المساعد. انسخ المفتاح الآن؛ فهو يظهر مرة واحدة.

أضف الخادم إلى عميلك

Claude Code

claude mcp add --transport http readsira https://api.readsira.com/mcp \
  --header "Authorization: Bearer pk_your_key"

ثم اكتب /mcp في جلسة Claude Code: يظهر readsira متصلاً. اطلب "search my Readsira library for sodium-ion storage". هذا الأمر يُختبر على خادم Readsira قبل كل إصدار (يبلّغ claude mcp list أنه متصل).

Cursor

أضف إلى .cursor/mcp.json في مشروعك، أو إلى إعدادات MCP العامة في Cursor:

{
  "mcpServers": {
    "readsira": {
      "url": "https://api.readsira.com/mcp",
      "headers": { "Authorization": "Bearer pk_your_key" }
    }
  }
}

عملاء آخرون يقبلون ترويسة

يعمل أي عميل يدعم خوادم MCP البعيدة عبر Streamable HTTP مع ترويسات مخصصة باستخدام العنوان نفسه وترويسة Authorization نفسها.

العميل الذي يدعم مواصفة تفويض MCP (OAuth 2.1 مع التسجيل الديناميكي للعميل) يحتاج إلى عنوان الخادم فقط: يكتشف تسجيل دخول Readsira من الخادم، كما يفعل Claude وChatGPT.

الأدوات

الأداة	النطاق	ما تفعله
`search_library`	`read:library`	أفضل المقاطع مطابقة مع العنوان وURL وصفحة PDF والطوابع الزمنية للوسائط (`query`، `limit` من 1 إلى 20)
`get_document`	`read:library`	نص مستند على صفحات (`documentId` أو `bookmarkId` أو `url`؛ `offset`، `maxChars`) مع وسومك وملاحظاتك وتظليلاتك
`list_projects`	`read:projects`	مشاريعك، الأحدث نشاطاً أولاً (`status` نشط أو مؤرشف، `limit` من 1 إلى 50)
`get_project_context`	`read:projects`	تعليمات المشروع وقراراته المحسومة وملاحظاته المثبتة ومصادره؛ ومع `query`، أفضل المقاطع من المشروع (`maxChars` حتى 32,000)
`add_bookmark`	`write:bookmarks`	يحفظ URL؛ وحفظ رابط تملكه مسبقاً يعيد `created: false` ويضيف الوسوم فقط. مع `projectId` (ويحتاج أيضاً `write:projects`)، يضيفه كذلك إلى ذلك المشروع
`create_note`	`write:notes`	يضيف ملاحظة إلى أحد عناصرك المحفوظة (`bookmarkId`)، أو يضيف ملاحظة إلى مشروع (`projectId`، و`title` اختياري؛ ويحتاج `write:projects`)؛ وتصبح قابلة للبحث

الأدوات التي لا تسمح بها نطاقات مفتاحك لا تُعرض. يمنح get_project_context المساعد تعليمات المشروع ليتبعها أثناء عمله لأجلك في ذلك المشروع. وعندما يكون السياق أطول من maxChars، تُستبعد المصادر أولاً، ثم المقاطع والملاحظات والقرارات، وتذكر النتيجة truncated: true.

تعود أخطاء الأدوات كنتائج أدوات مع isError: true ورمز: SCOPE_REQUIRED و NOT_FOUND وRATE_LIMITED (مع retryAfterSeconds) وPLAN_REQUIRED وVALIDATION_FAILED و URL_REJECTED، وفي كتابات المشاريع PROJECT_LIMIT_REACHED (عدد العناصر لكل مشروع في الخطة) أو PROJECT_ARCHIVED. وإذا أُوقف البحث بالذكاء الاصطناعي لبقية اليوم، يظل search_library يجيب بمطابقة النص ويذكر degraded: "lexical".

الحدود

Plan	MCP keys	Tool calls per day	Calls per hour per key	Tools
Free	1	100	60	read tools
Pro	10	10,000	600	all
Research	10	25,000	1,200	all

الأيام بتوقيت UTC. سرد الأدوات لا يُحتسب؛ وقراءة مستند طويل تُحتسب مكالمة واحدة لكل 12,000 حرف، والكتابات تُحتسب مكالمتين. جميع حدود الخطط: حدود الخطة.

الإلغاء والمراجعة

يسرد التطبيقات المرتبطة تحت الواجهة البرمجية وMCP في الإعدادات كل تطبيق سمحت له مع أذوناته، ووقت اتصاله ووقت آخر استخدام لمكتبتك. فصل يوقفه فوراً (يُرفض طلبه التالي)؛ ولاستخدامه مجدداً، اربطه مرة أخرى من التطبيق. تصلك رسالة إشعار داخل التطبيق في كل مرة يتصل فيها تطبيق، فيكون أي اتصال غير متوقع مرئياً.

تسرد الصفحة نفسها كل مفتاح مع آخر استخدام له وعميله، وجدول النشاط لكل مكالمة أداة (الوقت والأداة والحالة والعميل وعدد النتائج). لا تسجل Readsira هناك نص بحثك ولا نص ملاحظاتك أبداً. إلغاء يوقف المفتاح فوراً. عند أول استخدام لمفتاح تصلك رسالة إشعار داخل التطبيق تسمّي العميل، فيكون أي استخدام غير متوقع مرئياً.

لمطوري العملاء: تفاصيل OAuth

Readsira خادم التفويض الخاص بها، وتتبع مواصفة تفويض MCP:

ماذا	القيمة
بيانات وصفية للمورد المحمي (RFC 9728)	`https://api.readsira.com/.well-known/oauth-protected-resource/mcp`
بيانات وصفية لخادم التفويض (8414)	`https://api.readsira.com/.well-known/oauth-authorization-server`
التسجيل الديناميكي للعميل (7591)	`POST /oauth/register`؛ عملاء عامون (`none`) أو `client_secret_post` / `_basic`
التفويض	`GET /oauth/authorize`، تدفق الرمز مع PKCE `S256` فقط (`plain` مرفوض)، و`state` مطلوب
الرمز	`POST /oauth/token`: `authorization_code`, `refresh_token`
الإلغاء (7009)	`POST /oauth/revoke`
النطاقات	`read:library` (الافتراضي)، `read:projects`, `write:projects`, `write:bookmarks`, `write:notes`

يحمل الرد 401 من /mcp الترويسة WWW-Authenticate: Bearer resource_metadata="..."، فيستطيع العملاء بدء الاكتشاف من عنوان الخادم.
يجب تسجيل عناوين إعادة التوجيه، وتُطابق مطابقة تامة: https، أو http على 127.0.0.1 أو localhost أو [::1] للتطبيقات الأصلية.
يحمل رد التفويض iss (RFC 9207). تعيش الرموز 60 ثانية وتعمل مرة واحدة.
تعيش رموز الوصول ساعة واحدة. تتبدل رموز التحديث عند كل استخدام؛ وتقديم رمز تحديث مستخدم مرة أخرى يلغي الاتصال بأكمله.
الرموز مخصصة لخادم MCP فقط؛ أما REST API فتقبل مفاتيح API.
التسجيل محدود المعدل لكل عنوان IP، والعملاء المسجلون الذين لا يُستخدمون لمدة 30 يوماً يُزالون.

Claude (الويب وسطح المكتب)​

ChatGPT​

العملاء الذين يستخدمون ترويسة: أنشئ مفتاح MCP​

أضف الخادم إلى عميلك​

Claude Code​

Cursor​

عملاء آخرون يقبلون ترويسة​

العملاء الذين يعتمدون تسجيل الدخول فقط​

الأدوات​

الحدود​

الإلغاء والمراجعة​

لمطوري العملاء: تفاصيل OAuth​

ذو صلة​