mcp-configure

LaunchDarkly MCP サーバー設定 (オンボーディング)

LaunchDarkly のホスト型 MCP サーバーを設定し、フィーチャーフラグ管理スキルとオンボーディングで MCP ツールを利用できるようにします。認証には OAuth を使用します。ホスト型サーバーでは API キーは不要です。

このスキルは LaunchDarkly オンボーディング の配下にあり、最初のフラグが動作した時点で親スキルからここに引き継がれます。

前提条件

• LaunchDarkly アカウント (ユーザーにサインアップを促す場合は、親スキルの ソースの帰属情報 にある解決済みのサインアップ URL を使用してください。デフォルト: https://app.launchdarkly.com/signup?source=agent)
• MCP 互換のコーディングエージェント

ホスト型 MCP サーバー

LaunchDarkly はすべての機能に対応する統合ホスト型 MCP サーバーを提供しています。

サーバー	URL	用途
LaunchDarkly (統合)	https://mcp.launchdarkly.com/mcp/launchdarkly	フィーチャーフラグと AgentControl

レガシーの mcp/fm および mcp/aiconfigs URL は 非推奨 です。既存の利用箇所は統合サーバーに移行してください (エッジケース を参照)。

オンボーディングでは、統合サーバーだけで十分です。

ワークフロー

ステップ 1: エージェントを検出する

親のオンボーディングスキルがすでにエージェントを特定している場合は、そのコンテキストを使用します。そうでない場合は、エージェント固有のディレクトリ、設定ファイル、および実行時に利用可能なツールから推測します。ユーザーには尋ねないでください。最も一致するものを選んでください。

ステップ 2: クイックインストールを試す

最も速い方法はクイックインストールリンクです。ユーザーに提示してください。

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

重要: リンクをクリックした後に何が起こるかをユーザーに伝えてください。 インストールリンクはブラウザで開くことがありますが、認可や「サーバーを追加」のプロンプトは通常、ブラウザではなく コーディング環境 (エージェントが動作しているエディタまたはホストアプリ) 側 に表示されます。リンクを提示した直後に、次のようなガイダンスを含めてください。

• リンクをクリックした後は、コーディング環境 (この会話が実行されているエディタ) で承認ダイアログ、「MCP サーバーを追加」プロンプト、またはツール/統合パネルの通知を確認してください。
• ブラウザで OAuth フローが開始される場合もありますが、サーバーの確認や承認はエディタ側で行う必要があることが多いです。
• プロンプトが表示されない場合: エディタの MCP、統合、またはツールの設定エリアを確認し、サーバーは追加されているが有効化が必要な状態になっていないか確認してください。そこにも存在しない場合は、手動設定 (以下のステップ 3) にフォールバックしてください。

クイックインストールリンクが機能しない場合 (エージェントが対応していない、またはユーザーが手動設定を希望する場合) は、ステップ 3 に進んでください。

ステップ 3: 手動設定

検出したエージェントの MCP 設定ファイルを見つけ、ホスト型サーバーのエントリを追加します。エージェントごとの正確な JSON については、MCP 設定テンプレート を参照してください。

エージェント	設定ファイルの場所
Cursor	.cursor/mcp.json (プロジェクト) またはグローバル Cursor 設定
Claude Code	.mcp.json (プロジェクト) または ~/.claude.json (グローバル)
GitHub Copilot	GitHub.com のリポジトリ Settings → Copilot → Cloud agent → MCP (MCP UI リンク を参照)
Windsurf	エージェント固有の MCP 設定

オンボーディング用に統合 LaunchDarkly サーバーを追加します。 この単一のサーバーがフィーチャーフラグと AgentControl を処理します。

ステップ 4: エージェント固有の認可

設定を書き込んだ後、一部のエージェントでは追加の手順が必要です。ユーザーを長い手動メニューパスだけに誘導するのは避けてください。MCP UI リンク（HTTPS ドキュメント + VS Code / Cursor 用の command: ショートカット）を使用してください。

Cursor:

1. Cursor MCP ドキュメントリンクとアプリ内ショートカットを使用して Cursor で MCP を開きます（例: クリック可能な場合は command: リンク経由で設定を検索）。
2. LaunchDarkly（または設定内の名前）をオンに切り替えます。
3. Connect をクリックして LaunchDarkly アカウントで認可します。

VS Code（該当する場合）:

• VS Code MCP ドキュメント + mcp.json / 設定リンクを使用します。プロンプトが表示されたらサーバーを信頼するか起動してください。

Claude Code:

• 認可は最初の MCP ツール呼び出し時に OAuth プロンプトを介して自動的に行われます。ファイルベースのセットアップ: Claude Code MCP ドキュメント。

GitHub Copilot:

• リポジトリ設定で MCP 構成を追加した後、Save をクリックします。github.com 上の正確な設定パスについては、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 リンクを使って、ユーザーのエージェントの MCP 設定へ直接アクセスできるショートカットを提供します。
• ユーザーが再認可したことを確認したら、再度プローブします。
• 再プローブが成功した場合: オンボーディングを続行します。
• 再度失敗した場合: 再試行用のワンライナーを提案します（以下のステップ 4 を参照）。認証の問題が解消しない場合に再起動を提案しないでください。

3b. サーバーが見つからないパス。 エディターが新しい MCP 設定をまだ読み込んでいない可能性が高いです。

• ユーザーに伝えます: 「MCP ツールがまだ表示されていません。新しい MCP サーバーを認識するために再起動が必要なエディターもあります。エディターを再起動し、戻ってきたら 『LaunchDarkly オンボーディングを続行』 と入力してください — ここから再開します。」
• 再起動の方法を具体的に伝えます: ステップ 1 で検出した内容に応じて「Cursor を再起動してください」/「Claude Code をリロードしてください」/「Copilot エージェントを更新してください」。

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 環境変数を削除します。ホスト型サーバーの設定に置き換えます。

• エージェントが既知のリストにない: 汎用的なパターンを提示します: ユーザーは、使用しているエージェントが期待する形式で、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 設定テンプレート — エージェントごとのホスト型 OAuth JSON。非推奨設定からの移行
• 公式 MCP ドキュメント — ホスト型セットアップの完全ガイド