Notion MCP

نظرة عامة

Notion MCP هو خادم Model Context Protocol (MCP) المستضاف رسميًا المقدم من Notion. وهو يمكّن المساعدين والوكلاء الذكاء الاصطناعي من التفاعل بأمان وكفاءة مع مساحات عمل Notion باستخدام معيار MCP المفتوح.

بدلاً من إدارة مفاتيح API أو الاستضافة الذاتية، يتصل المستخدمون عبر OAuth 2.0 البسيط مع PKCE. يعمل الخادم على https://mcp.notion.com/mcp (نقل HTTP قابل للبث الموصى به) و https://mcp.notion.com/sse (النسخة الاحتياطية).

يتم صيانته بنشاط من قبل Notion ومحسنًا لسير عمل الذكاء الاصطناعي الحديث، ليحل محل notion-mcp-server مفتوح المصدر القديم الذي لم يعد تتم صيانته بنشاط.

الميزات الرئيسية

• المصادقة الآمنة عبر OAuth: تحديد نطاقات أذونات دقيقة أثناء الاتصال - لا توجد رموز طويلة الأجل معرضة.
• أكثر من 20 أداة محسنة للذكاء الاصطناعي: تشمل notion-search (عبر مساحة العمل والمصادر المتصلة مثل Slack، Google Drive، Jira)، واستعلامات قاعدة البيانات (محدثة لواجهة برمجة التطبيقات 2025-09-03 مع مصادر البيانات)، وإنشاء الصفحات، وإلحاق الكتل، وتحديث الخصائص، والتعليقات، والمزيد.
• الوصف الثنائي في الوقت الفعلي: قراءة المحتوى الغني (المحول تلقائيًا إلى Markdown لكفاءة الرمز المميز)، وإنشاء/تحديث الصفحات وقواعد البيانات، وإضافة تعليقات.
• بنية تحتية صفرية: مستضافة بالكامل ودائمًا محدثة - لا حاجة لـ Docker أو خوادم أو صيانة.
• دعم البث: نقل حديث لاستجابات أسرع وتجربة وكيل أفضل.
• توافق واسع مع العملاء: دعم أصلي في Claude Desktop، Cursor، VS Code، ChatGPT (مع تعديلات اسم الأداة)، وعملاء MCP مخصصين.

كيفية العمل

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

خيارات الإعداد

• الموصى به: اتصال المعرض بنقرة واحدة أو استيراد الرابط المباشر (https://mcp.notion.com/mcp).
• Claude: claude mcp add --transport http notion https://mcp.notion.com/mcp ثم المصادقة عبر /mcp.
• Cursor: إضافة كخادم MCP عالمي في الإعدادات.
• العملاء المخصصون: اتبع دليل Notion لـ OAuth + PKCE لبناء تكاملاتك الخاصة.

Notion MCP مقابل خادم مفتوح المصدر القديم

مستودع GitHub القديم (makenotion/notion-mcp-server) لا يزال متاحًا ولكن لم يعد تتم صيانته بنشاط. يوصي Notion بشدة بالإصدار المستضاف للأمان، والأداء، وسهولة الاستخدام، والتوافق مع أحدث تغييرات واجهة برمجة التطبيقات.

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

• عمال المعرفة الذين يلخصون الملاحظات وينشئون عناصر عمل تلقائيًا.
• المطورون الذين يشيرون إلى مواصفات/قواعد بيانات Notion مباشرة في Cursor أو Claude أثناء البرمجة.
• الفرق التي تبني وكلاء مستقلين يديرون خطط العمل، والموسوعات الداخلية، والمهام، والتعليقات.
• منشئو المحتوى الذين ينشئون ويحافظون على مستندات حية مع إشارات متقاطعة في الوقت الفعلي.

الأدوات المدعومة (قائمة جزئية)

• notion-search — بحث نصي كامل قوي مع مرشحات.
• عمليات قاعدة البيانات ومصدر البيانات (استعلام، إنشاء، تحديث).
• إدارة الصفحات والكتل (إلحاق، تحديث نص غني).
• التعليقات وسرد مساحة العمل.

يتم تحديث الأدوات باستمرار مع تطور واجهة برمجة التطبيقات (API) لنوتيون.

البدء

قم بزيارة الوثائق الرسمية على developers.notion.com/guides/mcp/mcp لربط أدوات الذكاء الاصطناعي الخاصة بك اليوم.

يمثل Notion MCP المعيار للدمج السلس والآمن بين الذكاء الاصطناعي وأدوات الإنتاجية — وهو بمثابة "USB-C للوكالات الذكاء الاصطناعي" في نظام نوتيون البيئي.