在入職流程中設定 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伺服器。
