mcp-configure

LaunchDarkly MCP 服务配置（入门）

配置 LaunchDarkly 托管的 MCP 服务，以便标志管理技能和入门流程使用 MCP 工具。使用 OAuth 进行身份验证——托管服务无需 API 密钥。

此技能隶属于 LaunchDarkly 入门；第一个标志生效后，父技能会将流程交接至此。

前提条件

• 一个 LaunchDarkly 账户（引导用户注册时，请使用父技能 来源归属 中解析出的注册 URL；默认值：https://app.launchdarkly.com/signup?source=agent）
• 兼容 MCP 的编码 Agent

托管 MCP 服务

LaunchDarkly 为所有功能提供统一的托管 MCP 服务：

服务	URL	用途
LaunchDarkly（统一）	https://mcp.launchdarkly.com/mcp/launchdarkly	功能标志和 AgentControl

旧版 mcp/fm 和 mcp/aiconfigs URL 已弃用——请将所有现有用法迁移到统一服务（参见边缘情况）。

入门只需使用统一服务。

工作流

步骤 1：检测 Agent

如果父级入门技能已识别 Agent，请使用该上下文。否则，根据 Agent 专属目录、配置文件以及运行时可用的工具进行推断。不要询问用户——选择最匹配的选项。

步骤 2：尝试快速安装

最快的方法是使用快速安装链接。将其提供给用户：

LaunchDarkly MCP： https://mcp.launchdarkly.com/mcp/launchdarkly/install

重要提示：告知用户点击链接后的预期情况。 安装链接可能会在浏览器中打开，但授权或“添加服务”提示通常会返回到编码环境中（即运行 Agent 的编辑器或宿主应用），而不是出现在浏览器中。提供链接后，请立即加入类似以下的说明：

• 点击链接后，请留意编码环境（运行此对话的编辑器）中是否出现批准对话框、“添加 MCP 服务”提示，或工具/集成面板通知。
• 浏览器可能会启动 OAuth 流程，但你可能需要在编辑器中确认或批准该服务。
• 如果没有出现提示： 检查编辑器的 MCP、集成或工具设置区域，确认服务是否已添加但需要启用。如果完全找不到，请改用手动设置（见下方步骤 3）。

如果快速安装链接不起作用（Agent 不支持，或用户更喜欢手动设置），请继续步骤 3。

步骤 3：手动配置

找到检测到的 Agent 对应的 MCP 配置文件，并添加托管服务条目。每个 Agent 的确切 JSON 配置请参阅 MCP 配置模板。

Agent	配置文件位置
Cursor	.cursor/mcp.json（项目）或 Cursor 全局设置
Claude Code	.mcp.json（项目）或 ~/.claude.json（全局）
GitHub Copilot	GitHub.com 上仓库的 Settings → Copilot → Cloud agent → MCP（参见 MCP UI 链接）
Windsurf	Agent 专属 MCP 配置

为入门添加统一的 LaunchDarkly 服务。 该服务可处理功能标志和 AgentControl。

步骤 4：针对 Agent 的授权

写入配置后，某些 Agent 还需要额外操作。不要只让用户按照冗长的手动菜单路径操作——请使用 MCP UI 链接（HTTPS 文档 + VS Code / Cursor 的 command: 快捷方式）。

Cursor：

1. 使用 Cursor MCP 文档链接和应用内快捷方式在 Cursor 中打开 MCP（例如，在链接可点击时通过 command: 链接搜索 Settings）。
2. 打开 LaunchDarkly（或配置中的名称）。
3. 点击 Connect，使用 LaunchDarkly 账户授权。

VS Code（适用时）：

• 使用 VS Code MCP 文档 + mcp.json / Settings 链接；如果出现提示，请信任或启动服务。

Claude Code：

• 首次调用 MCP 工具时，会通过 OAuth 提示自动完成授权。基于文件的设置方式：Claude Code MCP 文档。

GitHub Copilot：

• 在仓库设置中添加 MCP 配置后，点击 Save。如需查看 github.com 上准确的 Settings 路径，请参阅 GitHub Copilot MCP 文档。

步骤 5：验证 MCP 工具（无需强制重启）

启用 MCP 服务后，Cursor 或 Claude Code 不再需要重启。用户确认已启用并授权该服务后，立即探测工具。

1. 告诉用户启用并授权该服务。 在 Cursor 中：在 MCP 设置中开启 LaunchDarkly 服务，然后点击 Connect。在 Claude Code 中：首次调用工具时会出现 OAuth 提示。暂时不要让用户重启。

2. 立即探测。 用户确认服务已启用后，调用一个轻量级 MCP 工具（例如使用用户的项目密钥调用 list-feature-flags）。不要询问用户 MCP 是否正常工作——直接尝试。

   • 成功（收到正常响应，即使标志列表为空）：MCP 已连接。继续。
   • 授权错误（401、403、“unauthorized”、“forbidden” 或与 OAuth 相关的消息）：已找到服务，但授权失败。转到步骤 3a。
   • 找不到工具或超时（无法识别工具、连接被拒绝、无响应）：编辑器尚未加载该服务。转到步骤 3b。

3a. 授权失败处理路径。 MCP 服务可访问，但 OAuth 尚未完成或已过期——重启编辑器无济于事。

• 告诉用户：“MCP 服务已响应，但授权失败。在 Cursor 中：打开 MCP 设置，找到 LaunchDarkly 服务，然后点击 Connect 重新授权。在 Claude Code 中：下次调用 MCP 工具时应该会再次触发 OAuth 提示。”
• 使用 MCP UI 链接，为用户提供直达其 Agent 的 MCP 设置的快捷方式。
• 用户确认重新授权后，再次探测。
• 如果再次探测成功：继续入门流程。
• 如果再次失败：提供重试单行命令（见下方步骤 4）。对于持续存在的授权问题，不要建议重启。

3b. 找不到服务处理路径。 编辑器可能尚未加载新的 MCP 配置。

• 告诉用户：“目前还看不到 MCP 工具。某些编辑器需要重启才能加载新的 MCP 服务。请重启编辑器，回来后说**‘继续 LaunchDarkly 入门流程’**——我会从这里继续。”
• 明确说明如何重启：根据步骤 1 中检测到的编辑器，告知用户“重启 Cursor”／“重新加载 Claude Code”／“刷新 Copilot Agent”。

4. 重启后恢复时： 上级入门技能会检测实时状态，因此无需日志文件。下一轮开始时：

   • 静默地重新探测 MCP 工具。
   • 如果工具现已可用：“MCP 已连接。”继续入门流程。
   • 如果仍然找不到工具：不要阻碍入门流程的其余部分——剩余步骤仍必须能在没有 MCP 的情况下完成。提供一条单行命令供用户稍后重试：“你随时可以点击[快速安装链接]并重启来设置 MCP。”

5. 如果故障看起来与配置有关（文件路径错误、服务未启用），请说明可能原因，以便用户之后自行修复——但不要阻碍进度。

边缘情况

• 用户已配置 MCP： 检查配置中是否已有 LD MCP 条目。如果统一服务（mcp/launchdarkly）已存在且正常运行，则跳过配置。如果存在已弃用的 mcp/fm 或 mcp/aiconfigs，请参阅下文。
• 用户使用已弃用的 mcp/aiconfigs 或 mcp/fm 服务： 这些 URL 已弃用。请勿自动迁移。请使用阻塞式问题：

{
  "questions": [
    {
      "id": "legacy_migration",
      "prompt": "I found a deprecated LaunchDarkly MCP URL in your config (mcp/fm or mcp/aiconfigs). It should be replaced with the unified LaunchDarkly server (mcp/launchdarkly), which handles both feature flags and AgentControl. Do you want me to migrate?",
      "options": [
        { "id": "yes", "label": "Yes, remove the old server and add the unified one" },
        { "id": "no", "label": "No, leave it as is for now" }
      ]
    }
  ]
}

• 如果回答是：移除已弃用的条目，确保统一的 mcp/launchdarkly 服务已配置（如果已存在，则不要重复添加），然后继续。

• 如果回答否：保留配置不变，并继续引导流程——已弃用的服务目前可能仍可使用。

• 用户使用旧的基于 npx 的本地服务： 将其迁移到托管服务。移除旧的 npx @launchdarkly/mcp-server 条目及所有 LD_ACCESS_TOKEN 环境变量，并替换为托管服务配置。

• Agent 不在已知列表中： 提供通用模式：用户需要根据其 Agent 所需的格式，添加指向 https://mcp.launchdarkly.com/mcp/launchdarkly 的 MCP 服务条目。

• 用户在引导过程中选择不使用 MCP： 记录该选择并继续；不要阻止 SDK 工作。

请勿执行

• 不要配置基于 npx 的本地服务。始终使用托管服务。
• 不要索要或存储 API 密钥。托管服务使用 OAuth。
• 不要自动迁移已弃用的 mcp/aiconfigs——务必通过阻塞式问题征求确认。
• 不要把重启作为第一步建议——用户启用服务后，立即探测工具。
• 不要针对身份验证错误（401/403）建议重启——服务已找到，重启无济于事。请引导用户重新授权。

参考资料

• MCP UI 链接 — 用于打开 MCP 设置的 HTTPS + command: 链接（Cursor、VS Code、Claude Code、Windsurf、GitHub）
• MCP 配置模板 — 各 Agent 对应的托管 OAuth JSON；从已弃用的配置迁移
• 官方 MCP 文档 — 完整的托管服务设置指南