sdp-remote-mcp

OpenText Model Context Protocol 服务

OpenText 交付产品的官方 Model Context Protocol 服务，直接嵌入产品中，无需本地代理或额外进程。启用后，AI 工具即可实时读写待办列表、工作项和交付数据。身份验证使用 OAuth 2.1 或 API 访问密钥，因此每项操作都会遵循用户现有的工作区权限。

---

选择指南

本仓库介绍两款产品。它们使用相同的协议、工具集和客户端配置，但基于不同的文档体系和发布版本。请选择与您的部署相匹配的指南。

您的部署	也称为	指南
核心软件交付平台	OpenText ValueEdge	README-Core-Software-Delivery-Platform.md
软件交付管理	OpenText ALM Octane	README-Software-Delivery-Management.md

---

目录

• 选择指南
• 服务的功能
• 您可以做什么
• 支持的工具
• 共同的先决条件
• 共同的设置概览
• 安全性
• 支持与反馈

---

服务的功能

Model Context Protocol 服务嵌入产品中，通过 HTTPS 的 /mcp 路径访问。

协议	无状态 HTTP — 使用 POST 调用工具，使用 GET 发现端点；JSON-RPC 2.0
身份验证	OAuth 2.1（交互式浏览器流程）· API 访问密钥（无头模式或服务用途）
托管方式	嵌入产品中 — 本地部署和云端部署
权限	每项操作的范围都限定为已通过身份验证的用户可访问的工作区

---

您可以做什么

将 AI 客户端连接到工作区，无需离开 IDE 即可与交付数据交互：

功能	提示词示例
搜索和筛选	“列出当前冲刺中分配给我的所有未关闭缺陷。”
按关键词查找	“查找待办列表中所有提到性能的用户故事。”
创建工作项	“根据这些会议记录创建五个用户故事。”
更新实体	“使用这些验收条件更新故事 #1042 的描述。”
探索元数据	“Feature 实体有哪些字段？”
检查状态	“史诗 #205 的当前状态是什么？”

---

支持的工具

两款产品都提供相同的工具集：

工具	描述
get_entity_types	列出工作区中可用的实体类型
get_filter_metadata	返回筛选语法和支持的运算符
get_entity_field_metadata	显示实体类型的字段及字段类型
get_entities	列出实体，支持可选筛选、搜索、排序和分页
get_entity	按标识符检索单个实体
create_entity	创建新实体
update_entity	更新现有实体的指定字段

---

共享前提条件

以下要求对两款产品同样适用：

• 有效的产品站点，可以部署在本地或云端
• 已由 OpenText 管理员启用 Model Context Protocol 功能
• 以下受支持的 AI 客户端之一：搭配 GitHub Copilot 的 Visual Studio Code、搭配 GitHub Copilot 的 IntelliJ、Claude Desktop 或 Cursor
• 对于 OAuth 2.1：用于完成登录流程的现代浏览器
• 对于访问密钥：在目标工作区中生成的 API 访问令牌
• 每个连接的 Agent 或用户都需要 Aviator AI 许可证
• 每个连接都会占用一个具名用户许可证，与任何常规访问工作区的用户相同

---

共享设置概要

详细且链接准确的说明请参阅产品指南。从整体上看，两款产品的操作步骤相同：

1. 启用功能。 站点管理员提交支持工单，为站点或租户启用 Model Context Protocol。
2. 选择身份验证方式。 交互式客户端使用 OAuth 2.1；无头和服务配置使用访问密钥。
3. 注册客户端（仅限 OAuth 2.1），在 OAUTH_AUTHORIZATION_SERVER_CLIENTS 站点参数中添加每个客户端的重定向地址。
4. 配置 AI 客户端，设置服务地址和所选凭据。
5. 验证连接，在客户端中列出可用工具。

如需了解 OpenText ValueEdge 的信息，请参阅 README-Core-Software-Delivery-Platform.md；如需了解 OpenText ALM Octane 的信息，请参阅 README-Software-Delivery-Management.md。

---

安全

所有流量均通过 HTTPS 使用 TLS 1.2 或更高版本进行传输加密。访问权限严格受已通过身份验证的用户现有工作区权限限制；服务无法授予超出用户现有权限的访问权限。

注意： 避免在配置文件中以纯文本形式嵌入访问令牌。如果客户端支持，请改用环境变量或由客户端管理的输入变量。

服务的使用须遵守 OpenText 最终用户许可协议（可在 OpenText 协议页面查看），以及适用于您部署方式的服务说明。

---

支持与反馈

• 支持工单： OpenText 支持门户
• 社区： 通过 OpenText Community Ideas 提交功能请求

---

免责声明

服务会以已通过身份验证的用户权限在产品中执行操作。请遵循最小权限原则，在确认前检查影响重大的更改，并监控审计日志以发现异常活动。