AI导哈

AI代理工作流集成框架

monday.com MCP是一个开放框架，用于将AI代理集成到工作操作系统中，提供安全访问结构化数据、执行操作的工具以及做出智能决策所需的上下文。

  • by mondaycom
  • TypeScript
  • 本地部署
  • 436 星标
  • 更新于
在 GitHub 查看 mondaycom/mcp

使用说明

🚀 monday.com MCP

使AI代理能够在真实的工作流程中可靠地运行。这个MCP是monday.com的开放框架，用于将代理连接到您的工作操作系统中，使他们能够安全地访问结构化数据、采取行动的工具以及做出明智决策所需的上下文。

🌟 概述

该存储库由monday.com人工智能团队维护，为希望与monday.com集成的人工智能代理开发人员提供了一套全面的工具。无论您是构建人工智能助手、自动化还是自定义集成，我们的工具都可以轻松连接到monday.com平台。

👉 新到星期一MCP？从这里开始： monday.com/w/mcp

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

🔑 monday.com是什么？

monday.com 是一个工作操作系统，为团队运行流程、项目和日常工作提供动力。团队使用monday.com在一个集中平台上计划、跟踪和管理他们的工作。它提供了一个可视化、直观的界面，团队可以在其中：

  • 使用可定制的板创建和管理项目
  • 通过状态列跟踪不同阶段的任务
  • 通过更新和提及与团队成员协作
  • 自动化工作流程并与其他工具集成
  • 使用仪表板和报告可视化数据

📦 里面有什么

💻 星期一API MCP服务器

这 @mondaydotcomorg/monday-api-mcp 该包为 模型上下文协议（MCP）它允许人工智能代理与monday.com API交互，而无需构建复杂的集成。

🤖 代理工具包

这 @mondaydotcomorg/agent-toolkit 该包提供了一套强大的工具和实用程序，用于构建与monday.com API交互的人工智能代理，同时支持OpenAI和模型上下文协议（MCP）实现。

🚀 快速入门：托管MCP（推荐）

连接monday.com的最快、最强大、最可靠的方式。 我们的托管MCP服务为您处理所有基础设施-无需本地设置、自动更新和改进的性能。

📚 集成指南

开始使用您最喜欢的AI平台：

使用托管MCP快速设置

对于光标

只需将此添加到您的MCP设置中：

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

为什么使用托管MCP？

  • ✅ 无需本地安装 -无需设置即可立即工作
  • ✅ 自动更新 -始终获取最新功能
  • ✅ 更好的性能 -优化的基础设施
  • ✅ OAuth身份验证 -安全令牌管理
  • ✅ 工作区控件 -限制对特定工作区的访问
  • ✅ 更高的可靠性 -企业级正常运行时间

何时使用此存储库

如果需要，您可能希望在本地运行MCP或使用代理工具包：

  • 🔧 自定义MCP服务器 -根据特定需求修改源代码
  • 🛠️ 建立定制代理 -使用OpenAI或自定义实现的代理工具包
  • 🔌 脱机工作 -在没有互联网连接的情况下开发
  • 🧪 为发展做出贡献 -帮助改进MCP服务器或工具包

🏁 本地安装指南

步骤1：创建monday.com帐户

如果您还没有monday.com帐户：

  1. 首选 monday.com 并注册一个帐户
  2. 创建您的第一个工作区和董事会以开始

步骤2：生成API令牌

要与monday.com的API交互，您需要一个API令牌：

  1. 登录您的monday.com帐户
  2. 点击左下角的头像
  3. 选择“开发者”
  4. 点击左侧菜单上的“我的访问令牌”
  5. 复制您的个人访问令牌

步骤3：配置MCP客户端

适用于克劳德桌面

  1. 打开克劳德桌面
  2. 转到“设置”→ MCP服务器
  3. 使用此配置添加新服务器：
{
  "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扩展 为了 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中创建“更新UI”项
  • /monday:sprint-summary sprint 853的冲刺总结

适用于Cursor或其他MCP客户端（本地设置）

添加到您的设置中：

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

步骤5：测试您的集成

  1. 问克劳德或你的人工智能助理一个问题，比如：

    • “123板上有什么物品？”
    • “你能创建一个董事会来管理我的项目吗？”

  2. 您的助手现在应该能够与您的monday.com帐户进行交互！

⚙️ 高级托管MCP配置

使用授权标头

要使用托管MCP指定自定义授权标头和API版本，请执行以下操作：

{
  "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版本 头球 参数：

{
  "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"
      }
    }
  }
}

安装周一MCP应用程序

对于OAuth身份验证和工作区控制，请从市场安装Monday MCP应用程序：

  1. 访问 周一市场上的MCP应用程序
  2. 点击“安装”并按照说明将其添加到您的帐户中

🧰 可用工具

我们的MCP服务器提供了一套丰富的工具，使AI助手能够与monday.com进行交互：

类别 工具 描述
项目操作 create_item 使用指定的列值在monday.com板中创建新项目
delete_item 从板上永久删除项目
get_board_items_by_name 按板ID和术语/名称搜索项目
create_update 向特定项目添加更新/注释
change_item_column_values 修改现有项的列值
move_item_to_group 将项目移动到同一板中的不同组
董事会运营 create_board 创建一个具有指定列的新monday.com板
get_board_schema 检索板的列和组的结构
create_group 在monday.com板上创建一个新组
create_column 向现有板添加新列
delete_column 从板上删除列
账户操作 list_users_and_teams 通过id、名称或搜索帐户检索用户或团队的详细信息
工作表单操作 create_form 创建新的monday.com表单
get_form 按标记获取表单

🎨 monday.com应用程序框架工具

想在人工智能的帮助下构建定制的monday.com应用程序吗？应用程序框架工具为人工智能代理提供了对monday.com应用程序开发平台的完全访问权限，使您能够直接通过人工智能助手创建、管理和部署自定义应用程序。

📖 查看完整的应用程序框架工具文档

🔮 动态API工具（测试版）

我们的动态API工具功能代表了人工智能代理如何与monday.com互动的重大进步。虽然我们的标准工具涵盖了常见操作，但动态API工具解锁了 全电位 monday.com GraphQL API。

什么是动态API工具？

动态API工具为人工智能代理提供了对monday.com的整个API表面的完整、适应性访问。这意味着您的AI助手可以：

  1. 访问任何API端点 -不仅仅是我们构建的预定义操作
  2. 生成自定义GraphQL查询 -准确创建任何情况所需的查询
  3. 动态探索monday.com的模式 -了解所有可用的数据类型及其关系

关键动态API工具

工具 说明
all_monday_api 动态生成并执行任何GraphQL查询或变异
get_graphql_schema 获取monday.com的graphql模式以了解可用操作
get_type_details 检索特定GraphQL类型的详细信息

解锁的可能性

使用动态API工具，您的人工智能助手可以：

  • 创建复杂的报告 跨越多个板、项目和数据点
  • 执行批量操作 同时处理多个项目
  • 深度融合 monday.com的高级功能，如文档、工作区和活动日志
  • 发现新功能 随着monday.com为其API添加功能

如何启用

动态API工具处于测试版，默认情况下处于禁用状态。通过以下方式启用它们：

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

您还可以使用“仅”模式以独占方式启用动态API工具：

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

当启用“仅”模式时，服务器将仅提供动态API工具，过滤掉所有其他标准工具。这对于想要直接使用GraphQL API的高级用户非常有用。

⚠️ 备注：动态API工具需要完全访问API，并且与只读模式不兼容。

🖥️ MCP服务器配置

参数 标志 描述 必填 默认
monday.com API代币 --token, -t monday.com API代币 是 -
API版本 --version, -v monday.com API版本 否 current
模式 --mode, -m 刀具模式： default 对于标准平台工具， apps 适用于应用程序框架工具 否 default
只读模式 --read-only, -ro 启用只读模式 否 false
动态API工具 --enable-dynamic-api-tools, -edat 启用动态API工具 否 false

🔐 身份验证和安全

服务器需要monday.com API令牌才能使用monday.com API进行身份验证。您可以通过两种方式提供此令牌：

  1. 环境变量： MONDAY_TOKEN=your_monday_api_token
  2. 命令行参数： -t your_monday_api_token

安全最佳实践

  • 永远不要共享您的API代币 在公共存储库或讨论中
  • 考虑使用 只读模式 (--read-only)当您只需要检索数据时
  • 定期轮换 您的API令牌可增强安全性

📚 示例用例

以下是您可以使用我们的工具构建的一些示例：

1.项目管理人工智能助理

  • 在monday.com板上创建和管理任务
  • 获取项目状态的更新
  • 在组之间移动项目

2.数据分析和报告

  • 从monday.com板提取数据
  • 生成报告和见解
  • 创建新的报告板

🌐 社区与支持

  • GitHub问题：用于错误报告和功能请求
  • 讨论：用于提问和社区讨论
  • monday.com开发者文档：了解有关monday.com API的更多信息

📚 文档

📋 先决条件

在使用这些工具之前，请确保您已经：

  1. 已安装Node.js v20或更高版本
  2. 已安装NPM v5.2.0或更高版本
  3. A. monday.com API代币

🛠️ 如何在回购中开发

为回购开发：

  1. 克隆仓库
  2. 安装依赖项： yarn install
  3. 构建项目： yarn build
  4. 将dist/index.js文件的路径复制到 monday-api-mcp 包裹。
  5. 更改配置以在本地工作
    "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"
      }
    }

🤝 贡献

我们欢迎社区的贡献！无论是修复错误、改进文档还是添加新功能，我们都非常感谢您的帮助。

  1. 克隆该仓库
  2. 创建特征分支： git checkout -b feature/amazing-feature
  3. 提交您的更改： git commit -m 'Add some amazing feature'
  4. 推到分支： git push origin feature/amazing-feature
  5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

需要说明的是，服务器使用monday.com API，该API受monday.com的 开发者条款

Built with ❤️ by the monday.com AI Team

monday.com | Developer Platform | GitHub

相关 MCP