关键词

monday.com 集成AI助手项目管理任务管理API 连接

项目简介

monday.com MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在为 AI 助手（LLM 客户端）提供与 monday.com 平台集成的能力。它通过 MCP 协议暴露 monday.com 的 API 功能，允许 AI 直接查询数据、执行操作（如创建任务、更新项目等），而无需 AI 开发者自行处理复杂的 API 集成细节。

项目包含两个主要部分：

  1. monday API MCP 服务器 ('@mondaydotcomorg/monday-api-mcp'): 这是实际的 MCP 服务器实现，负责与 MCP 客户端通信并调用 monday.com API。
  2. Agent Toolkit ('@mondaydotcomorg/agent-toolkit'): 提供了一套用于与 monday.com API 交互的工具，这些工具被 MCP 服务器和可能的 OpenAI 函数调用集成所使用。

主要功能点

该 MCP 服务器通过标准化的工具 (Tools) 向 AI 客户端提供以下 monday.com 能力：

  • 任务/项目 (Item) 操作: 创建、删除、修改项目属性（列值），获取特定项目或根据名称搜索项目，添加更新/评论。
  • 项目板 (Board) 操作: 创建新的项目板，获取项目板的结构（列和分组信息），创建和删除列。
  • 账户 (Account) 操作: 根据名称搜索用户信息。
  • 高级/动态 API 访问 (可选): 允许 AI 客户端动态探索 monday.com GraphQL API 架构，并执行任意查询和修改操作（需要启用此功能）。

安装步骤

要运行 monday.com MCP 服务器，您需要先安装 Node.js 和 NPM，然后获取 monday.com API Token。

  1. 安装 Node.js 和 NPM: 确保您的系统已安装 Node.js v20 或更高版本以及配套的 NPM v5.2.0 或更高版本。可以从 Node.js 官方网站下载安装包。
  2. 获取 monday.com API Token:
    • 登录您的 monday.com 账户。
    • 点击左下角的头像，选择 "Developers"。
    • 在左侧菜单点击 "My access tokens"。
    • 复制您的个人访问 Token。请务必妥善保管此 Token，不要泄露。
  3. 运行 MCP 服务器: 该服务器通常不是独立运行的，而是由支持 MCP 协议的 AI 客户端（如某些版本的 Claude Desktop 或 Cursor）启动。客户端会配置一个命令来启动服务器进程，并通过标准输入/输出 (Stdio) 与其通信。

服务器配置

MCP 服务器的配置通常在 AI 客户端的应用设置中完成。您需要告诉客户端如何启动 monday.com MCP 服务器程序。以下是配置所需的关键信息和参数：

  • 服务器启动命令 (command): 'npx @mondaydotcomorg/monday-api-mcp'
  • 服务器参数 (args):
    • '-t your_monday_api_token' 或 '--token your_monday_api_token'： 必需。替换 'your_monday_api_token' 为您在步骤2中获取的 monday.com API Token。
    • '-v api_version' 或 '--version api_version'： 可选。指定 monday.com API 版本。默认为 'current'。
    • '-ro' 或 '--read-only'： 可选。启用只读模式。在此模式下，只允许执行查询操作，禁止修改数据。默认关闭。
    • '-edat' 或 '--enable-dynamic-api-tools'： 可选。启用动态 API 工具（Beta 功能），允许执行任意 monday.com GraphQL API 操作。默认关闭。启用此功能需要非只读模式。

重要的配置提示:

  • AI 客户端的配置界面通常是 JSON 格式。您需要在客户端的 MCP 服务器设置中添加一个条目，为其命名（例如 "monday-api-mcp"），然后配置其 'command' 和 'args'。
  • 请在 'args' 中将实际的 'your_monday_api_token' 替换为您自己的 Token。一些客户端可能支持通过环境变量传递敏感信息，您可以查阅您客户端的文档来了解最佳实践。

基本使用方法

配置完成后，在支持 MCP 的 AI 客户端中，AI 就可以通过 MCP 服务器与 monday.com 交互了。您可以尝试向 AI 提出与 monday.com 数据相关的请求：

  • 询问 AI：“我在项目板 123 中有哪些待办事项？”（AI 可能会调用 'get_board_items_by_name' 工具）
  • 要求 AI：“帮我在项目板 456 中创建一个新任务，名称叫做 '准备会议材料'。”（AI 可能会调用 'create_item' 工具）
  • 让 AI 查询：“查找用户 '张伟' 的信息。”（AI 可能会调用 'get_users_by_name' 工具）

AI 会根据您的请求判断需要调用哪些 monday.com 工具，并通过 MCP 协议发送相应的 JSON-RPC 请求给 monday.com MCP 服务器。服务器执行操作后将结果返回给 AI，AI 再将结果整合后回应您。

信息

分类

生产力应用

访问项目