ONES

ONES MCP for GitHub Copilot

将 GitHub Copilot 连接到 ONES，以便在你获授权的工作区中管理项目和使用知识。此远程 MCP 服务及此代码库由 ONES 维护。

功能

• 查找和管理项目、事项、迭代和评论。
• 使用测试用例和工时记录。
• 创建和检索 Wiki 知识，并读取受支持的附件。

可用工具和操作取决于你的账户权限以及已启用的 ONES 功能。

要求

• 已启用 GitHub Copilot 和 MCP 支持的 VS Code。
• 拥有可访问 https://us.ones.com/mcp 所服务工作区的 ONES 账户。
• 根据组织的政策，获准使用 MCP 服务。

此端点服务于美国区域的部署。其他区域或私有部署可能需要使用不同的 MCP 端点。连接前，请检查工作区的 MCP 设置。

在 VS Code 中连接

1. 打开命令面板并运行 MCP: Add Server。
2. 选择 HTTP，然后输入 https://us.ones.com/mcp。
3. 将服务命名为 ones。如要连接新工作区，请选择 .mcp.json；如要在多个项目中使用，请选择客户端提供的全局配置选项。
4. 启动服务，并在出现提示时确认信任。完成基于浏览器的 OAuth 授权：登录 ONES 并查看请求的访问权限。
5. 在支持工具的 Agent 模式下打开 Copilot Chat。使用 Configure Tools 确认 ONES 工具可用。

或者，在你自己的项目根目录中创建 .mcp.json，使用以下配置。如果该文件已存在，请将 ones 条目合并到其 mcpServers 对象中：

{
  "mcpServers": {
    "ones": {
      "type": "http",
      "url": "https://us.ones.com/mcp"
    }
  }
}

可复制的示例：portable-mcp.json 使用上述 .mcp.json 格式；vscode-mcp.json 使用适用于现有 .vscode/mcp.json 配置的 servers 格式。请在一个位置配置服务，以避免出现重复条目。无需克隆此代码库或运行本地 ONES 服务。

ONES 使用 OAuth 授权。不要将密码、访问令牌或客户端密钥写入提交到 Git 的配置文件中。访问权限仍受获授权的 ONES 用户权限约束。

验证连接

保存配置后，运行 MCP: List Servers，选择 ones，并在需要时启动服务。使用你打算采用的 ONES 账户完成浏览器授权，然后返回 VS Code。在 Copilot Chat 中打开 Configure Tools，检查 ONES 工具是否可用且已启用。

发送以下首次请求：

使用 ONES 列出我可以访问的项目。不要更改任何数据。

成功的检查会返回实际可访问的项目结果；如果该账户无法访问任何项目，则会明确返回空结果。关于 ONES 的一般性回答不能证明工具已被调用：请展开 Copilot 的工具活动记录，确认 ONES 工具已成功运行。如果授权或工具调用失败，请参阅下方的故障排除步骤。

在 Copilot Chat 中使用 ONES

选择支持工具的聊天模式，并启用相关的 ONES 工具。说明你想操作的项目、事项或 Wiki 页面。如果名称有歧义，请让 Copilot 在继续操作前显示匹配的记录。将下方尖括号占位符替换为你自己的值。

查找和总结工作

使用 ONES 查找名为 <project name> 的项目。如果有多个项目匹配，请让我选择。然后列出该项目中分配给我的事项，包括标题和状态。不要修改任何内容。

使用返回的事项标识符进行后续请求：

获取 ONES 事项 <issue ID>，并总结其描述、状态和评论。

检索工作区知识

在我有权访问的 ONES Wiki 内容中搜索 <release process>。显示匹配的页面标题，检索相关页面，并总结发布步骤。如果返回了来源页面链接，请一并提供。

搜索结果取决于获授权的账户可以访问的 Wiki 内容。

创建问题

在 ONES 项目 <project name> 中，准备一个标题为 <title> 的问题，描述为：<description>。如果缺少任何必填字段，请向我询问；创建前请显示目标项目、问题类型和拟定字段。

检查拟定值，然后让 Copilot 创建问题。如果 VS Code 请求批准工具，请先检查操作，再批准。检查返回的问题标识符，并在 ONES 中打开该问题，以验证保存结果。评估写入操作时，请使用测试项目。

更新现有问题

获取 ONES 问题 <issue ID>。显示其当前状态和可选的目标状态，然后在更新前询问我应使用哪种状态。

更新后，在 ONES 中检查生成的记录。可用操作和必填字段因工作区配置和账户权限而异。

断开连接

使用 MCP: List Servers 停止 ones 服务。要移除连接配置，请仅从所选配置文件中删除对应条目。停止服务或移除客户端配置本身不会撤销已有的 OAuth 授权；请在 ONES 账户设置中单独管理该授权。

故障排除

• **授权失败：**确认你的 ONES 账户和工作区属于已配置的部署，然后重新连接并再次完成 OAuth。
• **未显示工具：**使用 MCP: List Servers 检查服务状态，查看其输出，并检查 Copilot Chat 中的工具选择。
• **操作被拒绝：**向管理员确认你的 ONES 权限以及工作区启用的功能。
• **MCP 受到限制：**询问组织管理员此服务是否获准使用。

如需反馈可复现的集成问题，请提交问题，并附上客户端版本和经过脱敏的错误消息。切勿包含令牌、凭据或私人工作区数据。

注册表元数据

该服务在 Official MCP Registry 中的标识符为 com.ones/ones。server.json 包含为发布准备的元数据，其中包括此公开仓库 URL。仓库中的文件并不能证明相应版本已由 GitHub 发布或批准；请查看实时注册表记录，了解已发布的版本。

本仓库提供 ONES 托管 MCP 服务的公开文档和连接元数据，不包含托管服务的后端源代码。

链接

• ONES
• ONES MCP 概览
• VS Code MCP 设置文档
• GitHub MCP Registry 发布指南