Kameleoon MCP サーバー

​

機能

• 実験、フィーチャーフラグ、ゴール、セグメント、ターゲティングルールを検索および確認する。
• 実験をエンドツーエンドで構築する: 作成、複製、ライフサイクル全体 (開始、一時停止、再開、停止、削除) の実行。
• フィーチャーフラグを管理する: 作成、複製、削除、環境ごとの切り替え、変更履歴の確認。
• フラグの配信を構成する: ターゲット配信ルールや実験ルール、カスタムバリエーション、型付き変数の追加。
• ゴールとオーディエンスセグメントを作成・保守し、セグメントを実験に紐付ける。
• 実験およびフィーチャーフラグ実験の結果を分析し、バリエーションの生コード (JavaScript および CSS) を取得する。
• 勝ったバリエーションからゲートされた本番ロールアウトまで、実装ライフサイクル全体を自動化する。

​

主要ワークフロー: 勝った実験から本番環境へ

1. 実験結果を取得し、勝ったバリエーションを特定する。
2. Kameleoon からそのバリエーションの生コードを抽出する。
3. コードを既存のコードベースに整合したネイティブで本番対応のコード (React コンポーネントなど) に変換する。
4. Kameleoon でフィーチャーフラグを作成する。
5. 新しい実装をフィーチャーフラグの背後にラップする。
6. 本番環境で機能を有効化して検証する。

​

利用可能なツール

​

実験

​

フィーチャーフラグ

​

フラグの配信、バリエーション、および変数

​

ゴール

​

セグメント

​

サイトとターゲティングルール

​

Claude Code 連携

​

ステップ 1: サーバーの登録

claude mcp add --scope user kameleoon -- npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'

claude mcp add kameleoon -- npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'

claude mcp list

​

ステップ 2: OAuth 認証の完了

npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'

1. コマンドは自動的にブラウザタブを開きます。開かない場合は、ターミナルに表示された URL をコピーして手動で開きます。
2. Kameleoon アカウントにサインインします。
3. Authorize をクリックします。
4. ブラウザに成功メッセージが表示されたら、ターミナルで Ctrl+C を押します。

claude mcp list

​

ステップ 3: 新しい Claude Code セッションを開始する

​

ステップ 4: 接続の確認

• “List my Kameleoon feature flags.”
• “What experiments are active on site X?”
• “Show me the status of experiment Y.”
• “Show me the code for variation 1 of experiment Z.”

​

Claude のトラブルシューティング

​

Antigravity 連携

​

クイックセットアップ

“Connect to the Kameleoon MCP production server. The endpoint is https://mcp.kameleoon.com/mcp, using mcp-remote@0.1.37 on port 35535 with the openid scope. Authenticate by running the npx mcp-remote command to trigger my browser, then verify the connection.”

​

手動構成

"kameleoon": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@0.1.37",
    "https://mcp.kameleoon.com/mcp",
    "35535",
    "--static-oauth-client-metadata",
    "{ \"scope\": \"openid\" }"
  ]
}

​

Codex 連携

​

クイックセットアップ

“Configure the Kameleoon MCP server at https://mcp.kameleoon.com/mcp. Use port 35535 for callback. Once configured, run the login command to trigger my browser and then list my feature flags.”

​

手動構成

[mcp_servers.kameleoon]
command = "npx"
args = ["-y", "mcp-remote@0.1.37", "https://mcp.kameleoon.com/mcp",
        "35535", "--static-oauth-client-metadata",
        "{ \"scope\": \"openid\" }"]

​

接続の認証

npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 \
  --static-oauth-client-metadata '{ "scope": "openid" }'

1. ブラウザが自動的にウィンドウを開きます。
2. Kameleoon ログインページで Authorize をクリックします。
3. Kameleoon がポート 35535 でローカルコールバックを完了します。
4. ターミナルでプロキシが正常に接続されたことが確認されます。

Connected to remote server using StreamableHTTPClientTransport
Local STDIO server running
Proxy established successfully between local STDIO and remote StreamableHTTPClientTransport

​

ツール操作の確認

1. 利用可能なツールを一覧表示する: tools/list が成功し、Kameleoon ツールを返すことを確認します。出力にツール表に記載されたツール (experiment_code_get、feature_flag_list、feature_flag_create など) が含まれていることを確認します。
2. フィーチャーフラグの取得: feature_flag_list(siteCode = "d1alzzxd7k") を実行します。応答が成功すると、指定したサイトのフィーチャーフラグのリストが返されます。
3. 実験結果の取得: experiment_results_get(experimentId = 149640) を実行します。応答が成功すると、実験名、サイトコード、タイプ、ステータスが含まれます。

​

Cursor 連携

​

オプション 1: Cursor UI で構成 (推奨)

1. Cursor の設定を開きます (macOS では Cmd + Shift + J、Windows/Linux では Ctrl + Shift + J)。
2. Features > MCP Servers > + Add New MCP Server に移動します。
3. Name を kameleoon に設定します。
4. Type を command に設定します。
5. 次の文字列を Command として入力します。
   npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
   
6. 構成を保存します。

​

オプション 2: mcp.json で構成 (上級)

{
  "mcpServers": {
    "kameleoon": {
      "command": "bash",
      "args": [
        "-lc",
        "npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ \"scope\": \"openid\" }'"
      ]
    }
  }
}

​

開発者ワークフロー向けのサンプルプロンプト

• “List the Kameleoon MCP tools available in this session.”
• “Show me all feature flags for site code d1alzzxd7k.”
• “Get the details for feature flag new_search on site d1alzzxd7k.”
• “Fetch experiment results for experiment 149640 and summarize the current status.”
• “Pull the variation code for experiment <experimentId> and variation <variationId>.”

• “Inspect feature flag new_search for site d1alzzxd7k and explain what environments and variations it currently has.”
• “Summarize experiment 149640 for an engineer. Include status, site code, winner state, and whether any variation data is available.”
• “List the active feature flags for site d1alzzxd7k and point out any flags that look like stale candidates.”
• “Retrieve the code for variation <variationId> in experiment <experimentId> and explain what frontend behavior it changes.”
• “Create a new feature flag named <name> with key <featureKey> for site d1alzzxd7k.”
• “Turn on feature flag <featureKey> in the staging environment for site d1alzzxd7k.”
• “Turn off feature flag <featureKey> in the production environment for site d1alzzxd7k.”

​

高度なワークフロー: エンドツーエンドの自動化

You are integrating a Kameleoon A/B experiment into a production codebase by converting a Kameleoon PBX variation into maintainable native React code. Context

• Experiment ID: 373001
• Mode: strict_winner_only (default) or manual_variation_conversion (Fallback variation: 1266752)

Rules

• Inspect the repo first and follow existing conventions (structure, styling, routing, tests, feature flags).
• Do not copy experiment code directly. Re-implement using idiomatic React (components, hooks, state).
• Do not keep experiment-specific logic (IDs, Kameleoon APIs) in production code.
• Prefer existing feature flag systems for rollout. Use the Kameleoon MCP feature-flag tools to create and gate the flag.
• Avoid DOM manipulation (no querySelector, MutationObserver, etc.).
• Do not add new dependencies unless necessary.
• Do not modify the source experiment’s lifecycle (do not stop or delete it) unless explicitly asked.
• Be explicit if something is unclear.

Workflow steps

1. Get experiment results (experiment_results_get).
2. Decide integration:
   • Mode A (default: strict_winner_only): Proceed only if winner.status == "clear_winner".
   • Mode B (manual): Use the fallback variation provided in the context.
3. Get the variation code and the prompt that was used (experiment_code_get).
4. Convert the code to React (convert JS code to React components/hooks, and CSS code to the project styling system).
5. Create a feature flag “pbx-winning-experiment-373001” (feature_flag_create). If the implementation needs more than a simple on/off, add variations and typed variables (feature_flag_variation_create, feature_flag_variable_create, feature_flag_variation_variable_set), then gate the converted code behind the flag.
6. Roll out and validate: add a delivery rule (feature_flag_rule_targeted_create for a staged percentage rollout, or feature_flag_rule_experimentation_create to keep measuring), enable the flag in the target environment (feature_flag_enable), and confirm the final configuration with feature_flag_get.

​

ツールパラメータリファレンス

​

実験

​

フィーチャーフラグ

​

フラグの配信、バリエーション、および変数

​

ゴール

​

セグメント

​

サイトとターゲティングルール

​

プロンプトのヒント

• フィーチャーフラグを操作する際は、サイトコードを含めてください。
• 実験や実験結果を照会する際は、実験 ID を含めてください。
• バリエーションコードをリクエストする際は、experimentId と variationId の両方を含めてください。
• エージェントにフィーチャーフラグの有効化または無効化を依頼する際は、対象環境を明示的に指定してください。
• AI エージェントが生データを取得するだけでなく、MCP の応答を解釈することを希望する場合は、平易な英語のサマリーを要求してください。

​

一般的なトラブルシューティング

​

ポート 35535 がすでに使用中

• 原因: 以前の認証試行から残った古い mcp-remote プロセスがまだアクティブです。
• 対処方法: ポート 35535 を使用している古いプロセスを停止して、OAuth コマンドを再実行します。

​

MCP サーバーが Codex チャットに表示されない

• 対処方法: config.toml を更新した後、Codex を更新するか、新しいセッションを開始します。

​

ブラウザフローが完了しない

• Kameleoon ログインページで Authorize ボタンをクリックしたことを確認します。
• ブラウザまたはシステム設定が localhost コールバックをブロックしていないか確認します。
• ブラウザが自動的に起動しない場合は、コールバック URL を手動で開きます。

​

ヘッドレスまたはリモートエージェントが認証に失敗する

• 対処方法: 代わりにツールのデスクトップ版を使用してください。

​

npx コマンドが見つからない