eds-mcp-server

⚡ 3 行で始められます

claude mcp add eds -e EDS_OWNER=your-org -e EDS_REPO=your-site -- npx @focusgts/eds-mcp-server

あとはエージェントに依頼するだけです。

「サイト全体を監査して、SEO に悪影響を与えている問題を教えてください。」 「メタディスクリプションがないページすべてに追加してください。まずプレビューしてから公開してください。」 「やっぱり、その一括操作全体を元に戻してください。」 「ホームページをプレビューして公開してください。」

以上です。ローカルの AEM も、スクリプトも、接着コードも必要ありません。すべての書き込みをプレビューでき、元に戻せます。

これが他と異なる理由となるループ

flowchart LR
  A["📖 Read<br/>authored content (DA)"] --> B["🔍 Audit<br/>SEO · a11y · perf · freshness"]
  B --> C["🛠️ Fix<br/>one page or the whole site"]
  C --> D["🚀 Publish<br/>preview + live"]
  D --> E["↩️ Undo<br/>one call reverts it all"]
  E -. "re-audit to zero" .-> B

サイトをただ操作するだけではなく、安全に改善します。EDS サイトを指定すれば、エージェントが問題を見つけて修正できます。1 ページでもサイト全体でも、1 回の一括操作で処理でき、その全体を単一の eds_da_rollback で元に戻せます。Adobe 自身のものを含め、この一連の処理を最初から最後まで実行できる MCP サーバーはほかにありません。

🧠 仕組み

flowchart LR
  A["AI agent<br/>(Claude Code · Cursor · Copilot)"] -- MCP / stdio --> B["eds-mcp-server<br/>41 tools"]
  B --> C["Admin API<br/>admin.hlx.page"]
  B --> D["Content API<br/>*.aem.live"]
  B --> E["RUM / OpTel<br/>Core Web Vitals"]
  B --> G["Document Authoring<br/>admin.da.live"]
  C --> F["Your EDS site"]
  D --> F
  E --> F
  G --> F

エージェントがツールを呼び出し、サーバーが稼働中の EDS インフラストラクチャと通信します。コンテンツ、サイトマップ、メタデータなどの読み取り専用ツールには、認証情報は一切不要です。

🔑 ワンクリックでサインイン

毎日、新しい管理者トークンを貼り付ける必要はもうありません。

sequenceDiagram
  participant You
  participant CLI as eds-mcp-server login
  participant Adobe as admin.hlx.page
  You->>CLI: npx @focusgts/eds-mcp-server login
  CLI->>Adobe: open browser (client_id=aem-cli)
  You->>Adobe: sign in & approve
  Adobe-->>CLI: siteToken → localhost callback
  CLI-->>You: cached ~/.aem/auth-token.json (reused automatically)

Chrome または Firefox を使用してください。Safari はローカルコールバックをブロックします（Adobe の AEM CLI と同様です）。CI またはフォールバック経路には EDS_API_KEY を使用できます。

🛠️ 41 個のツール

Edge Delivery Services — 公開、コンテンツ、分析

9つのツールが、サイトのドキュメント作成ソース（admin.da.live）に直接アクセスします。これは EDS サイトの信頼できる唯一の情報源です。EDS_DA_TOKEN が必要です。

eds_da_export / eds_da_push により、エージェントは aem content clone の効率性を活用できます。DA のサブツリー全体を1回の呼び出しでエクスポートして操作し、バッチを1回の呼び出しでプッシュバックできます。ローカルのチェックアウトも aem-cli も不要です。同じモデルをネットワークネイティブで実現します。

デフォルトで安全です。 eds_da_push に dryRun: true を指定すると、一括編集で実行される内容（作成／更新／変更なしと行差分の件数）を何も書き込まずにプレビューできます。また、withUndo: true を指定すると、書き込みを元に戻せるようになります。返される undo オブジェクトを eds_da_rollback に渡すと、以前のコンテンツを復元し、プッシュで作成されたドキュメントを削除できます。書き込み前にプレビューし、後から元に戻せます。印象的なデモと、本番サイトを任せられるものとの差はここにあります。

EDS_DA_TOKEN は、ドキュメント作成用の Adobe IMS アクセストークンです。認証済みの da.live セッションから取得してください（IMS の access_token）。拡張子を指定しない場合、ドキュメントパスには .html が想定されます（index → index.html）。

コンテンツ監査 — 修正する前に問題を見つける

• eds_audit_page
• eds_audit_site
• eds_audit_report
• eds_audit_snapshot
• eds_audit_trend
• eds_audit_monitor

問題を教えてくれます。 eds_audit_site はサイト全体（またはサブツリー）を調べ、SEO（タイトル／説明の欠落、H1 がない、インデックス登録がブロックされている）、アクセシビリティ（代替テキストのない画像、ランドマークの欠落、ラベルのないフォーム入力）、鮮度（1年以上更新されていないページ）、サイトマップの網羅状況、および domain を指定した場合は、Adobe 独自の実ユーザーデータに基づくパフォーマンス（Core Web Vitals）と404に関する問題を、優先度順に返します。eds_audit_page は1ページに対して同じ監査を行います。読み取り専用なので、いつでも安全に実行できます。

eds_audit_report は監査結果を、美しく、クライアントにそのまま提出できる HTML レポートにまとめます。Focus GTS Navigator のレターヘッド、エグゼクティブサマリー、各ディメンションの健全性スコア、推奨修正案を添えた優先度順の問題リスト、そして PDF として保存ボタン（ブラウザー内蔵の印刷機能を使用するため、依存関係はありません）が含まれます。自己完結型（外部アセットなし）で、すぐに開いたり、ホストしたり、関係者に送ったりできます。任意の brand（代理店名、ロゴ、アクセントカラー、「prepared for」のクライアント名）を渡すと、レターヘッドをホワイトラベル化できます。

時間の経過を追跡できます。 eds_audit_snapshot は、各監査のスコアをサイト内のコンテンツにある履歴シート（デフォルトでは非公開）に記録し、前回からの変化を知らせます——「89、先週から ▲7」。eds_audit_trend は、その履歴を、スコアの経時変化と各ディメンションの推移を示す、共有可能な HTML スパークラインにまとめます。1つのスナップショットは鏡であり、トレンドはその物語です。

自動で監視できます。 eds_audit_monitor は監査を行い、前回のスナップショットとの差分を取り、ok / degraded / broken のステータスを報告します。さらに webhook を指定すると、健全性が損なわれた瞬間（新たな重大問題、またはディメンションの評価が poor に低下した場合）に Slack/Discord へ通知します。チェックと通知はサーバーが行います。スケジュールは、コピーしてすぐ使える スケジュール済み GitHub Action またはエージェントのランタイムで設定してください。Webhook は https のみ対応し、ペイロードにシークレットは含まれません。

安全な修正 — 監査で見つかった問題を修復

• eds_fix_metadata
• eds_bulk_fix_metadata
• eds_fix_redirect
• eds_fix_audit

見つかった問題を元に戻せる形で修正します。 eds_fix_metadata は、Document Authoring のソースを編集してページのタイトル、メタディスクリプション、Open Graph 画像を修復します。書き込みツールと同じ ドライラン＋取り消し のフローで処理されます。エージェントがコンテンツを用意し（例：適切な説明文を書く）、ツールがそれを 正確かつ冪等に 書き込みます（ページの Metadata ブロックに統合し、重複させません）。publish: true を渡すと、プレビュー後に公開し、変更が反映されます。

eds_bulk_fix_metadata はこれを サイト全体で、1回の元に戻せる操作として 実行します。{ path, metadata } のリストを渡すと、変更対象のすべてのページを1つのバッチで書き込み、すべてを元に戻す 1つの 取り消し操作を返します。全体の流れは、eds_audit_site → バッチを修正 → 公開 → 再監査して問題をゼロに です。問題があれば、1回の取り消し操作で元に戻せます。

eds_fix_redirect は404の問題を解決します。eds_audit_site が実ユーザーデータからリンク切れを検出し、このツールが修正に必要な 301リダイレクトルール（サイトの redirects シートに追加）を設定します。ルールは1件でも複数件でも対応し、冪等で、ドライラン＋取り消しが可能です。これにより、監査で見つかる主要な問題すべてを修正できるようになりました。

eds_fix_audit は、エージェント向けの「修正」ボタンです。監査後に、修正可能な検出項目をメタデータ と リダイレクトの両方についてまとめて、1回の元に戻せるバッチで 適用します。レポートで ✦ Fixable と表示される検出項目には機械可読な修正情報が含まれます。値はユーザーが指定します（ツールが文面を勝手に作ることはありません）。すべての変更が一度に反映されるため、1回の eds_da_rollback ですべて元に戻せます。dryRun では計画全体をプレビューし、publish: true で公開できます。

🔌 ツールに追加する

claude mcp add eds -e EDS_OWNER=your-org -e EDS_REPO=your-site -- npx @focusgts/eds-mcp-server

{
  "mcpServers": {
    "eds": {
      "command": "npx",
      "args": ["@focusgts/eds-mcp-server"],
      "env": { "EDS_OWNER": "your-org", "EDS_REPO": "your-site" }
    }
  }
}

{
  "servers": {
    "eds": {
      "command": "npx",
      "args": ["@focusgts/eds-mcp-server"],
      "env": { "EDS_OWNER": "your-org", "EDS_REPO": "your-site" }
    }
  }
}

⚙️ 設定

読み取り専用ツール（コンテンツ、サイトマップ、メタデータ）にはキーは不要です。書き込みツール（プレビュー、公開、キャッシュ）には管理者トークンが必要です。分析ツールには EDS_DOMAIN_KEY が必要です。DA ソースツールには EDS_DA_TOKEN が必要です。

🔐 認証

管理者操作には EDS 管理者トークンが必要です。トークンの指定方法は2通りあります。

ブラウザーでサインイン（対話的な利用におすすめ）

EDS_OWNER=your-org EDS_REPO=your-site npx @focusgts/eds-mcp-server login

Adobe の admin.hlx.page ログイン画面がブラウザーで開きます（AEM CLI と同じフローです）。管理サイトのトークンは ~/.aem/auth-token.json（権限モード 0600、有効期間約24時間）にキャッシュされ、自動的に再利用されます。Chrome または Firefox を使用してください — Safari はローカルコールバックをブロックします。

EDS_API_KEY（CI／自動化、および代替手段） — 設定されている場合は常にこちらが優先されます。

EDS_OWNER=your-org EDS_REPO=your-site EDS_API_KEY=<your-admin-token> npx @focusgts/eds-mcp-server

トークンを取得するには（Adobe の API キーに関するドキュメントを参照）、https://admin.hlx.page/login でサインインし、DevTools から auth_token Cookie の値をコピーするか、認証済みの AEM Sidekick リクエストから x-auth-token ヘッダーをコピーします。長期間使える認証情報が必要な場合は、サイトの API キーを設定してください。

🏗️ アーキテクチャ

Adobe の MCP 規約（adobe-rnd/da-mcp に基づく）に従って構築されています。

• TypeScript + @modelcontextprotocol/sdk + zod を使用し、リクエストごとにステートレス
• ツールの命名：eds_{verb}_{noun} · stdio トランスポート
• ネイティブの fetch()（Node 18+）を使用 — HTTP 依存関係なし

git clone https://github.com/Focus-GTS/eds-mcp-server.git
cd eds-mcp-server && npm install && npm run build && npm test

🧩 FocusGTS EDS スイートの一部