在引导过程中配置 LaunchDarkly 托管的 MCP 服务器。当父级 LaunchDarkly 引导技能到达步骤 4（MCP）时使用。支持 Cursor、Claude Code、Windsurf、GitHub Copilot 以及其他兼容 MCP 的代理。使用 OAuth 认证；托管服务器无需 API 密钥。
LaunchDarkly MCP 服务器配置（引导）
配置 LaunchDarkly 托管的 MCP 服务器，以便标志管理技能和引导过程可以使用 MCP 工具。使用 OAuth 进行认证——托管服务器无需 API 密钥。
此技能嵌套在 LaunchDarkly 引导 下；父级技能的步骤 4 会转交到这里。托管 MCP 是此引导流程的默认且唯一支持的选项。
前提条件
- LaunchDarkly 账户（在解析的注册 URL 处注册——参见父级技能中的 来源归属；默认：
https://app.launchdarkly.com/signup?source=agent） - 兼容 MCP 的编码代理
托管 MCP 服务器
LaunchDarkly 提供一个统一的托管 MCP 服务器，处理功能管理、AgentControl 和其他 LaunchDarkly 功能。
| 服务器 | URL | 用途 |
|---|---|---|
| LaunchDarkly | https://mcp.launchdarkly.com/mcp/launchdarkly |
功能标志、AgentControl 等 |
工作流程
步骤 1：检测代理
如果父级引导技能已经识别了代理，则使用该上下文。否则，根据代理特定的目录、配置文件以及运行时可用的工具进行推断。不要询问用户——选择最匹配的。
步骤 2：尝试快速安装
最快的路径是快速安装链接。将其呈现给用户：
LaunchDarkly MCP： https://mcp.launchdarkly.com/mcp/launchdarkly/install
重要：告知用户点击链接后的预期行为。 安装链接可能会在浏览器中打开，但授权或“添加服务器”提示通常出现在编码环境（代理运行的编辑器或宿主应用）中，而不是浏览器中。呈现链接后，立即包含如下指导：
- 点击链接后，注意你的编码环境（运行此对话的编辑器）中是否出现批准对话框、“添加 MCP 服务器”提示或工具/集成面板通知。
- 浏览器可能会启动 OAuth 流程，但你很可能需要在编辑器本身中确认或批准服务器。
- 如果没有出现提示： 检查编辑器的 MCP、集成或工具设置区域，查看服务器是否已添加但需要启用。如果完全不存在，则回退到手动设置（下面的步骤 3）。
如果快速安装链接不起作用（代理不支持，或用户更喜欢手动设置），则继续执行步骤 3。
步骤 3：手动配置
找到检测到的代理的 MCP 配置文件，并添加托管服务器条目。参见 MCP 配置模板 了解每个代理的确切 JSON。
| 代理 | 配置文件位置 |
|---|---|
| Cursor | .cursor/mcp.json（项目）或全局 Cursor 设置 |
| Claude Code | .mcp.json（项目）或 ~/.claude.json（全局） |
| GitHub Copilot | GitHub.com 上的仓库设置 → Copilot → Cloud agent → MCP（参见 MCP UI 链接） |
| Windsurf | 代理特定的 MCP 配置 |
统一服务器同时处理功能管理和 AgentControl，因此只需要一个服务器条目。
步骤 4：代理特定授权
写入配置后，某些代理需要额外步骤。不要让用户通过冗长的手动菜单路径——使用 MCP UI 链接（HTTPS 文档 + VS Code / Cursor 的 command: 快捷方式）。
Cursor：
- 使用 Cursor MCP 文档链接和应用内快捷方式 在 Cursor 中打开 MCP（例如，通过可点击的
command:链接进行设置搜索）。 - 打开 LaunchDarkly（或配置中的名称）的开关。
- 点击 Connect 以授权 LaunchDarkly 账户。
VS Code（适用时）：
- 使用 VS Code MCP 文档 +
mcp.json/ 设置链接；如果提示，信任或启动服务器。
Claude Code：
- 首次 MCP 工具调用时，通过 OAuth 提示自动完成授权。基于文件的设置：Claude Code MCP 文档。
GitHub Copilot：
- 在仓库设置中添加 MCP 配置后，点击 Save。使用 GitHub Copilot MCP 文档 了解 github.com 上的确切设置路径。
步骤 5：启用并验证
添加配置后，用户需要启用并授权服务器。在某些代理（Cursor、Claude Code）中，MCP 工具可能立即可用，无需重启。
- 告知用户启用服务器。 他们需要在编辑器的 MCP 设置中打开 LaunchDarkly 服务器的开关并完成 OAuth（例如，在 Cursor 中：打开服务器开关并点击 Connect）。
- 立即探测。 在用户确认已启用服务器后，调用一个轻量级 MCP 工具（例如，使用已知项目键调用
list-feature-flags）。不要询问用户 MCP 是否正常工作——直接尝试。- 成功（正常响应，即使标志列表为空）：MCP 已生效。在引导日志中记录并继续。
- 失败（工具未找到、认证错误、超时）：首先更新引导日志（将步骤 4 设置为“进行中 - 等待重启”，下一步设置为“步骤 4：重启后验证 MCP”），然后建议重启并给出清晰的恢复说明：
“MCP 工具尚不可用。尝试重启编辑器。回来后，只需说 '继续 LaunchDarkly 引导' ——我会根据引导日志从上次中断的地方继续。”
- 如果重启无效，则回退到 ldcli/API 执行步骤 5-6。在引导日志中记录回退。不要阻塞引导的其余部分。
- 如果失败看起来是配置问题（文件路径错误、缺少 OAuth、服务器未启用），提及可能的原因，以便用户自行修复——但不要阻塞进度。
边界情况
- 用户已配置 MCP： 通过检查配置中现有的 LD MCP 条目来验证。
-
mcp/launchdarkly→ 正常工作，跳过配置 -
mcp/fm或mcp/aiconfigs→ 已弃用，迁移前询问：D-MIGRATE -- 阻塞： 立即调用你的结构化问题工具。
- question: "我发现你配置了一个已弃用的 MCP 服务器（
mcp/fm和/或mcp/aiconfigs）。这些端点已弃用——统一服务器mcp/launchdarkly现在同时处理功能管理和 AgentControl。要我更新你的配置吗？" - options:
- "是的，更新我的配置以使用统一服务器"
- "不，暂时保持原样"
- 停止。在用户选择选项之前，不要修改 MCP 配置。
如果用户同意，删除已弃用的条目，并确保存在统一的
mcp/launchdarkly配置。参见 MCP 配置模板。如果用户拒绝，记录弃用情况并继续。 - question: "我发现你配置了一个已弃用的 MCP 服务器（
-
- 用户有旧的基于 npx 的本地服务器： 迁移他们。删除旧的
npx @launchdarkly/mcp-server条目和任何LD_ACCESS_TOKEN环境变量。替换为托管服务器配置。参见 MCP 配置模板 — 迁移。 - 代理不在已知列表中： 提供通用模式：用户需要添加一个指向
https://mcp.launchdarkly.com/mcp/launchdarkly的 MCP 服务器条目，使用其代理期望的任何格式。 - 用户在引导过程中选择不使用 MCP： 记录该选择，并使用父级技能的 ldcli/API 回退来处理环境和标志；不要阻塞 SDK 工作。
禁止事项
- 不要配置旧的基于 npx 的本地服务器。使用托管服务器。
- 不要为托管服务器询问或存储 API 密钥。托管服务器使用 OAuth。
- 不要配置旧的独立 FM/AgentControl 服务器。使用统一的
mcp/launchdarkly服务器。
