Kameleoon MCP サーバー

​

お使いの開発環境でサーバーをセットアップする

​

機能

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

​

独自のコードを持つバリエーションを作成する

1. experiment_create を使って実験を作成する。例えば、DEVELOPER 実験として作成する。
2. experiment_create のレスポンスに含まれる、自動作成された Variation 1 の ID を使用して、experiment_variation_update でそのコードを設定する。このバリエーションのために、2つ目のバリエーションを追加しない。
3. 追加のバリエーションごとに experiment_variation_create を使い、その name と、必要な jsCode、cssCode、customJson、redirection を渡す。
4. 実験の閲覧対象を制限するには、targeting_rule_update を使って実験のセグメントまたはトリガーを設定する。実験にはすでにターゲティングルールがあるため、別のルールは作成しない。
5. experiment_code_get を使って各バリエーションのコードを読み戻し、保存された内容を確認する。

​

実験、セグメント、トリガーを編集する

​

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

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

​

トークン使用量とプランの検討事項

• ワークフローが取得するデータの量。完全な実験構成、バリエーションコード、変更履歴など。
• アシスタントが生成または変換するコードの量。勝ったバリエーションをネイティブのアプリケーションコードに変換する場合など。
• 単一のワークフローが対象とするサイトまたはブランドの数。3つのサイトにまたがる実験の複製と監査は、1つのサイトで同じ操作を実行する場合に比べて、トークンを比例して多く消費する。
• 単一のプロンプトの対象範囲の広さ。1つのサイトに限定した簡単な確認は、すべてのサイトのすべての実験を確認するような際限のない依頼に比べて、消費量がはるかに少ない。

​

利用可能なツール

​

実験

​

フィーチャーフラグ

​

ルール、バリエーション、および変数

​

ゴール

​

サイト

​

セグメント

​

トリガー

​

ターゲティングルール

​

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 the Kameleoon feature flags.”
• “What experiments are running on site X?”
• “Show the status of experiment Y.”
• “Show 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 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 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 calls, MutationObserver instances, or similar direct DOM APIs).
- 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. Call transpose_winning_experiment with the experiment ID and mode, and follow its returned instructions.
2. Convert the returned code to React (convert JS code to React components/hooks, and CSS code to the project styling system).
3. 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.
4. 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 を手動で開きます。

​

ツールが変更せず BLOCKED を返す

• 対処方法: プレビューを確認し、意図した変更であれば、AI アシスタントに confirm を true に設定して呼び出し直すよう依頼してください。segment_delete と trigger_delete の場合は、代わりに force を使用します。

​

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

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

​

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