# 20250912 - 更新说明

URL: https://docs.ones.cn/release-notes/20250912

| 更新时间 | 20250912 |
| --- | --- |
| 更新内容 | **功能更新：**<br>- ONES 支持 MCP Server，支持以个人身份授权 MCP 客户端调用工具访问或写入 ONES 数据 |

### ONES MCP 服务器

ONES 提供了 Model Context Protocol（MCP）服务器，支持 MCP 的 AI 助手或应用可通过 MCP 服务器提供的工具（例如 Cursor、Visual Studio Code、Claude Code 等），以个人身份授权访问或写入 ONES 数据。

### 如何启用 ONES MCP 服务器

团队启用 ONES Copilot 应用，对应环境的 MCP 服务器即可启用。拥有 ONES Copilot 授权的个人账号可授权 MCP 客户端。

#### ONES MCP 工具

ONES MCP 服务器提供了 32 个支持对项目管理、知识库管理数据进行访问和写入。这些工具会在 MCP 客户端的 AI 助手或代理中结合用户的指令任务进行单独或组合调用。

| 模块/产品 | 工具（Tools） | 说明 |
| --- | --- | --- |
| 项目管理（14） | get_project_list | 获取团队项目列表 |
| create_new_project | 创建新项目 |
| get_project_details_by_project_id | 获取项目详情 |
| update_project_by_project_id | 更新项目 |
| get_list_of_issues | 获取工作项列表 |
| get_list_of_issue_types | 获取工作项类型列表 |
| get_list_of_issue_fields | 获取工作项属性列表 |
| get_issue_details | 获取工作项详情 |
| get_list_of_issue_comments | 获取工作项评论 |
| update_issue | 更新工作项 |
| post_issue_comment | 发表工作项评论 |
| create_new_issue | 创建工作项 |
| execute_issue_workflow | 执行工作项流转 |
| get_issue_executable_workflows | 获取工作项可执行流转 |
| 知识管理（5） | get_space_list | 获取团队下页面组列表 |
| get_space_details | 获取页面组详情 |
| get_page_details | 获取页面详情 |
| get_list_of_space_pages | 获取知识库页面列表 |
| create_page | 创建页面 |
| 工时管理（11） | get_manhour_mode | 获取当前工时模式（汇总/简单） |
| get_manour_list_in_simple_mode | 获取工作项工时列表（简单） |
| add_workour_in_simple_mode | 添加工作项工时（简单） |
| set_manhour_estimated_in_simple_mode | 设置预估工时（简单） |
| set_manhour_remaining_in_simple_mode | 设置剩余工时（简单） |
| update_workhour_in_simple_mode | 更新工时（简单） |
| get_manhour_list_in_summary_mode | 获取工时（汇总） |
| add_manhour_estimated_in_summary_mode | 添加预估工时（汇总） |
| update_manhour_estimated_in_summary_mode | 更新预估工时（汇总） |
| add_workhour_in_summary_mode | 添加实际工时（汇总） |
| update_workhour_in_summary_mode | 更新实际工时（汇总） |
| 智能助手（1） | search_for_references_in_wiki | 检索参考来源 |
| 账号管理（1） | search_for_users | 搜索用户 |

### 如何通过 MCP 客户端连接 ONES MCP 服务器

#### 获取 MCP Server 地址

访问个人中心 - 「已授权 MCP 客户端」，复制 MCP 服务器地址

![20250912 - 更新说明 配图 1](https://docs.ones.cn/assets/images/1eda49602d2db300-920de722a3f8cbe27f8827b04f0ad3ca.png)

#### 选择添加 MCP Server 地址方式

对于支持 URL 和 OAuth 的编辑器，直接添加 URL（例如：Cursor）

```text
{
    "servers": {
        "ones": {
            "url": "https://your-domain/mcp" //请替换为你的 ONES 系统 MCP Server 地址
        }
    }
}
```

对于不支持 URL 方式或 OAuth 的编辑器，通过 mcp-remote 添加（例如： Visual Studio Code）

```text
{
  /// The name of your MCP server
  "ones": {
    /// The command which runs the MCP server
    "command": "npx",
    /// The arguments to pass to the MCP server
    "args": [
      "-y",
      "mcp-remote",
      "https://your-domain/mcp", //请替换为你的 ONES 系统 MCP Server 地址
    ],
    /// The environment variables to set
    "env": {}
  }
}
```

Claude Code 添加命令如下：

```shell
claude mcp add ones npx mcp-remote https://your-domain/mcp #替换为你的 ONES 系统 MCP Server 地址
```

##### 如何配置 ONES MCP 服务器地址

以 Cursor 为例，在「Tools & Integrations」- 「MCP Tools」中点击「Add Custom MCP」

![20250912 - 更新说明 配图 2](https://docs.ones.cn/assets/images/3844a58d97de26eb-c4be7aefd95b87a05ec504be6f98e1b0.png)

在打开的 mcp.json 中，添加 ONES MCP 服务器地址：

![20250912 - 更新说明 配图 3](https://docs.ones.cn/assets/images/3fabf8179e57e4e1-17acbf7b02888da2fe30ca4a9ca4d29a.png)

保存后，返回 Cursor 设置，会看到 MCP Tools 中新增「ONES」。点击「Needs login」,弹出窗口会提示是否打开外部网站，点击「Open」

![20250912 - 更新说明 配图 4](https://docs.ones.cn/assets/images/92282acb7ccfcf6f-7294b376d53fcf0114316c68ae941751.png)

![20250912 - 更新说明 配图 5](https://docs.ones.cn/assets/images/5aeab7e70b506e9d-c226601646815e266d89af3bda3beba8.png)

此时会跳转到 ONES MCP 服务器地址对应的授权页面。登录账号，并选择「生效团队」，设置授权范围后，点击「同意授权」，即可完成 MCP 客户端与 ONES MCP 服务端授权操作。

##### 授权范围：

授权范围包括读取、创建或更新项目管理、知识库管理数据，以及读取账号管理数据。其中，「读取类」的授权范围为默认必选。用户可根据 MCP 客户端的使用场景选择合适的授权范围。

![20250912 - 更新说明 配图 6](https://docs.ones.cn/assets/images/d9d43bd96273db64-6e0ead0e6ccc75934e2d175a11c60af3.png)

![20250912 - 更新说明 配图 7](https://docs.ones.cn/assets/images/cdb68ab5db7785dd-f068f0d0c07b23da704fdd572f994aec.png)

点击「同意授权」后，在弹出窗口中选择「打开 Cursor」

![20250912 - 更新说明 配图 8](https://docs.ones.cn/assets/images/d18668d0988a87c8-ef0f32aea5e2a8ec276fa34207739bad.png)

进入「Tools & Integrations」设置，在 ONES MCP Tools 中可查看获取到的工具列表。到此就完成了 MCP 客户端（Cursor）与 ONES MCP 服务器的授权与连接。

![20250912 - 更新说明 配图 9](https://docs.ones.cn/assets/images/677a4194a1131688-1ae3d432829dbfb415a002ea15d131b6.png)