关于 codev
codev MCP 将 AI Agent 连接到 codev 管理的 Salesforce 交付实时数据,适用于查看项目状态、构建与发布结果、验证信息及关联工作项的团队。访问权限遵循登录用户在 codev 中的角色。
主要功能
- 01发现项目及仓库配置
- 02跟踪构建、发布与部署
- 03检查验证和测试结果
- 04读取关联工作项
- 05查看环境与池容量
- 06查询交付表现洞察
适用场景
- 01确认已部署或待部署内容
- 02调查构建或验证失败
- 03审查合规与代码分析结果
- 04获取或释放池环境
MCP 相关
通过 Streamable HTTP 提供远程 MCP 端点。交互式客户端使用 OAuth 2.1 认证,工具调用遵循登录用户的 codev 权限;受控自动化也可使用应用令牌。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://{tenant}.flxbl.io/sfp/api/mcpclaude mcp add --transport http flxbl-io-codev https://{tenant}.flxbl.io/sfp/api/mcp{"mcpServers":{"flxbl-io-codev":{"type":"http","url":"https://{tenant}.flxbl.io/sfp/api/mcp"}}}在 Cursor 中打开{"servers":{"flxbl-io-codev":{"type":"http","url":"https://{tenant}.flxbl.io/sfp/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"flxbl-io-codev":{"type":"http","url":"https://{tenant}.flxbl.io/sfp/api/mcp"}}}{"mcpServers":{"flxbl-io-codev":{"serverUrl":"https://{tenant}.flxbl.io/sfp/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
codev MCP 为 AI Agent 提供团队在 codev 中管理的 Salesforce 项目的安全实时视图。连接 Claude、Codex、GitHub Copilot,或任何支持通过 Streamable HTTP 使用 MCP 的客户端,以了解交付状态、调查故障,并按照你在 codev 中拥有的相同权限执行操作。
Agent 可以执行的操作
使用 codev MCP,Agent 可以:
- 发现 Salesforce 项目及其代码仓库配置。
- 跟踪构建、发布候选版本、发布,以及每个环境中已部署或待处理的内容。
- 检查拉取请求验证、部署和测试结果、代码分析、合规性调查结果以及审核状态。
- 读取来自 Jira、Azure DevOps 或 GitHub 的关联工作项。
- 查看已注册的环境、Salesforce 组织、池容量、分配情况和审核环境。
- 查询项目的交付性能洞察。
- 为已登录用户获取、延长和释放池环境。
大多数功能为只读。池环境操作会改变状态,交互式用户只能管理自己的分配。
连接
每个 codev 实例都在以下地址提供 MCP 端点:
https://<your-tenant>.flxbl.io/sfp/api/mcp
将 <your-tenant> 替换为你的 codev 租户子域名。不要在客户端配置中填写凭据:交互式客户端会发现 codev 的 OAuth 2.1 授权服务器,并在首次连接时打开浏览器登录页面。
Claude Code
claude mcp add --transport http codev https://<your-tenant>.flxbl.io/sfp/api/mcp
在 Claude Code 中运行 /mcp 并选择 codev,即可完成登录。
Codex
codex mcp add codev --url https://<your-tenant>.flxbl.io/sfp/api/mcp
codex mcp login codev
Cursor
从 Cursor Marketplace 安装 codev,并在出现提示时输入你的 codev 租户子域名。例如,如果你的 codev URL 是 https://acme.flxbl.io,请输入 acme。
随后,Cursor 会连接到该租户的 MCP 端点,并在需要身份验证时通过 OAuth 打开 codev 登录页面。Marketplace 配置不会存储密码或访问令牌。
GitHub Copilot 和其他客户端
使用以下通用 MCP 配置:
{
"mcpServers": {
"codev": {
"type": "http",
"url": "https://<your-tenant>.flxbl.io/sfp/api/mcp"
}
}
}
在启用了 GitHub Copilot 的 VS Code 中,将配置放入 .vscode/mcp.json。Claude Desktop 和 claude.ai 用户可以将该 URL 添加为自定义连接器。
要验证连接,请向你的 Agent 提问:
列出可用的池。
身份验证和身份
交互式连接使用 OAuth 2.1。每次工具调用都以已登录用户的 codev 角色运行,池检出操作会归属到该用户的电子邮件地址。
CI 作业和脚本化 Agent 可以在 Authorization: Bearer 标头中使用 codev 应用令牌。应用令牌面向受控自动化,可独立于特定用户执行操作,因此请将其存储在机密管理器中,并谨慎授予访问权限。
注册表和实现
本仓库是 codev 的 MCP 注册表元数据和连接文档的公开存放处。远程 MCP 实现作为 codev 的一部分交付;本仓库不会重复提供该实现,且该实现仍受 codev 产品许可证约束。
注册表定义维护在 server.json 中,并发布到官方 MCP Registry,以便按照标准进行发现。包括 GitHub 公共 MCP Registry 在内的下游目录会独立决定何时索引哪些条目。
文档与支持
如有安全问题,请遵循 SECURITY.md 中的私密报告流程。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。