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

Monday.com MCP

بواسطة mondaycom · mondaycom/mcp

خادم MCP الرسمي لـ Monday.com — أدِر لوحاتك وعناصرك ولوحات التحكم من Claude بضمانات بيانات منظمة، لا استخراج شاشات.

يربط monday-mcp Claude بـ Monday.com عبر واجهة GraphQL API الرسمية. يقرأ اللوحات/المجموعات/العناصر وقيم الأعمدة والتحديثات، ويكتب/يحدث العناصر وقيم الأعمدة، ويعرض لوحات التحكم. يتضمن أدوات سياق حتى يعرف العامل مساحات العمل واللوحات الموجودة قبل التصرف — أخطاء 'لوحة خاطئة' أقل.

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

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

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

عرض مباشر

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

monday-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تجميع حالة المشروع عبر لوحات Monday متعددة

👤 مديرو المنتجات وقادة الفريق الذين لديهم مشاريع متعددة اللوحات ⏱ ~15 min beginner

متى تستخدمه: وقت التجميع الجمعة ولديك 5 لوحات لمسحها.

المتطلبات الأساسية
  • رمز API لـ Monday — Profile → Developer → API → API v2 token؛ اضبط متغير بيئة MONDAY_API_TOKEN
الخطوات
  1. اكتشاف النطاق
    Use monday-mcp. List my workspaces and the boards in 'Engineering' workspace.✓ تم النسخ
    → قائمة مساحات عمل + لوحات
  2. جلب العناصر النشطة لكل لوحة
    For each engineering board, list items in 'Working on it' and 'Stuck' status with owner + due date.✓ تم النسخ
    → قائمة مجمّعة لكل لوحة
  3. تأليف الملخص
    Write a Friday rollup: shipped this week, in flight, blocked. 6 bullets total.✓ تم النسخ
    → ملخص موجز جاهز للصق

النتيجة: لقطة متعددة اللوحات في 5 دقائق بدلاً من 45.

المزالق
  • أسماء أعمدة الحالة تختلف بين اللوحات — اطلب من Claude توحيد تسميات الحالة (Stuck/Blocked → blocked)؛ وثّق التعيين في prompt
اجمعها مع: google-workspace-mcp

إنشاء عناصر تلقائياً من بيانات بريد/نموذج الاستيعاب

👤 فرق العمليات والاستيعاب ⏱ ~30 min intermediate

متى تستخدمه: العملاء يُرسلون نموذجاً/بريداً وأنت تنشئ عناصر Monday يدوياً.

الخطوات
  1. تحليل المصدر
    Use google-workspace-mcp + monday-mcp. Read unread emails labeled 'intake', extract structured fields.✓ تم النسخ
    → JSON لكل بريد مع الحقول المستخرجة
  2. إنشاء العناصر
    For each, create an item on board 'Customer requests' with the right group + column values.✓ تم النسخ
    → N عنصر أُنشئ مع روابط دائمة؛ قائمة العلامات ذات المعلومات الناقصة
  3. الرد/التأكيد
    Reply to each sender with the item link as ack.✓ تم النسخ
    → ردود تلقائية مُرسلة

النتيجة: معالجة الاستيعاب في دقائق؛ الجميع يحصل على تأكيد.

المزالق
  • نية المُرسل غامضة؛ العنصر ينتهي في لوحة خاطئة — إذا كانت درجة الثقة منخفضة، وجّه إلى مجموعة فرز بدلاً من تخمين اللوحة الصحيحة
اجمعها مع: google-workspace-mcp

تنظيف العناصر القديمة في اللوحة

👤 قادة المشاريع الذين يعانون من البطاقات الخاملة ⏱ ~25 min intermediate

متى تستخدمه: صيانة ربع سنوية للوحة طويلة الأمد.

الخطوات
  1. تحديد القديمة
    Use monday-mcp. List items on board 'Roadmap Q1' with no updates in 60+ days, grouped by owner.✓ تم النسخ
    → قائمة قديمة لكل مالك
  2. صياغة تنبيهات المالكين
    Draft one Monday update per stale item, pinging the owner with: 'Still active? Move to done or archive.'✓ تم النسخ
    → مسودات تحديثات جاهزة
  3. النشر والأرشفة الجماعية بعد فترة السماح
    Post the updates. After 7 days, anything still untouched gets moved to 'archive' group.✓ تم النسخ
    → التحديثات منشورة؛ إدخال تقويم لجولة التنظيف

النتيجة: لوحة تعكس الواقع لا التطلعات التاريخية.

المزالق
  • أرشفة عناصر يعمل عليها أحدهم فعلاً لكنه لم يحدّث — تنبّه دائماً أولاً؛ فترة سماح قبل الأرشفة التلقائية

التركيبات

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

monday-mcp + google-workspace-mcp

الاستيعاب من البريد؛ التأكيد عبر البريد؛ ملخص الحالة في مستند Doc

From the 'intake' Gmail label, create Monday items, reply with the item link, and append a daily digest to a Google Doc.✓ تم النسخ
monday-mcp + github

مزامنة عناصر Monday الهندسية مع مشكلات GitHub

When a Monday item moves to 'In review', add a GitHub issue link if missing; when GitHub issue closes, set Monday status to Done.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_boards workspace_id? دائماً قبل الكتابة — اكتشاف النطاق 1 GraphQL call
get_board board_id قبل إنشاء عناصر — معرفة أنواع الأعمدة 1 call
search_items board_id, filters تصفية العناصر لتدفقات القراءة 1 call (paged)
create_item board_id, group_id, name, column_values الاستيعاب / عمل جديد 1 call
update_item_columns item_id, column_values تغييرات الحالة / المالك / التاريخ 1 call
create_update item_id, body التعليق على عنصر 1 call

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

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

حصة API
ميزانية تعقيد GraphQL لـ Monday — الاستعلامات الكبيرة قد تكلف أكثر من البسيطة
الرموز لكل استدعاء
اللوحات ذات الأعمدة/العناصر الكثيرة ثقيلة بالرموز؛ فضّل مجموعات أعمدة ضيقة
التكلفة المالية
الطبقة المجانية تدعم API؛ Pro+ لميزانيات تعقيد أعلى
نصيحة
اجلب فقط الأعمدة التي تحتاجها (item.column_values[id IN [...]])؛ تجنب select-all على لوحات بأكثر من 50 عموداً

الأمان

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

الحد الأدنى من الصلاحيات: boards:read boards:write (فقط إذا احتجت للكتابة)
تخزين بيانات الاعتماد: متغير بيئة MONDAY_API_TOKEN
نقل البيانات الخارجي: فقط إلى api.monday.com
لا تمنح أبدًا: رمز Admin لعامل مُشغَّل بالمحادثة — استخدم رمزاً محدوداً للتطبيق

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

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

تجاوز ميزانية التعقيد

قلّل الأعمدة/العناصر لكل استعلام؛ قسّم عبر pagination بدلاً من استدعاء ضخم واحد

تحقق: رسالة الخطأ تحتوي على كلمة 'complexity'
نوع عمود خاطئ عند الإنشاء

اقرأ columns_schema للوحة أولاً؛ column_values يجب أن تكون JSON-stringified حسب النوع

401 / رمز غير صالح

أعد توليد رمز API تحت Profile → Developer؛ الرموز محددة بالمستخدم

تحقق: curl -X POST https://api.monday.com/v2 -H 'Authorization: $MONDAY_API_TOKEN' -d 'query{me{name}}'
العنصر الفرعي لا يظهر تحت الأب

العناصر الفرعية في لوحة منفصلة؛ استخدم id لوحة العناصر الفرعية لا id الأب

البدائل

Monday.com MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Linear MCPفريق الهندسة يستخدم Linear لا Mondayمنتج مختلف؛ التعيينات أحادية الاتجاه بين الاثنين غير مثالية
Notion MCPتتبع العمل يعيش في قواعد بيانات Notionأنواع أعمدة Notion مختلفة؛ دلالات الحالة أقل أصالةً

المزيد

الموارد

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

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

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