الوثائق

خادم MCP

يلزم استحقاق مناسب للحساب

يتاح الوصول إلى MCP فقط عندما يكون مشمولًا بالفعل في الاستحقاق الحالي لحساب Savebase المسجّل دخوله.

يتيح Savebase بروتوكول سياق النموذج (MCP) كي يتمكن مساعدوك بالذكاء الاصطناعي من البحث في إشاراتك المحفوظة وقراءتها. اسأل Claude أو ChatGPT أو Cursor سؤالًا مثل "ماذا حفظت عن التدريب بالكيتل بيل؟" وسيبحث في مكتبتك مباشرة.

نظرة عامة

MCP معيار مفتوح يتيح لتطبيقات الذكاء الاصطناعي الاتصال بمصادر بيانات خارجية. يوفر Savebase نقطة نهاية HTTP متوافقة مع MCP تمنح مساعدك الذكي وصولًا للقراءة فقط إلى إشاراتك المرجعية ومجلداتك ووسومك.

لاستخدام ChatGPT، ثبّت المنشور إضافة Savebase. بالنسبة إلى Claude وCursor وVS Code وعملاء MCP الآخرين، استخدم عنوان الخادم هذا:

text
https://mcp.savebase.space/mcp

تدخل بحسابك كأي تطبيق، دون مفاتيح API أو رموز لنسخها. وصول MCP للقراءة فقط؛ لا يضيف أو يعدّل أو يحذف شيئًا.

المتطلبات

  • حساب Savebase يتضمن استحقاقه الحالي الوصول عبر MCP
  • إضافة Savebase المنشورة لـ ChatGPT أو عميل MCP مثل Claude أو Cursor أو VS Code

Claude ‏(الويب، سطح المكتب، الهاتف)

1

فتح موصلات Claude

في claude.ai أو تطبيق سطح المكتب، انتقل إلى الإعدادات ← الموصلات.
2

إضافة موصّل مخصص

انقر إضافة موصّل مخصص، وسمّه Savebase، والصق https://mcp.savebase.space/mcp.
3

الاتصال وتسجيل الدخول

انقر إضافة ← اتصال، وسجّل الدخول بحساب Savebase ووافق. أصبحت أدوات Savebase متاحة الآن في محادثاتك.

يعمل على الهاتف أيضًا

يمكن استخدام موصّل بعيد أُضيف على claude.ai في Claude لنظامي iOS وAndroid، مع أنه لا يمكن إضافة خوادم جديدة مباشرة من Claude Mobile. راجع ما تنشره Anthropic في ملاحظات دعم MCP البعيد الحالية.

Claude Code

1

إضافة الخادم

شغّل التالي في الطرفية. احذف --scope user إذا أردته في المشروع الحالي فقط.
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

مصادقة

شغّل Claude Code ونفّذ /mcp. تُفتح نافذة متصفح — سجّل الدخول ووافق.
3

تحقق

تشغيل claude mcp list. ينبغي أن يظهر Savebase على أنه متصل.

Cursor

1

افتح إعدادات MCP

انتقل إلى الإعدادات ← MCP ← إضافة خادم جديد، أو عدّل ~/.cursor/mcp.json مباشرةً.
2

إضافة خادم Savebase

أضف الإدخال أدناه. لاحظ عدم وجود headers كتلة؛ تتم المصادقة في المتصفح.
json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

أعد التحميل وامنح الإذن

أعد تحميل Cursor. يظهر الخادم باعتباره بحاجة إلى تسجيل الدخول؛ انقر عليه وسجّل الدخول وامنح الموافقة.

مهم لمستخدمي Cursor

اختر دائمًا HTTP كنوع الخادم، لا SSE. احذف أي إدخال SSE قديم وأعد إضافته HTTP ثم أعد تشغيل Cursor.

ChatGPT

1

افتح ملحق Savebase

زر الموقع الرسمي صفحة إضافة Savebase في ChatGPT.
2

التثبيت وتسجيل الدخول

اختر زر الإضافة لتثبيت Savebase. عند الطلب، سجّل الدخول بحسابك ووافق على وصول للقراءة فقط إلى المكتبة.
3

استخدم Savebase في محادثة

ابدأ محادثة ChatGPT Work جديدة واستدعِ Savebase باستخدام @Savebase، أو اختره من أداة كتابة الرسائل عندما تريد من ChatGPT البحث في مكتبتك.

لا يلزم إعداد للمطورين

تحل الإضافة العامة محل وضع المطور القديم وإعداد MCP المخصص لـ ChatGPT. يبقى رابط خادم MCP أعلاه للعملاء الآخرين المتوافقين.

VS Code

1

إضافة الخادم

افتح لوحة الأوامر وشغّل MCP: إضافة خادم، اختر HTTP، والصق https://mcp.savebase.space/mcp.
2

أو عدّل الإعدادات مباشرةً

إضافة هذا إلى .vscode/mcp.json في مساحة عملك:
json
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

تسجيل الدخول

شغّل الخادم من عرض MCP. ستفتح نافذة متصفح للدخول؛ وافق لتظهر الأدوات في وضع الوكيل في Copilot Chat.

إدارة التطبيقات المتصلة

يظهر كل تطبيق تسجّل الدخول إليه ضمن الإعدادات ← خادم MCP ← التطبيقات المتصلة، مع تاريخ توصيله وآخر مرة قرأ فيها مكتبتك. انقر على قطع الاتصال لإلغاء الوصول فورًا.

ما الذي يمكن للتطبيق رؤيته

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

يرسل Savebase البيانات فقط عندما يدفع طلبٌ المساعد المتصل للاستعلام من خادم MCP؛ ولا يرسل مكتبتك للتطبيقات في الخلفية أو يستخدمها لتدريب نموذج Savebase. بعد وصولها للمساعد، تسري شروط مزوده للخصوصية واستخدام البيانات. راجع سياسة خصوصية Savebase للقائمة الكاملة لما يمكن أن يتلقاه تطبيق متصل.

متقدم: رمز وصول يدوي

بعض عملاء MCP القدامى لا يدعمون الدخول بالمتصفح ويحتاجون رمزًا في ترويسة. لهم، افتح الإعدادات ← خادم MCP ← متقدم، وأدخل تسمية، وانقر على إنشاء رمز. يبدأ رمز الوصول بـ sb- ويبقى صالحًا حتى تلغيه.

json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

أمان الرموز

لا يخزّن Savebase رمزك الخام؛ بل تجزئة SHA-256 فقط. يُعرض مرة واحدة عند إنشائه، فانسخه فورًا. ألغِه متى شئت من الإعدادات ← خادم MCP.

الأدوات المتاحة

بعد الاتصال، يستطيع مساعدك بالذكاء الاصطناعي الوصول إلى هذه الأدوات التسع. جميعها للقراءة فقط؛ ولا يمكن لأي منها تغيير شيء في مكتبتك.

الأداةالوصف
search_bookmarksابحث بكلمات مفتاحية في العناوين والمحتوى والملاحظات والمؤلفين والروابط ونصوص الفيديو. يمكنك حصر البحث في حقول وتصفية النتائج بالمنصة أو المجلد أو الوسم أو المنشئ أو الفترة أو وجود نص فيديو.
list_bookmarksتصفّح دون كلمة مفتاحية، مع فلاتر اختيارية للمنصة والمجلد والوسم والتاريخ
list_recent_bookmarksما حفظته اليوم أو هذا الأسبوع أو الشهر أو خلال آخر 7 أو 30 يومًا
get_bookmarkتفاصيل كاملة لإشارة مرجعية واحدة، مع وسومها ومجلداتها ومعاينة للنص المفرغ
get_bookmark_transcriptاقرأ تفريغ فيديو طويل على أجزاء، دون تحميله كله دفعة واحدة
find_bookmark_by_urlتحقق مما إذا كان الرابط محفوظًا بالفعل. يتجاهل معلمات التتبع مثل utm_source.
list_foldersاعرض مجلداتك، بما في ذلك مستويات التداخل
list_tagsاعرض جميع وسومك
get_library_statsالإجماليات والتوزيع بحسب المنصة وأكثر المجلدات والوسوم استخدامًا ونشاط الحفظ الأخير

أمثلة على المطالبات

جرّب سؤال مساعدك الذكي مثل:

  • "ماذا حفظت عن التدريب بالكيتل بيل؟"
  • "أرني كل ما حفظته من Reddit الشهر الماضي."
  • "اعثر على الفيديو المحفوظ الذي يشرح فيه أحدهم كيفية إعداد Cloudflare Worker."
  • "هل حفظت هذا الرابط من قبل؟" — الصق رابطًا
  • "اعثر على كل الإشارات المرجعية في مجلد «إلهام التصميم» لدي."
  • "ما المقالات التي أضفت إليها وسم «AI»؟"
  • "أعطني تحليلًا لمكتبتي — الكمية والمصادر وأكثر الوسوم استخدامًا."
  • "لخّص المنشورات التي حفظتها الأسبوع الماضي."

البحث عما قيل في فيديو

إذا فرّغت مقطع فيديو محفوظًا نصيًا، فسيصبح محتواه المنطوق قابلًا للبحث أيضًا. سؤال مثل "كيف أفعل X" قد يعثر على خطوة شرحها شخص بصوته في مقطع حفظته قبل أشهر.

استكشاف الأخطاء

المشكلةالحل
Savebase غير متاح في ChatGPTافتح إضافة Savebase المنشورة، وثبّته، وابدأ محادثة جديدة في ChatGPT Work. لم تعد بحاجة إلى إنشاء تطبيق مخصص في وضع المطوّر.
لا يطلب التطبيق منك تسجيل الدخول أبدًاتأكد من أن الرابط يطابق تمامًا https://mcp.savebase.space/mcp — الخطأ المطبعي يمنع العميل من العثور على خطوة تسجيل الدخول.
ظهور "الوصول عبر MCP غير متاح" أثناء تسجيل الدخولسجّل الدخول بحساب يملك حاليًا حق وصول MCP، أو تواصل مع دعم Savebase إذا اعتقدت أن الصلاحية غير صحيحة.
"انتهت صلاحية هذا الطلب"طلبات التفويض صالحة لمدة 10 دقائق. ابدأ الاتصال مجددًا من تطبيق الذكاء الاصطناعي لديك.
توقف الاتصال عن العملتحقق مما إذا كان التطبيق ما زال يظهر ضمن الإعدادات ← خادم MCP ← التطبيقات المتصلة. إذا انقطع اتصاله، فأعد الاتصال من التطبيق.
يعرض الخادم «errored» في Cursorاحذف إدخال Savebase القديم في إعدادات Cursor ← MCP. أضفه مجددًا باسم النوع: HTTP (وليس SSE)، ثم أعد تشغيل Cursor بالكامل.
الأدوات لا تظهرأعد تشغيل عميل الذكاء الاصطناعي بعد إضافة الإعدادات. تتطلب بعض البرامج إعادة تشغيل كاملة لاكتشاف خوادم MCP الجديدة.
نتائج فارغةتأكد من وجود إشارات مرجعية محفوظة في مكتبة Savebase الخاصة بك. يبحث خادم MCP في بياناتك وحدها.
فقدان رمز يدويتعرض الرموز مرة واحدة فقط. ألغِ القديم من الإعدادات ← خادم MCP ← متقدم وأنشئ جديدًا.

خطوات سريعة للاستعادة

إذا لم تعمل الأمور: (1) افصل Savebase في تطبيق الذكاء الاصطناعي، (2) أزله من الإعدادات ← خادم MCP ← التطبيقات المتصلة، (3) أضف الموصل مجددًا وسجّل الدخول، (4) أعد تشغيل عميل الذكاء الاصطناعي بالكامل.