/ الدليل / الملعب / monday.com
← كل الخوادم ↗ GitHub
● رسمي mondaycom 🔑 يتطلب مفتاحك

monday.com

بواسطة mondaycom · mondaycom/mcp

إدارة لوحات وعناصر وتحديثات ومجموعات monday.com باللغة الطبيعية — إنشاء المهام وتغيير الحالة وجعل التقارير دون النقر 30 مرة.

خريطة MCP الرسمية من monday.com تربط API GraphQL من monday بالأدوات. إنشاء/تحديث العناصر وتغيير قيم الأعمدة ونشر التحديثات والتنقل عبر المجموعات والاستعلام عن اللوحات باستخدام عوامل التصفية. يعمل مع الرموز الشخصية أو OAuth؛ قم بتحديد الصلاحيات بدقة — يمكن للوصول الكتابي إعادة كتابة لوحتك بالكامل.

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

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

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

عرض مباشر

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

monday.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "monday",
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "monday": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mondaydotcomorg/monday-api-mcp"
        ]
      }
    }
  }
}

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

claude mcp add monday -- npx -y @mondaydotcomorg/monday-api-mcp

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

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

استخدامات عملية: monday.com

توليد ملخص يومي لاجتماع التقرير من لوحة المشروع تلقائياً

👤 قادة الفريق الذين يجرون اجتماعات التقرير على monday.com ⏱ ~15 min beginner

متى تستخدمه: تريد 'ما الذي تحرك أمس، ما الذي يعيقه، ما الذي يستحق اليوم' دون التمرير اليدوي للوحة.

المتطلبات الأساسية
  • رمز API من monday — monday.com → avatar → Developers → My Access Tokens
  • معرّف اللوحة — عنوان URL يحتوي على /boards/<board_id>
الخطوات
  1. سحب العناصر المحدثة في آخر 24 ساعة
    اسرد العناصر على اللوحة <id> حيث updated_at > yesterday. عرض الاسم والحالة والمالك وتاريخ الاستحقاق.✓ تم النسخ
    → قائمة النشاط الأخير
  2. تقسيم حسب الحالة
    جمّع هذه حسب قيمة عمود الحالة: Done / Working / Stuck / To Do. عرض الأعداد ومن يملك كل عنصر Stuck.✓ تم النسخ
    → ملخص 4 مجموعات واضح
  3. تنسيق اجتماع التقرير
    تنسيق اجتماع تقرير من 10 أسطر: moved-to-Done (العدد)، started-Working (العدد)، عناصر Stuck مع إشارات المالك @، العناصر المستحقة اليوم.✓ تم النسخ
    → ملخص يمكن نسخه بسهولة

النتيجة: ملخص اجتماع تقرير يمكنك لصقه في Slack أو LINE في 30 ثانية.

المزالق
  • يتضمن التصفية حسب updated_at تغييرات قيمة العمود وتحديثات العنصر الفرعي — مزعج — أضف استعلام activity_logs مُصفّى لتغييرات الحالة أو المالك فقط
اجمعها مع: line-bot · ms-teams

استيراد 500 عنصر دفعة واحدة إلى لوحة من ملف CSV

👤 مديرو المشاريع الذين يبدأون مشروعاً جديداً بمهام مدرجة مسبقاً ⏱ ~25 min intermediate

متى تستخدمه: لديك جدول Google / CSV للمهام وتريد وضعها على لوحة monday مع ملء الأعمدة الصحيحة.

المتطلبات الأساسية
  • ملف CSV بأعمدة تطابق اللوحة — يجب أن تطابق أسماء الرؤوس تقريباً أعمدة اللوحة: name, status, owner_email, date
الخطوات
  1. فحص مخطط اللوحة المستهدفة
    صِف اللوحة <id>: كل عمود مع معرّفه والعنوان والنوع والقيم المسموحة.✓ تم النسخ
    → كتالوج الأعمدة
  2. ربط CSV بـ column_values
    بناءً على رؤوس CSV [الصق]، أنتج تعيين معرّفات أعمدة monday. علّم أي صفوف CSV بحالات غير موجودة في المجموعة المسموحة.✓ تم النسخ
    → التعيين + تقرير التحقق
  3. إنشاء العناصر على دفعات
    أنشئ هذه العناصر على دفعات من 25 مع create_item + قيم الأعمدة المعيّنة. توقف إذا فشلت 3 استدعاءات متتالية.✓ تم النسخ
    → جميع itemIds؛ أي فشل مع أرقام الصفوف

النتيجة: جميع 500 عنصر على اللوحة مع الملك والحالة وتاريخ الاستحقاق معبأة مسبقاً.

المزالق
  • شكل JSON لقيمة العمود يختلف حسب نوع العمود — من السهل إرسال حمولة غير صحيحة — احصل دائماً على نوع العمود أولاً؛ تستخدم الحالة {label:'...'}, التاريخ يستخدم {date:'YYYY-MM-DD'}, الأشخاص يستخدمون {personsAndTeams:[{id,kind}]}
  • تدخل حدود المعدل في ~60 عنصر/دقيقة — توقف بين الدفعات؛ يعود monday 429 التي يعرضها MCP — أضف توقفاً لمدة 2 ثانية
اجمعها مع: filesystem

نشر تحديث حالة مكتوب بالذكاء الاصطناعي على كل عنصر نشط

👤 فريق العمليات/مدير برنامج المشروع يريد سياق مكتوب على كل عنصر قيد المعالجة ⏱ ~30 min intermediate

متى تستخدمه: نهاية الأسبوع — تريد أن يحصل كل عنصر 'Working on it' على تحديث حالة من سطرين تلقائياً.

الخطوات
  1. البحث عن العناصر النشطة
    اسرد العناصر على اللوحة <id> حيث status = 'Working on it'. أدرج الاسم والمالك ونص آخر تحديث.✓ تم النسخ
    → العناصر قيد المعالجة
  2. صياغة تحديث من سطرين لكل عنصر
    لكل عنصر، صِغ تحديث حالة من جملتين بناءً على آخر_تحديث + تغييرات العمود الأخيرة. استخدم نبرة محايدة.✓ تم النسخ
    → المسودات جاهزة للمراجعة
  3. نشر بعد الموافقة
    عرض 3 مسودات في المرة. على 'موافق'، انشر كتحديث على العنصر.✓ تم النسخ
    → تم نشر التحديثات؛ تم تأكيد itemIds

النتيجة: لكل عنصر نشط الآن ملاحظة طازجة لنهاية الأسبوع، لا عمل مزعج للفريق.

المزالق
  • النشر التلقائي بدون مراجعة يمكن أن يحرجك (سياق خاطئ) — ضع دائماً بوابة للنشر خلف موافقة بشرية 'موافق' لمدة أسبوع واحد على الأقل
اجمعها مع: github

توليد ملخص محفظة تنفيذي عبر 10 لوحات مشروع

👤 مديرو البرنامج / رؤساء الموظفين ⏱ ~30 min advanced

متى تستخدمه: مراجعة القيادة الأسبوعية: شريحة واحدة تلخص صحة كل مشروع.

الخطوات
  1. تعداد المحفظة
    اسرد اللوحات في المجلد 'Engineering / Projects'. لكل واحدة، عد العناصر حسب الحالة.✓ تم النسخ
    → توزيع الحالة لكل لوحة
  2. حساب درجة الصحة
    لكل لوحة: health = 100 - 5*(عناصر застопленة) - 2*(عناصر متأخرة). علّم < 70 بالأحمر.✓ تم النسخ
    → اللوحة → الصحة + اللون
  3. إنتاج تقرير markdown
    توليد جدول markdown بشاشة واحدة: Board | Health | Stuck | Overdue | Top risk. رتّب حسب الصحة تصاعدياً.✓ تم النسخ
    → جدول جاهز للقيادة

النتيجة: لوحة تحكم محفظة موجزة، قابلة للتكرار أسبوعياً.

المزالق
  • معاني 'застопленة' و'متأخرة' تختلف عبر اللوحات — وحّد أعمدة الحالة أو احتفظ بتجاوزات لكل لوحة في ملف إعداد
اجمعها مع: notion

البحث عن عناصر قديمة وأرشفتها عبر لوحة

👤 أصحاب اللوحة المتعبون من الفوضى ⏱ ~25 min intermediate

متى تستخدمه: نمت اللوحة إلى 1000+ عنصر مع العديد غير المتغيرة لأشهر.

الخطوات
  1. البحث عن العناصر غير المتغيرة
    العناصر على اللوحة <id> غير المحدثة لأكثر من 90 يوم و status != Done. اسرد الاسم والمالك وتاريخ آخر تحديث.✓ تم النسخ
    → قائمة قديمة
  2. اتخاذ قرار لكل عنصر
    عرض القائمة 10 في المرة. لكل واحد: احفظ / أرشِف / أعد التعيين. سأقول حرفاً واحداً لكل عنصر.✓ تم النسخ
    → قرارات الفرز
  3. تنفيذ الأرشفة/النقل
    طبّق: أرشِف عناصر 'a' مع archive_item، أعد تعيين عناصر 'r' للمالك <أنا>، احفظ 'k'.✓ تم النسخ
    → تم تنظيف اللوحة؛ تم حفظ سجل التغييرات

النتيجة: لوحة تعكس الواقع، مع سجل تدقيق لما تم أرشفته ولماذا.

المزالق
  • العناصر المؤرشفة غير مرئية؛ يصعب استعادتها إذا ندمت لاحقاً — كرر اللوحة أولاً كلقطة، أو استخدم الملصقات بدلاً من الأرشفة للاختبار

إنشاء عنصر حادث مع القطع الفنية المرتبطة بعد صفحة Sentry

👤 المهندسون في الخدمة ⏱ ~15 min intermediate

متى تستخدمه: للتو أُغلقت الحادثة؛ تريد عنصر monday يلتقط النطاق والجدول الزمني والمالكين.

الخطوات
  1. جمع القطع الفنية
    من Sentry، احصل على المشكلة <id>: العنوان والأول مشاهدة والمستخدمون المتأثرون والإصدار الحل. من GitHub، يتم الدمج الذي أصلحها.✓ تم النسخ
    → حزمة القطع الفنية
  2. إنشاء عنصر monday
    على لوحة 'Incidents'، create_item مع name='<عنوان Sentry>', status='Resolved', owner=me, date=today, description=تحليل سبب العطل المكتوب تلقائياً يتضمن روابط القطع الفنية.✓ تم النسخ
    → تم إرجاع itemId
  3. نشر الجدول الزمني كتحديث
    انشر تحديث جدول زمني على هذا العنصر: وقت الكشف وإعادة النشر في السبب الجذري والمتابعات.✓ تم النسخ
    → تم نشر التحديث

النتيجة: تم إنشاء عنصر تحليل سبب العطل في غضون 5 دقائق من إغلاق الحادثة، مع كل شيء مرتبط.

المزالق
  • الوصف الطويل جداً يعطل تنسيق monday — احتفظ بالوصف على العناوين الرئيسية؛ ضع التفاصيل في تحديث مترابط
اجمعها مع: sentry · github

التركيبات

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

monday + sentry

إنشاء عنصر حادث monday تلقائياً عند حدوث مشكلة حرجة في Sentry

عندما تصل مشكلة Sentry WEB-3a91 إلى 100+ حدث، أنشئ عنصراً على لوحة 'Incidents' مع name=عنوان المشكلة وتعيين عمود الخطورة إلى P1.✓ تم النسخ
monday + github

ربط دمج PR بتغيير حالة عنصر monday

عندما يندمج PR #342، ابحث عن عنصر monday يطابق عنوانه وعيّن الحالة إلى 'Done'.✓ تم النسخ
monday + notion

ملخص محفظة تنفيذي أسبوعي منشور في Notion

قم بتشغيل ملخص صحة المحفظة وأنشئ صفحة Notion مع النتيجة كجدول.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_boards workspace_id?, limit? اكتشاف اللوحات GraphQL complexity units
get_board board_id فحص المخطط قبل الكتابة complexity
list_items board_id, limit?, cursor?, columns_filter? جلب العناصر على دفعات complexity
create_item board_id, group_id?, name, column_values? إضافة مهمة جديدة complexity
change_column_value board_id, item_id, column_id, value تحديث الحالة والمالك والتاريخ وما إلى ذلك complexity
create_update item_id, body نشر تعليق على عنصر complexity
archive_item item_id إزالة دون حذف complexity
create_webhook board_id, url, event دفع التغييرات إلى نظام خارجي complexity

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

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

حصة API
حدود ميزانية التعقيد: 10M تعقيد/دقيقة على Pro؛ 5M على Standard. الاستعلامات الثقيلة تكلف أكثر.
الرموز لكل استدعاء
قراءات العناصر: 500–2000 رمز. مخطط اللوحة: 500–1500 رمز.
التكلفة المالية
API مجاني على مستوى الخطة الخاصة بك. خطط monday تبدأ من ~$9/مستخدم/شهر.
نصيحة
استخدم عامل تصفية columns في list_items لإرجاع الحقول التي تحتاجها فقط — يتجنب الوصول إلى حد التعقيد على اللوحات الواسعة.

الأمان

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

الحد الأدنى من الصلاحيات: me:read boards:read
تخزين بيانات الاعتماد: MONDAY_API_TOKEN (رمز شخصي) في env
نقل البيانات الخارجي: جميع الاتصالات بـ api.monday.com
لا تمنح أبدًا: account:admin لـ MCP الذي يقرأ فقط لوحات معينة

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

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

401 Not Authenticated

MONDAY_API_TOKEN مفقود/منتهي الصلاحية. أعد إنشاء على monday.com → Developers → My Access Tokens.

تحقق: curl -H 'Authorization: $MONDAY_API_TOKEN' https://api.monday.com/v2 -d '{"query":"{ me { name } }"}'"
ComplexityException — Max complexity reached

الاستعلام ثقيل جداً. قلل limit أو احصل على عدد أقل من الأعمدة/العناصر الفرعية لكل عنصر.

ColumnValueException — invalid column value

شكل JSON لقيمة العمود خاطئ لنوع العمود. احصل على العمود أولاً وفحص النوع، ثم بناء JSON وفقاً (status: {label}, date: {date:'YYYY-MM-DD'}).

Rate limit exceeded (429)

تراجع إلى ~1 كتابة/ثانية. monday فرض خنق كل دقيقة على الطفرات.

البدائل

monday.com مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Linear MCPالفريق الموجه للهندسة يريد تتبع المشاكل الموجه للوحة المفاتيحأقل مرونة من monday؛ لا توجد أنواع أعمدة عشوائية
Asana MCPالفريق على Asanaنموذج عمود/حقل مختلف
Notion MCPتريد مستندات + تتبع خفيف على سطح واحدأضعف في إدارة المشاريع الكثيفة؛ ليست أداة إدارة مشاريع حقيقية

المزيد

الموارد

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

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

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