🚀 monday.com MCP

Разрешите агентам ИИ надёжно работать внутри реальных рабочих потоков. Этот MCP — открытая рамка monday.com для подключения агентов к вашей операционной системе работы — даёт им безопасный доступ к структурированным данным, инструменты для действий и контекст, необходимый для разумных решений.

🌟 Обзор

Этот репозиторий, поддерживаемый командой AI от monday.com, предоставляет полный набор инструментов для разработчиков агентов ИИ, желающих интегрироваться с monday.com. Независимо от того, создаёте ли вы AI-ассистентов, автоматизации или пользовательские интеграции, наши инструменты упрощают подключение к платформе monday.com.

👉 Новичок в monday MCP? Начните здесь: monday.com/w/mcp

https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd

🔑 Что такое monday.com?

monday.com — это рабочая операционная система, которая помогает командам управлять процессами, проектами и повседневной работой. Команды используют monday.com для планирования, отслеживания и управления своей работой в одном централизованном месте. Интерфейс визуальный и понятный, позволяя командам:

Создавать и управлять проектами с настраиваемыми досками
Отслеживать задачи на разных стадиях с помощью колонок статуса
Сотрудничать через обновления и упоминания
Автоматизировать рабочие процессы и интегрироваться с другими инструментами
Визуализировать данные через дашборды и отчёты

📦 Что внутри

💻 Сервер MCP API monday

Пакет @mondaydotcomorg/monday-api-mcp предоставляет готовую серверную реализацию для Model Context Protocol (MCP). Он позволяет AI-агентам взаимодействовать с API monday.com без необходимости строить сложные интеграции.

🤖 Инструменты агента

Пакет @mondaydotcomorg/agent-toolkit предоставляет мощный набор инструментов и утилит для создания AI-агентов, которые взаимодействуют с API monday.com, поддерживая как реализации OpenAI, так и Model Context Protocol (MCP).

🚀 Быстрый старт: Hosted MCP (рекомендуется)

Самый быстрый, надёжный и устойчивый способ подключиться к monday.com. Наш обслуживаемый сервис MCP обрабатывает всю инфраструктуру за вас — без локальной настройки, автоматические обновления и улучшенная производительность.

📚 Руководства по интеграции

Начните работу с вашей любимой AI-платформой:

Руководство по старту - впервые используете monday MCP?
Claude Integration - Подключение с Claude Desktop
Cursor Integration - Интеграция с Cursor IDE
ChatGPT Integration - Подключение с ChatGPT
MS Copilot Integration - Интеграция с Microsoft Copilot Studio
Mistral Integration - Подключение с le Chat от Mistral AI
Ready-to-Use Prompts - Примеры подсказок для быстрого старта

Быстрая настройка с Hosted MCP

Для Cursor

Просто добавьте это в настройки MCP:

{
  "mcpServers": {
    "monday-mcp": {
      "url": "https://mcp.monday.com/mcp"
    }
  }
}

Зачем использовать Hosted MCP?

✅ Без локальной установки — работает сразу, без настройки
✅ Автоматические обновления — всегда доступны новости
✅ Лучшая производительность — оптимизированная инфраструктура
✅ OAuth-аутентификация — безопасное управление токенами
✅ Контроль над рабочими пространствами — ограничение доступа к конкретным workspace
✅ Повышенная надёжность — корпоративная устойчивость

Когда использовать этот репозиторий

Возможно, вам понадобится запустить MCP локально или использовать инструменты агентного набора, если нужно:

🔧 Настроить MCP-сервер — модифицируйте исходный код под свои нужды
🛠️ Создавать собственных агентов — используйте агент Toolkit для OpenAI или реализаций под свои нужды
🔌 Работать офлайн — развёртывание без подключения к интернету
🧪 Содействовать разработке — помогать улучшать MCP-сервер или Toolkit

🏁 Руководство по локальной установке

Шаг 1: Создайте аккаунт monday.com

Если у вас ещё нет аккаунта:

Перейдите на monday.com и зарегистрируйтесь
Создайте первую рабочую область и доску, чтобы приступить к работе

Шаг 2: сгенерируйте API-токен

Чтобы взаимодействовать с API monday.com, потребуется токен API:

Войдите в свой аккаунт monday.com
Нажмите на аватар внизу слева
Выберите "Developers" (Разработчики)
Выберите "My access tokens" в левом меню
Скопируйте свой персональный токен доступа

Шаг 3: Настройка клиента MCP

Для Claude Desktop

Откройте Claude Desktop
Перейдите в Settings → MCP Servers
Добавьте новый сервер с такой конфигурацией:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Для Gemini CLI

Чтобы начать работу с Gemini CLI, можно использовать официальный Gemini CLI extension для monday.com.

Расширение Gemini CLI упаковывает сервер monday.com MCP вместе с контекстным файлом и пользовательскими командами, которые обучают Gemini пользоваться инструментами monday.com для мощных рабочих процессов.

Чтобы установить расширение, выполните в терминале:

gemini extensions install https://github.com/mondaycom/mcp

Если вы предпочитаете использовать MCP-сервер напрямую без расширения, можно добавить его следующей командой:

gemini mcp add -t http monday https://mcp.monday.com/mcp

После установки расширения или добавления MCP-сервера запустите Gemini CLI:

gemini

Затем выполните вход в свой аккаунт monday.com внутри Gemini CLI:

/mcp auth monday

Это откроет окно браузера для завершения процесса аутентификации.

После успешной аутентификации все инструменты monday.com и пользовательские команды станут доступны.

Несколько пользовательских команд, чтобы попробовать расширение:

/monday:create-item — создать элемент на доске 123 для задачи "Update the UI"
/monday:sprint-summary — сводка спринта 853

Для Cursor или других MCP-клиентов (локальная настройка)

Добавьте в настройки:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Шаг 5: Протестируйте интеграцию

спросите Claude или вашего AI-ассистента:
«Какие элементы у меня на доске 123?»
или: «Можете создать доску для управления моим проектом?»
Теперь ваш помощник должен иметь доступ к вашему аккаунту monday.com и может взаимодействовать с инструментами.

⚙️ Расширенная конфигурация Hosted MCP

Использование заголовков авторизации

Чтобы указать пользовательский заголовок авторизации и версию API для Hosted MCP:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "-p",
        "node@20",
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your_token>"
      }
    }
  }
}

Указание версии API

Вы можете указать версию API, которую хотите использовать, с помощью параметра --header:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Api-Version:${API_VERSION}"
      ],
      "env": {
        "API_VERSION": "2025-07"
      }
    }
  }
}

Установка приложения Monday MCP

Для аутентификации через OAuth и управления рабочими пространствами установите приложение Monday MCP из маркетплейса:

Перейдите на страницу monday MCP app in the marketplace
Нажмите "Install" и следуйте инструкциям для добавления в ваш аккаунт

🧰 Доступные инструменты

Наш MCP-сервер предоставляет широкий набор инструментов, который даёт AI-ассистентам возможность взаимодействовать с monday.com:

Категория	Инструмент	Описание
Операции с элементами	create_item	Создать новый элемент на доске monday.com с заданными значениями столбцов
	delete_item	Удалить элемент из доски навсегда
	get_board_items_by_name	Поиск элементов по идентификатору доски и термину/названию
	create_update	Добавить обновление/комментарий к конкретному элементу
	change_item_column_values	Изменить значения столбцов у существующего элемента
	move_item_to_group	Переместить элемент в другую группу внутри той же доски
Операции с досками	create_board	Создать новую доску monday.com с заданными столбцами
	get_board_schema	Получить структуру столбцов и групп доски
	create_group	Создать новую группу в доске
	create_column	Добавить новый столбец к существующей доске
	delete_column	Удалить столбец с доски
Операции с аккаунтом	list_users_and_teams	Получить данные пользователя или команды по id, названию или поиску в аккаунте
Операции WorkForms	create_form	Создать новую форму monday.com
	get_form	Получить форму по её токену

🎨 monday.com Apps Framework Tools

Хотите строить собственные monday.com приложения с поддержкой AI? Инструменты Apps Framework Tools предоставляют AI-агентам полный доступ к платформе разработки приложений monday.com, позволяя создавать, управлять и разворачивать кастомные приложения прямо через AI-ассистентов.

📖 [Полная документация по Tools Apps Framework](https://github.com/mondaycom/mcp/blob/master/packages/agent-toolkit/src/core/tools/monday-apps-tools/READ ME.md)

🔮 Dynamic API Tools (Beta)

Наш функционал Dynamic API Tools представляет значительный прогресс в том, как AI-агенты взаимодействуют с monday.com. В то время как стандартные инструменты охватывают обычные операции, Dynamic API Tools открывают полный потенциал GraphQL API monday.com.

Что такое Dynamic API Tools?

Dynamic API Tools предоставляют AI-агентам полный, адаптивный доступ ко всей поверхности API monday.com. Это означает, что ваш AI-ассистент может:

Доступ ко всем конечным точкам API — не только к предопределённым операциям
Генерировать пользовательские GraphQL-запросы — создавать запрос precisely под ситуацию
Динамически исследовать схему monday.com — понимать все доступные типы данных и их отношения

Ключевые инструменты Dynamic API

Инструмент	Описание
all_monday_api	Генерировать и выполнять любой GraphQL-запрос или мутацию динамически
get_graphql_schema	Получать схему GraphQL monday.com, чтобы понять доступные операции
get_type_details	Получать подробную информацию о конкретных GraphQL-типаx

Возможности

С Dynamic API Tools ваши AI-ассистенты могут:

Создавать сложные отчёты, охватывающие несколько досок, элементов и точек данных
Выполнять пакетные операции над большим числом элементов
Глубоко интегрироваться с продвинутыми возможностями monday.com, такими как документы, рабочие пространства и журналы активности
Открывать новые возможности по мере добавления функций в API monday.com

Как включить

Dynamic API Tools находятся в бете и отключены по умолчанию. Включите их с помощью:

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools true

Также можно использовать режим 'only', чтобы включить только Dynamic API Tools:

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools only

Когда режим 'only' включён, сервер будет предоставлять только Dynamic API Tools, отфильтровывая все остальные стандартные инструменты. Это полезно для продвинутых пользователей, которые хотят напрямую работать с GraphQL API.

⚠️ Примечание: Dynamic API Tools требуют полного доступа к API и несовместимы с режимом только для чтения.

🖥️ Конфигурация MCP Server

Параметр	Флаги	Описание	Обязательно	По умолчанию
Токен API monday.com	--token, -t	Токен API monday.com	Да	-
Версия API	--version, -v	Версия API monday.com	Нет	current
Режим	--mode, -m	Режим инструментов: стандартные инструменты платформы по умолчанию, приложения для Tools Apps Framework	Нет	default
Режим только для чтения	--read-only, -ro	Включить режим только для чтения	Нет	false
Инструменты Dynamic API	--enable-dynamic-api-tools, -edat	Включить инструменты Dynamic API	Нет	false

🔐 Аутентификация и безопасность

Сервер требует токен API monday.com для аутентификации в API. Токен можно указать двумя способами:

Переменная окружения: MONDAY_TOKEN=your_monday_api_token
Параметр командной строки: -t your_monday_api_token

Лучшие практики безопасности

Никогда не публикуйте ваш API-токен в общедоступных репозиториях или обсуждениях
Рассмотрите использование режима чтения только (--read-only), если нужно только извлекать данные
Регулярно обновляйте ваши API-токены для повышения безопасности

📚 Примеры использования

Ниже несколько примеров того, что можно построить с нашими инструментами:

1. AI-ассистент для управления проектами

Создание и управление задачами в досках monday.com
Получение обновлений о статусе проекта
Перемещение элементов между группами по мере продвижения

2. Анализ данных и отчётность

Извлечение данных из досок monday.com
Генерация отчётов и выводов
Создание новых досок для отчётов

🌐 Сообщество и поддержка

GitHub Issues: для сообщений об ошибках и запросов функций
Discussions: для вопросов и обсуждений сообщества
Документация разработчика monday.com: Узнайте больше об API monday.com

📚 Документация

📋 Требования

Перед использованием инструментов убедитесь, что у вас:

Установлен Node.js версии 20 или выше
Установлена NPM версии 5.2.0 или выше
Токен API monday.com (monday.com API token)

🛠️ Как развивать в репозитории

Для разработки в репозитории:

Клонируйте репозиторий
Установите зависимости: yarn install
Постройте проект: yarn build
Скопируйте путь к файлу dist/index.js в пакете monday-api-mcp
Измените конфигурацию для локального использования

/dist/index.js",
        "--enable-dynamic-api-tools",
        "true"

"monday-api-mcp": {
      "command": "node",
      "args": [
        "<your_full_path_to_the_package>/dist/index.js",
        "--enable-dynamic-api-tools",
        "true"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }

🤝 Вклад

Мы приветствуем вклад сообщества! Нужна помощь: фиксить ошибки, улучшать документацию или добавлять новые возможности.

Форкните репозиторий
Создайте ветку для своей фичи: git checkout -b feature/amazing-feature
Зафиксируйте изменения: git commit -m 'Add some amazing feature'
Отправьте ветку: git push origin feature/amazing-feature
Откройте Pull Request

📄 Лицензия

Проект лицензирован по MIT License — подробнее см. файл LICENSE.

Уточняется, что сервер использует API monday.com, которое подпадает под Developer Terms

Built with ❤️ by the monday.com AI Team

[monday.com](https://monday.com) |
[Developer Platform](https://developer.monday.com) |
[GitHub](https://github.com/mondaycom/mcp)