/ Каталог / Песочница / Monday.com MCP
● Официальный mondaycom 🔑 Нужен свой ключ

Monday.com MCP

автор mondaycom · mondaycom/mcp

Официальный MCP Monday.com — управляйте досками, карточками и дашбордами через Claude с гарантиями структурированных данных, а не screen-скрейпингом.

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 использует массив объектов серверов, а не map.

~/.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

👤 PM-ы, тимлиды с многоборочными проектами ⏱ ~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

Авто-создание карточек из входящих писем или форм

👤 Операционные команды с intake-процессами ⏱ ~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.✓ Скопировано
    → Авто-ответы отправлены

Итог: Intake обработан за минуты; каждый получает подтверждение.

Подводные камни
  • Намерение отправителя неоднозначно; карточка попадает на неверную доску — При низкой уверенности направляйте в triage-группу, а не угадывайте нужную доску
Сочетать с: 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

Intake из почты; подтверждение по почте; дайджест статуса в 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 issues

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 Intake / новая работа 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-токен чат-управляемому агенту — используйте ограниченный токен на уровне приложения

Устранение неполадок

Частые ошибки и исправления

Превышен бюджет сложности

Уменьшите количество столбцов/карточек на запрос; используйте пагинацию вместо одного большого вызова

Проверить: Ошибка содержит слово 'complexity'
Неверный тип столбца при создании

Сначала прочитайте схему столбцов доски; column_values должны быть JSON-строкой по типу

401 / токен недействителен

Создайте новый API-токен в Profile → Developer; токены привязаны к пользователю

Проверить: curl -X POST https://api.monday.com/v2 -H 'Authorization: $MONDAY_API_TOKEN' -d 'query{me{name}}'
Вложенная карточка не отображается под родительской

Вложенные карточки хранятся на отдельной доске; используйте id доски вложенных карточек, а не родительской

Альтернативы

Monday.com MCP в сравнении

АльтернативаКогда использоватьКомпромисс
Linear MCPИнженерная команда использует Linear, а не MondayРазные продукты; односторонний маппинг между ними несовершенен
Notion MCPОтслеживание задач живёт в Notion-базах данныхТипы столбцов Notion отличаются; меньше первоклассной семантики статусов

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills