Monday.com MCP 服务器使用说明

项目简介

Monday.com MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在连接 Monday.com 工作管理平台和大型语言模型 (LLM) 客户端，如 Claude。通过此服务器，LLM 客户端可以安全、可扩展地访问和操作 Monday.com 的数据和功能，实现智能工作流程自动化。

主要功能点

本MCP服务器为 LLM 客户端提供了以下核心功能，方便用户通过自然语言与 Monday.com 进行交互：

查看看板列表: 获取用户在 Monday.com 中拥有的所有看板的列表。
查看看板分组: 获取指定 Monday.com 看板中的所有分组信息。
查看看板列: 获取指定 Monday.com 看板中的所有列信息。
创建项目/子项目: 在指定的 Monday.com 看板中创建新的项目或子项目。
更新项目/子项目: 更新 Monday.com 项目或子项目的列值。
创建项目更新: 在 Monday.com 项目或子项目上创建评论或更新。
列出分组中的项目: 列出指定 Monday.com 看板中特定分组内的所有项目。
列出项目中的子项目: 列出指定 Monday.com 项目下的所有子项目。

安装步骤

本MCP服务器可以通过多种方式安装，以下介绍通过 'uvx' 和 Docker 在 Claude Desktop 上安装的方法，以及使用 Smithery 自动安装的方式。

1. 前提条件：获取 Monday.com API 密钥和工作区名称

API 密钥: 登录您的 Monday.com 账户，按照官方文档指示创建并保存个人 API Token。
工作区名称: 从您的 Monday.com 工作区 URL 中获取。例如，如果 URL 是 'https://myworkspace.monday.com/'，则工作区名称为 'myworkspace'。

2. 安装方法

a) 使用 uvx (推荐，如果您的环境支持 uvx):

  -  确保您的环境中已安装 'uvx'。
  -  编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'，根据您的操作系统选择文件路径：
     -  MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
     -  Windows: '%APPDATA%/Claude/claude_desktop_config.json'
  -  在 'mcpServers' 字段中添加以下 JSON 配置：

  ```json
  "mcpServers": {
    "monday": {
      "command": "uvx",
      "args": [
        "mcp-server-monday"
      ],
      "env": {
        "MONDAY_API_KEY": "YOUR_MONDAY_API_KEY",  // 替换为您的 Monday.com API 密钥
        "MONDAY_WORKSPACE_NAME": "YOUR_MONDAY_WORKSPACE_NAME" // 替换为您的 Monday.com 工作区名称
      }
    }
  }
  ```

b) 使用 Docker:

  -  确保您的环境中已安装 Docker。
  -  编辑 Claude Desktop 的配置文件 'claude_desktop_config.json' (路径同上)。
  -  在 'mcpServers' 字段中添加以下 JSON 配置：

  ```json
  "mcpServers": {
    "monday-docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MONDAY_API_KEY=YOUR_MONDAY_API_KEY", // 替换为您的 Monday.com API 密钥
        "-e",
        "MONDAY_WORKSPACE_NAME=YOUR_MONDAY_WORKSPACE_NAME", // 替换为您的 Monday.com 工作区名称
        "sakce/mcp-server-monday"
      ]
    }
  }
  ```

c) 使用 Smithery (自动安装):

  -  确保您的环境中已安装 Node.js 和 npm。
  -  在终端中运行以下命令，自动为 Claude Desktop 安装 Monday.com MCP Server:

  ```bash
  npx -y @smithery/cli install @sakce/mcp-server-monday --client claude
  ```

服务器配置

MCP 服务器的配置主要通过 Claude Desktop 的 'claude_desktop_config.json' 文件完成。关键配置信息包括：

server name: 服务器的名称，例如 '"monday"' 或 '"monday-docker"'，用于在 MCP 客户端中标识和调用。
command: 启动 MCP 服务器的命令。可以是 'uvx' 或 'docker'，取决于您的安装方式。
args: 传递给 'command' 的参数，例如 '["mcp-server-monday"]' (uvx) 或 '["run", "--rm", "-i", ...]' (docker)。
env: 环境变量配置，用于传递敏感信息如 'MONDAY_API_KEY' 和 'MONDAY_WORKSPACE_NAME'。

基本使用方法

成功安装并配置 Monday.com MCP 服务器后，您可以在支持 MCP 协议的 LLM 客户端 (如 Claude) 中使用以下步骤进行交互：

启动 MCP 服务器: 根据您的安装方式，MCP 服务器会在 Claude Desktop 启动时自动启动。
在 LLM 客户端中调用工具: 您可以使用自然语言指示 LLM 客户端调用 Monday.com MCP 服务器提供的工具。例如，您可以向 Claude 提问：
- “列出我 Monday.com 上的所有看板。” (对应 'monday-list-boards' 工具)
- “在 Monday.com 看板 '项目管理' 中创建一个名为 '新项目' 的项目。” (对应 'monday-create-item' 工具)
- “获取看板 '项目管理' 中 '进行中' 分组的项目。” (对应 'monday-list-items-in-groups' 工具)

LLM 客户端会解析您的指令，并根据配置调用相应的 MCP 服务器工具，从而实现与 Monday.com 的集成互动。

请注意，具体的使用方式和指令格式可能因 LLM 客户端而异，请参考您使用的 LLM 客户端的文档。

关键词