Adobe Launch / Tags MCP Server

Adobe Experience Platform Reactor API をラップする MCP サーバーです。この API は Adobe Launch（現在は Adobe Experience Platform Tags と呼ばれています）の背後にある API です。

アシスタントに、タグプロパティ、ルール、データ要素、拡張機能、ライブラリ、環境への読み取りアクセスと、変更の作成機能を提供します。デフォルトでは何も公開しません。 このサーバーが行う操作がライブサイトに影響を与えるのは、明示的に dangerous モードを有効にしてビルドを承認した場合のみです。

なぜこれが存在するのか

Reactor API は JSON:API サーフェスで、約 240 のエンドポイントがあり、モデルにそのまま渡すには厄介な点がいくつかあります。

• デリゲート設定は settings 属性に格納されますが、これは JSON エンコードされた文字列 であり、オブジェクトではありません。オブジェクトを渡すと、不可解な 422 が返ります。

• リソースは肥大化しています。ルールコンポーネントには約 20 の監査フィールドがあるため、200 件のルールのリストはコンテキストウィンドウを圧迫します。

• ルールは、別のエンドポイントにあるルールコンポーネントなしでは意味がありません。

• オーサリングと公開は完全に別の関心事であり、混同しがちです。

このラッパーはこれら 4 つすべてを処理します。settings のエンコード/デコード、重要事項に絞ったレスポンスの整形、ルールとそのコンポーネントの結合、公開の明示的なオプトインによるゲートです。

セットアップ

1. OAuth Server-to-Server 資格情報を作成する

Adobe は 2025 年 1 月 1 日に Service Account (JWT) フローを廃止しました。OAuth Server-to-Server 資格情報が必要です。

1. Adobe Developer Console に移動してサインインします。

2. 新しいプロジェクトを作成するか、既存のプロジェクトを開きます。

3. API を追加 → Adobe Experience Platform Launch API（Experience Cloud の下にあります）を選択します。

4. 認証タイプとして OAuth Server-to-Server を選択します。

5. 対象のプロパティへのアクセスを許可する製品プロファイルを選択します。製品プロファイルは Adobe Admin Console で管理されています。管理者でない場合は、どのプロファイルが自分のプロパティをカバーしているかを管理者に確認してください。これは空の結果や 403 の最も一般的な原因です — 資格情報は正常に認証できても、何も見えないことがあります。

6. 資格情報のページから以下をコピーします。

   • クライアント ID → REACTOR_CLIENT_ID

   • クライアントシークレット → REACTOR_CLIENT_SECRET

   • 組織 ID（@AdobeOrg で終わる）→ REACTOR_ORG_ID

   • スコープ（資格情報ページに表示されるカンマ区切りのリスト）→ REACTOR_SCOPES

サーバーはこれらを https://ims-na1.adobelogin.com/ims/token/v3 で 24 時間有効なアクセストークンと交換し、自動的に更新します。トークンを自分で扱う必要はありません。

2. インストール

ビルド済みの依存関係のないバンドルが build/adobe-launch-reactor-mcp.mjs に同梱されています。これは単一の自己完結型 ESM ファイルです — サーバーを実行するために npm install は不要 です。Node 20+ が唯一の前提条件です。

ソースから再ビルドする場合、またはテストを実行する場合:

npm install
npm run build     # tsc -> dist/
npm run bundle    # single file -> build/adobe-launch-reactor-mcp.mjs
npm test

サーバーは MCP クライアントから提供される環境変数 から資格情報を読み取ります。 .env ファイルは読み込みません — .env.example は設定する値の参照用です。

3. MCP クライアントを設定する

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "adobe-launch": {
      "command": "node",
      "args": ["/absolute/path/to/launch-mcp/build/adobe-launch-reactor-mcp.mjs"],
      "env": {
        "REACTOR_CLIENT_ID": "your-client-id",
        "REACTOR_CLIENT_SECRET": "your-client-secret",
        "REACTOR_ORG_ID": "XXXXXXXXXXXX@AdobeOrg",
        "REACTOR_SCOPES": "openid,AdobeID,read_organizations,additional_info.projectedProductContext,additional_info.roles,session",
        "REACTOR_WRITE_MODE": "read"
      }
    }
  }
}

Claude Code — claude mcp add:

claude mcp add adobe-launch \
  --env REACTOR_CLIENT_ID=... \
  --env REACTOR_CLIENT_SECRET=... \
  --env REACTOR_ORG_ID=...@AdobeOrg \
  --env REACTOR_WRITE_MODE=safe \
  -- node /absolute/path/to/launch-mcp/build/adobe-launch-reactor-mcp.mjs

次に、次のように尋ねます: "Acme Web プロパティにはどのルールがあり、公開されていないものはどれですか？"

設定

書き込みモード

モードは 2 か所で強制されます。書き込みツールはその階層以下では単に登録されず、reactor_request エスケープハッチはモードによって HTTP メソッドをホワイトリスト化します — そのため、モデルが生のエンドポイントを呼び出して階層を迂回することはできません。

safe はほとんどの作業で適切なデフォルトです。Reactor でのオーサリングは非破壊的です。新規または編集されたルールはプロパティのオーサリング状態に置かれ、それを含むライブラリがビルドされて公開されるまで、ライブサイトには何も変更されません。公開を別の明示的に有効化された階層に分離することで、ミスはインシデントではなく、UI で修正できるものになります。

ツール

読み取り（すべてのモード）

オーサリング（safe および dangerous）

reactor_create_rule、reactor_update_rule、reactor_create_rule_component、reactor_update_rule_component、reactor_create_data_element、reactor_update_data_element、reactor_install_extension、reactor_update_extension、reactor_create_library、reactor_update_library、reactor_library_add_resources、reactor_library_remove_resources、reactor_create_note。

破壊的操作（dangerous のみ）

reactor_create_build、reactor_transition_library、reactor_delete_resource。これら3つはすべて明示的な confirm: true 引数を必要とし、MCP の destructiveHint アノテーションを持つため、正しく動作するクライアントは実行前にプロンプトを表示します。

APIに関する注意点

フィルタリング。 リストツールは属性をキーとする filter オブジェクトを受け取り、値は "OPERATOR value" の形式です。演算子: EQ、NOT、LT、GT、BETWEEN、CONTAINS。

{ "filter": { "name": "CONTAINS checkout", "enabled": "EQ true" } }

Adobe はフィルタリング不可能な属性に対するフィルタを黙って無視し、完全なセットを返します。そのため、何も効果がないように見えるフィルタは、実際に空の結果であるというよりも、通常はタイプミスまたはサポートされていない属性によるものです。

リソースごとのフィルタリング可能な属性:

• rules、rule_components、data_elements: name、enabled、dirty、published、published_at、revision_number、origin_id、created_at、updated_at（rule components にも negate があります）

• properties: name、platform、enabled、token、created_at、updated_at

• extensions: name、display_name、version、enabled、dirty、published、revision_number、created_at、updated_at

• libraries: name、state、stale、published_at、created_at、updated_at

• environments: name、stage、archive、token、created_at、updated_at

• builds: status、token、created_at、updated_at

• hosts: name、type_of、created_at、updated_at

ページネーション。 デフォルトでは1ページあたり25件、最大100件です。fetch_all: true を渡すとすべてのページを巡回します（最大20ページ）。REACTOR_MAX_RESPONSE_CHARS より大きいレスポンスはレコード境界で切り詰められるため、JSON は解析可能な状態を保ち、破棄された量が示されます。

レート制限。 Reactor のソフト制限は、統合ごとに毎分およそ120リクエストです。クライアントは指数バックオフで 429 と 5xx を再試行し、Retry-After を尊重します。

設定。 Reactor はデリゲート設定を JSON エンコードされた文字列として保存します。書き込みツールはプレーンなオブジェクトを受け取りエンコードし、読み取りツールはデコードして元に戻します。文字列を渡した場合は、変更されずにそのまま通過します。

公開モデル。 オーサリングの変更は不活性です。変更を公開するには: リソースを作成または編集 → ライブラリに追加 → ライブラリをビルド → published に遷移させます。最後の2つのステップには dangerous モードが必要です。それ以外の場合は Launch UI で行ってください。

開発

npm run typecheck   # tsc --noEmit
npm test            # 35 tests against an in-memory mock of IMS + Reactor
npm run build       # compile to dist/
npm run dev         # run from source via tsx

テストスイートは、認証ヘッダーの構築とトークンキャッシュ、client_credentials グラントの形式、JSON:API のフィルタ/ソート/ページのエンコード、複数ページの巡回、レスポンスの整形と切り詰め、settings のエンコード/デコードのラウンドトリップ、リレーションシップの構築、書き込みモードのゲーティング（raw パススルーを使用してそれを回避できないことも含む）、および 404/422/429/500 のエラーメッセージ品質をカバーしています。

構造

src/
  config.ts        env parsing, write-mode tiers
  auth.ts          IMS OAuth S2S token manager with caching + refresh collapsing
  client.ts        JSON:API client: headers, query encoding, retry, pagination, error formatting
  format.ts        response shaping and size-capped serialization
  server.ts        MCP server assembly
  index.ts         stdio entrypoint
  tools/
    common.ts      shared argument schemas and helpers
    read.ts        read-only tools
    write.ts       authoring tools + dangerous tier
    raw.ts         method-gated passthrough

ライセンス

MIT.