/ الدليل / الملعب / Notion
← كل الخوادم ↗ GitHub
● رسمي makenotion 🔑 يتطلب مفتاحك

Notion

بواسطة makenotion · makenotion/notion-mcp-server

امنح وكيلك حق الوصول للقراءة والكتابة إلى قاعدة معارف فريقك — البحث في المواصفات، كتابة الصفحات، عمليات CRUD في قواعد البيانات، كل ذلك في أداة واحدة MCP.

أداة Notion MCP الرسمية. تقرأ الصفحات، وتنشئ الكتل، وتستعلم قواعد البيانات، وتحدث الخصائص. تحول Notion إلى دماغ ثانٍ يمكن لوكيلك البحث فيه والتلخيص والإضافة إليه — الطريقة الأنظف لجعل المستندات الداخلية قابلة للوصول من قبل الذكاء الاصطناعي بدون أنبوب RAG منفصل.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

notion.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

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

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

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

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

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

claude mcp add notion -- npx -y @notionhq/notion-mcp-server

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

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

استخدامات عملية: Notion

اجعل وكيلك يراجع موثقة المتطلبات الخاصة بك بحثاً عن الفجوات

👤 مديرو المنتج، قادة التقنية ⏱ ~15 min intermediate

متى تستخدمه: لقد قمت بصياغة مواصفة وتريد قراءة نقدية قبل مشاركتها مع فريق الهندسة.

المتطلبات الأساسية
  • رمز تكامل Notion الداخلي — notion.so/my-integrations → New integration → انسخ السر
  • صفحة مشاركة مع التطبيق — على الصفحة: ••• → Connections → أضف التطبيق الخاص بك
الخطوات
  1. جلب محتوى الصفحة
    اقرأ صفحة Notion على <URL>. لخص في 5 نقاط ما تقترحه هذه المواصفة.✓ تم النسخ
    → ملخص دقيق بفقرة واحدة — يثبت أن الوكيل فهمه
  2. ابحث عن المناطق غير المواصفة بشكل كافٍ
    اسرد كل مكان تكون فيه المواصفة غامضة: حالات الخطأ المفقودة، السلوك الحدي غير المحدد، الملكية غير الواضحة، عدم وجود خطة تجريس، عدم وجود مقياس نجاح.✓ تم النسخ
    → قائمة الفجوات المرقمة مع المراجع الخاصة بالصفحة
  3. صياغة أسئلة للمراجعة
    حول تلك الفجوات إلى 5-10 أسئلة محددة قد يطرحها مهندس مراجع. أضفها إلى صفحة Notion كقسم جديد 'Open Questions'.✓ تم النسخ
    → تم إضافة كتلة الأسئلة إلى الصفحة

النتيجة: مواصفة أكثر إحكاماً بالإضافة إلى قسم الأسئلة المفتوحة الذي يبدأ المحادثات الصحيحة قبل اجتماع المراجعة.

المزالق
  • الوكيل يختلق تفاصيل غير موجودة في المواصفة — في prompt، أصر على: 'علّم الفجوات فقط؛ لا تختلق حقائق؛ استشهد بالقسم حيث تحدث كل فجوة'
  • المواصفات الطويلة يتم اختصارها عند الجلب — استخدم retrieve_block_children صفحة تلو الأخرى إذا كانت الصفحة تحتوي على كتل كثيرة؛ لا تعتمد على استدعاء get_page واحد
اجمعها مع: linear

توليد صفحة standup يومية تلقائياً من Linear + GitHub

👤 مديرو الهندسة، رؤساء scrum ⏱ ~10 min intermediate

متى تستخدمه: أنت تدير صفحة standup يومية في Notion وتريد ملؤها مسبقاً بنشاط أمس.

المتطلبات الأساسية
  • قاعدة بيانات 'Standups' في Notion — لها خصائص: Date (تاريخ)، Team (تحديد)، Status (rich_text)
الخطوات
  1. جمع نشاط أمس
    من Linear، اسرد المشاكل التي انتقلت إلى Done في آخر 24 ساعة لفريق ENG. من GitHub، اسرد PRs المدمجة من قبل فريقنا.✓ تم النسخ
    → قائمة النشاط الموحدة
  2. بناء محتوى standup
    الصيغة: Wins (شُحن)، In-flight (PRs مفتوحة)، Blockers (مشاكل موسومة بـ 'blocked')، Today's focus (مشاكل قيد التقدم). احتفظ بكل قسم تحت 5 نقاط.✓ تم النسخ
    → قائمة الكتل المنسقة
  3. إنشاء صفحة Notion
    أنشئ صفحة جديدة في قاعدة بيانات Standups. Date = اليوم، Team = ENG، والصق المحتوى كتل منظمة (h2 لكل قسم).✓ تم النسخ
    → عاد URL الصفحة

النتيجة: صفحة standup مملؤة مسبقاً جاهزة للمزامنة الساعة 9 صباحاً، توفر 15 دقيقة من الارتباك.

المزالق
  • أسماء خصائص قاعدة البيانات حساسة لحالة الأحرف ويجب أن تطابق بالضبط — اسرد الخصائص مع retrieve_database قبل التشغيل الأول وترجم مفاتيح دقيقة
اجمعها مع: linear · github

بناء روبوت أسئلة وأجوبة جاهز لـ Slack على مستندات Notion الخاصة بك

👤 قادة العمليات، مديرو الدعم ⏱ ~20 min intermediate

متى تستخدمه: الموظفون الجدد يستمرون في طرح نفس الأسئلة. إجاباتك مكتوبة بالفعل في Notion — فقط غير قابلة للبحث.

المتطلبات الأساسية
  • توثيق الإعداد يعيش في مساحة Notion معروفة — شارك الصفحة الأب مع التطبيق حتى ترث جميع الأطفال الوصول
الخطوات
  1. البحث في مساحة العمل
    ابحث في Notion عن صفحات تطابق: '[سؤال المستخدم]'. أرجع أفضل 5 عناوين صفحة وعناوين URL.✓ تم النسخ
    → قائمة النتائج المرتبة
  2. اقرأ الأكثر صلة
    للمطابقات الـ 2 الأولى، جلب المحتوى الكامل. استشهد بالفقرات التي تجيب على السؤال.✓ تم النسخ
    → اقتباسات حرفية + عناوين URL المصدر
  3. الإجابة مع الاستشهادات
    أجب على سؤال المستخدم في 2-3 جمل، مستند فقط على تلك الاقتباسات. انته مع: 'Source: <url>'. إذا لم تجب المستندات فعلاً، قل ذلك.✓ تم النسخ
    → إجابة مع استشهاد أو صادقة 'ليس في المستندات'

النتيجة: إجابات مستندة تسمح للناس بإيجاد طريقهم الخاصة إلى المستند المصدري — لا مزيد من 'أين X؟' في Slack.

المزالق
  • الوكيل يختلق إجابة معقولة عندما لا تغطي المستندات فعلاً — تعليمات صريحة: 'إذا لم تجب الاقتباسات المسترجعة على السؤال، رد بـ I don't see this in our docs — لا تخمينات'
  • بحث Notion يعتمد على الكلمات الرئيسية، يفتقد المطابقات الدلالية — إذا كانت النتائج رقيقة، امزجها مع مكدس RAG مناسب (ضمّن محتوى Notion في قاعدة بيانات المتجهات)

تحويل ملاحظات الاجتماع إلى مشاكل Linear

👤 قادة التقنية، مديرو المنتج ⏱ ~10 min beginner

متى تستخدمه: لقد أخذت ملاحظات تقريبية أثناء اجتماع في Notion. الآن تحتاج إلى استخراج عناصر الإجراء.

المتطلبات الأساسية
  • Linear MCP مثبت — انظر إلى دليل linear
الخطوات
  1. اقرأ صفحة الاجتماع
    اقرأ صفحة Notion على <URL>. استخرج كل عنصر إجراء — أي شيء صيغ كـ 'X سيفعل Y' أو 'يجب أن نفعل Z'.✓ تم النسخ
    → قائمة مع المالك إن ذُكر
  2. تأكد قبل الإنشاء
    أرِ لي قائمة الإجراءات. لكل واحدة، اقترح عنوان Linear، والفريق، والأولوية. لا تنشئ حتى الآن.✓ تم النسخ
    → جدول التجربة الجافة للمراجعة البشرية
  3. إنشاء العناصر المعتمدة
    أنشئ مشاكل Linear للعناصر 1 و 3 و 5. اربط كل واحدة بصفحة اجتماع Notion.✓ تم النسخ
    → عاد عناوين URL لمشاكل Linear

النتيجة: إجراءات الاجتماع التي يتم تتبعها فعلاً بدلاً من الضياع في صفحة Notion لا يعود أحد إليها.

المزالق
  • الوكيل يعامل كل نقطة إعلامية كإجراء — في prompt: 'فقط العناصر التي لها مالك واضح أو قابل للتسليم — أسقط كل شيء آخر'
اجمعها مع: linear

قم بتدقيق مستندات Notion الخاصة بك بحثاً عن التقادم

👤 قادة المستندات، مهندسو DevEx ⏱ ~20 min intermediate

متى تستخدمه: تنظيف ربع سنوي — ابحث عن المستندات التي لم تُلمس منذ 6 أشهر أو أكثر ومن المحتمل أن تكون خاطئة.

المتطلبات الأساسية
  • صفحة جذر لمنطقة المستندات — على سبيل المثال، /Engineering/Docs — مشارك مع التطبيق
الخطوات
  1. سرد الصفحات الفرعية مع الطوابع الزمنية
    اسرد جميع الصفحات النسلية تحت صفحة 'Engineering Docs'. لكل واحدة: العنوان، URL، last_edited_time، last_edited_by.✓ تم النسخ
    → الجرد الكامل
  2. تصفية الصفحات القديمة
    صفّ الصفحات التي تم تحريرها آخر مرة منذ أكثر من 180 يوماً. اجمع حسب القسم من أعلى مستوى.✓ تم النسخ
    → قائمة قديمة لكل قسم
  3. وسم للمراجعة
    لكل صفحة قديمة، أضف كتلة callout في الأعلى: '⚠ Needs review — last updated <date>. Ping <last-editor> to confirm.'✓ تم النسخ
    → تم تحديث الصفحات مع لافتة المراجعة

النتيجة: منطقة مستندات حيث يكون التقادم مرئياً وليس مخفياً — والمالكون يحصلون على دفعة لتحديث أو حذف.

المزالق
  • بعض الصفحات مقصودة أرشيفية (ADRs، بعد الوفيات) ولا يجب أن تحصل على لافتة — صفّ حسب الوسم أو الأب — استبعد أي شيء تحت /Archive أو موسوم 'historical'

التركيبات

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

notion + linear

قالب مشروع Linear من Notion PRD

اقرأ Notion PRD على <URL>، استخرج القابليات للتسليم، وأنشئ مشروع Linear مطابق مع مشاكل مجمعة حسب الحد الأدنى.✓ تم النسخ
notion + github

حافظ على README متزامن مع وثيقة تصميم Notion

اقرأ صفحة Notion '<API Design>' وحدّث README.md في مستودع api الخاص بنا لمطابقتها — افتح PR مع الفرق.✓ تم النسخ
notion + sentry

انشر تقارير جودة الهندسة الأسبوعية إلى قاعدة بيانات Notion

اسحب إحصائيات خطأ Sentry لهذا الأسبوع لكل مشروع وأنشئ صفحة جديدة في قاعدة بيانات Notion 'Weekly Quality'.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search query, filter?: {property, value} الاكتشاف — ابحث عن صفحات بالكلمة الرئيسية عبر مساحة العمل 1 API call
retrieve_page page_id احصل على بيانات وصفية للصفحة/الخصائص — ليس كتل المحتوى 1 API call
retrieve_block_children block_id, start_cursor? اقرأ محتوى الصفحة الفعلي — استدعِ بشكل متكرر حتى لا يوجد next_cursor 1 API call (may need pagination)
append_block_children block_id, children: Block[] أضف محتوى إلى صفحة أو تحت كتلة محددة 1 API call
update_block block_id, {type}: {...} عدّل نص/محتوى كتلة موجودة في مكانها 1 API call
create_page parent: {database_id}|{page_id}, properties, children? أنشئ صفحة جديدة — تحت صفحة أب أو داخل قاعدة بيانات 1 API call
query_database database_id, filter?, sorts? استعلام منظم — صفّ/رتّب الإدخالات في قاعدة بيانات 1 API call
update_page page_id, properties حدّث خصائص مستوى الصفحة (الحالة، الوسوم، التاريخ) 1 API call
retrieve_database database_id افحص أسماء/أنواع الخصائص قبل الكتابة 1 API call

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

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

حصة API
Notion: متوسط 3 req/sec لكل تطبيق، الانفجارات مسموحة. سيعود 429 بقوة على النطاق.
الرموز لكل استدعاء
500–3000 رمز لكل صفحة حسب عدد الكتل
التكلفة المالية
مجاني — API مضمن في أي خطة Notion
نصيحة
الصفحات التي تحتوي على كتل متداخلة كثيرة مكلفة للقراءة بالكامل. ابحث أولاً، اجلب الصفحات المستهدفة فقط.

الأمان

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

الحد الأدنى من الصلاحيات: read_content
تخزين بيانات الاعتماد: سر التطبيق الداخلي في متغير البيئة NOTION_API_KEY
نقل البيانات الخارجي: جميع الاتصالات إلى api.notion.com
لا تمنح أبدًا: update_content insert_content

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

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

object_not_found

الصفحة موجودة لكن لا تُشارك مع التطبيق الخاص بك. افتح الصفحة → ••• → Connections → أضف التطبيق.

validation_error on create_page

أسماء/أنواع الخصائص في حمولتك لا تطابق مخطط قاعدة البيانات. استدعِ retrieve_database أولاً وانسخ المفاتيح الدقيقة.

429 rate limited

Notion يحد إلى ~3 req/sec. أضف sleep 350ms بين الكتابات أو اجمع عبر append_block_children (أرسل 100 كتلة لكل استدعاء، وليس 100 استدعاء).

Page content looks empty

retrieve_page يرجع البيانات الوصفية فقط — المحتوى موجود في الكتل. استدعِ retrieve_block_children للحصول على النص الفعلي.

البدائل

Notion مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Confluence MCPمنظمتك على Confluence/Atlassian بدلاً من Notionنموذج أذونات أثقل؛ تتجه سير عمل الوكيل إلى أن تكون أبطأ
Obsidian / filesystem MCPقاعدة معارفك عبارة عن ملفات markdown محليةلا توجد مزامنة متعددة المستخدمين أو أذونات، لكن بدون تكلفة API وقراءة فورية

المزيد

الموارد

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

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

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