Zentrik

Zentrik Agent Plugin

将 AI Agent 连接到团队在 Zentrik 中保存的产品决策、客户证据和产品背景。

仓库根目录遵循 Agent Plugins v1 格式，并打包了生产环境使用的 Zentrik Streamable HTTP MCP 服务和四个可复用工作流：

• brief-product-work：以工作区现有证据为依据，开展规划、确定范围、构建和评审。
• set-up-product-workspace：检查工作区，并仅应用经过批准且范围明确的设置变更。
• import-product-evidence：采集提供的通话记录、工单、评论、反馈或研究资料，并在写入前增加审批步骤。
• manage-product-study：通过基于证据的发现草稿，规划、完善和评审私有 Study。

此插件不包含凭据或本地可执行代码。MCP 服务通过 Zentrik OAuth 进行身份验证，将每个连接绑定到一个选定的工作区，并强制执行已连接用户的角色和已授予的范围。

选择合适的接入方式

• 可移植的 Agent Plugins 客户端会加载仓库根目录，并连接到通用的 https://zentrik.ai/mcp 端点。
• Codex 会加载位于 com.openai/zentrik 的 OpenAI 适配器，该适配器映射到已注册的 Zentrik 应用，供 ChatGPT 和 Codex 使用。这两个包都包含上述四个工作流；该应用使用范围更窄的 ChatGPT 工具配置。
• 仅支持 MCP 的客户端可直接连接到 https://zentrik.ai/mcp 并完成 Zentrik OAuth。
• 服务到服务自动化应使用 /external/v1 下带版本号的 REST API，并配合范围受限的 API 密钥。REST API 有单独的文档，未打包在此插件中。

请参阅 SURFACES.md，了解兼容性约定以及不同接入方式可用工具为何不同。

GitHub Copilot 和 VS Code

此服务已以 ai.zentrik/mcp 的名称发布在 Official MCP Registry 中。若要手动添加，请将以下内容放入 .vscode/mcp.json（或用户 MCP 配置）：

{
  "servers": {
    "zentrik": {
      "type": "http",
      "url": "https://zentrik.ai/mcp"
    }
  }
}

启动服务，在打开的浏览器窗口中登录 Zentrik，并选择此连接可使用的工作区。然后，在 Agent 模式下向 Copilot 提出如下问题：

• “客户对批量导出有什么看法？请引用证据。”
• “在我修改此分支之前，向我介绍一下它背后的计划。”
• “本季度哪些未解决的想法拥有最多客户证据？”

写入操作（例如导入证据或更新记录）受你的 Zentrik 角色和已授予范围限制。

Codex CLI

此仓库包含一个 Codex 市场目录，支持本地、Git 和团队分发：

codex plugin marketplace add Zentrik-AI/agent-plugins
codex plugin add zentrik@zentrik-agent-plugins

仓库根目录仍是可移植的制品。市场条目会将 Codex 指向 com.openai/zentrik 下的客户端适配器，从而将 OpenAI 专属元数据与可移植清单分开。

OpenAI 目录发布

运行 python3 scripts/package-openai-plugin.py --output zentrik-openai.zip，将 适配器打包，以供现有目录条目使用。打包工具根据已注册的应用映射生成 技术名称。ZIP 包含四个技能、资源、许可证文件，以及可移植清单格式中 现有的 ChatGPT MCP 端点。每次更新都必须保留该端点；现有条目负责管理 其 OAuth 配置，因此 ZIP 不得覆盖该配置。 CLI 市场保留 zentrik 名称和已注册的应用映射。 将 ZIP 作为新版本的元数据和技能上传到现有条目； 仅涉及服务端的更改则通过持续 MCP 审核处理。

要求

拥有 Zentrik 账户，并至少加入一个 Zentrik 工作区。无需 API 密钥。

文档和支持

• Codex 设置：https://zentrik.ai/docs/integrations/mcp-codex
• ChatGPT 设置：https://zentrik.ai/docs/integrations/mcp-chatgpt
• MCP 设置：https://zentrik.ai/docs/integrations/mcp
• MCP 工作流：https://zentrik.ai/docs/integrations/mcp-workflows
• 支持：[email protected]

许可证

Apache-2.0。请参阅分发仓库中的 LICENSE 文件。