/ الدليل / الملعب / affine-mcp-server
● مجتمع DAWNCR0W ⚡ فوري

affine-mcp-server

بواسطة DAWNCR0W · DAWNCR0W/affine-mcp-server

وصل Claude بمساحات العمل الخاصة بك في AFFiNE — 87 أداة عبر المستندات وقواعد البيانات والتعليقات والتخزين الثنائي والمستخدمين — مع API token أو ملف تعريف الارتباط أو مصادقة البريد الإلكتروني / كلمة المرور.

يكشف affine-mcp-server عن 87 أداة تغطي بيانات AFFiNE: مساحات العمل والمنظمات والمستندات وقواعد البيانات والتعليقات والسجل والمستخدمين / التوكنات وتخزين البيانات الثنائية. يعمل مع AFFiNE Cloud (باستخدام API token) أو الإصدار ذاتي الاستضافة (يدعم أيضاً مصادقة البريد الإلكتروني / كلمة المرور).

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

affine.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "affine": {
      "command": "npx",
      "args": [
        "-y",
        "affine-mcp-server"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "affine": {
      "command": "npx",
      "args": [
        "-y",
        "affine-mcp-server"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "affine": {
      "command": "npx",
      "args": [
        "-y",
        "affine-mcp-server"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "affine": {
      "command": "npx",
      "args": [
        "-y",
        "affine-mcp-server"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "affine",
      "command": "npx",
      "args": [
        "-y",
        "affine-mcp-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "affine": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "affine-mcp-server"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add affine -- npx -y affine-mcp-server

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: affine-mcp-server

التقط الملاحظات السريعة في AFFiNE من Claude

👤 مستخدمو AFFiNE الذين يستخدمونها كأداة ملاحظاتهم الرئيسية ⏱ ~5 min beginner

متى تستخدمه: أنت في محادثة وتريد التقاط الفكرة الرئيسية في AFFiNE دون تبديل السياق.

المتطلبات الأساسية
  • API token في AFFiNE — AFFiNE Cloud: Settings > Integrations > MCP Server
الخطوات
  1. ابحث عن مساحة العمل
    اسرد مساحات عملي في AFFiNE. أريد أن أكتب في 'Personal'.✓ تم النسخ
    → قائمة مساحات العمل
  2. إنشاء مستند
    أنشئ مستنداً جديداً بعنوان '2026-04-14 meeting notes' مع المحتوى [paste]. ضعه تحت /Meetings.✓ تم النسخ
    → تم إنشاء المستند + URL

النتيجة: ملاحظات في AFFiNE دون مغادرة الدردشة.

المزالق
  • حظر مصادقة البريد الإلكتروني / كلمة المرور على Cloud بواسطة Cloudflare — استخدم API token على Cloud؛ البريد الإلكتروني / كلمة المرور على الإصدار ذاتي الاستضافة فقط

أضف صفاً إلى قاعدة بيانات AFFiNE من إشارة خارجية

👤 العاملين في المعرفة الذين يستخدمون قواعد بيانات AFFiNE كـ CRM / متتبع خفيف الوزن ⏱ ~10 min intermediate

متى تستخدمه: تريد أن يصل كل مشترك في النشرة الإخبارية من بريد إلكتروني إلى قاعدة البيانات 'Contacts' AFFiNE الخاصة بك.

الخطوات
  1. اسرد قواعد البيانات
    أظهر لي قواعد البيانات في مساحة عملي 'Work'.✓ تم النسخ
    → قائمة قواعد البيانات
  2. أضف صفاً
    إلى قاعدة البيانات 'Contacts'، أضف صفاً: name='Jane Doe', email='[email protected]', source='Newsletter', date=today.✓ تم النسخ
    → تم إضافة الصف مع UUID

النتيجة: AFFiNE كـ CRM خفيف الوزن يعتمد على LLM.

المزالق
  • يجب أن تطابق أنواع الحقول مخطط قاعدة البيانات — احصل على المخطط أولاً، طابق الأنواع. التواريخ غالباً تحتاج إلى سلاسل ISO-8601.

ابحث عبر مساحات العمل في AFFiNE وملخص النتائج

👤 مستخدمو AFFiNE المتقدمون الذين لديهم عدة مستندات ⏱ ~10 min beginner

متى تستخدمه: تتذكر أنك كتبت عن X في مكان ما لكن لا تتذكر أين.

الخطوات
  1. ابحث
    ابحث عبر مساحات عملي عن 'series A process'. اسرد أفضل 10 مستندات مع مقطع.✓ تم النسخ
    → نتائج المستندات مع الفقرات الهامة
  2. ملخص
    حمّل أفضل 3 مستندات وملخص النقاط الرئيسية + أي تناقضات.✓ تم النسخ
    → ملخص عبر المستندات

النتيجة: المعرفة المؤسسية المستخلصة من ملاحظاتك الخاصة.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

التقط المحتوى في AFFiNE

ملخص هذا الفيديو وحفظه في قاعدة البيانات 'Talks Notes' الخاصة بي في AFFiNE.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_workspaces تنقل عبر بيانات AFFiNE 1 API call
search_documents workspace_id, query, limit? ابحث عن المستندات حسب النص 1 API call
create_document workspace_id, title, content, parent_id? أضف مستنداً جديداً 1 API call
update_document doc_id, content | title عدّل المستندات الموجودة 1 API call
add_database_row database_id, fields: obj إدخال البيانات المنظمة 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
حدود خطة AFFiNE
الرموز لكل استدعاء
محتويات المستندات متنوعة جداً — قم بالقص حسب القسم حيث أمكن
التكلفة المالية
مجاني على AFFiNE ذاتي الاستضافة؛ Cloud لديه خطط مدفوعة
نصيحة
فضّل search_documents على القوائم + التصفية في الكود.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: API token محدود لمساحة العمل حيث أمكن
تخزين بيانات الاعتماد: متغير بيئة AFFINE_API_TOKEN؛ لا تقم بالالتزام أبداً
نقل البيانات الخارجي: بيانات AFFiNE الخاصة بك إلى مزود LLM
لا تمنح أبدًا: مصادقة ملف تعريف الارتباط على جهاز مشترك — ملفات تعريف الارتباط مكافئة لجلسة المستخدم

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

الأخطاء الشائعة وحلولها

401 / API token غير صالح

أعد إنشاء على Settings > Integrations > MCP Server. ألصق الرمز الجديد في متغير البيئة.

لا يمكن العثور على مساحة العمل

ارتباك بين Server-backed و local-only. فقط مساحات العمل المدعومة من الخادم يمكن الوصول إليها.

تحقق: افتح واجهة AFFiNE؛ هل تمت مزامنة مساحة العمل مع السحابة؟
رفضت قاعدة البيانات الصف — عدم توافق نوع الحقل

احصل على المخطط أولاً، طابق الأنواع. التواريخ غالباً تحتاج إلى سلاسل ISO-8601.

البدائل

affine-mcp-server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Notion MCPتستخدم Notion بدلاً من AFFiNEمنتج مختلف؛ نظام بيئي أكثر نضجاً
Obsidian MCPأنت مكرس بالكامل لملفات Obsidian markdownمحلي أولاً؛ فلسفة مختلفة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills