Experience Manager Guides MCP サーバーの設定

MCP サーバーエンドポイント

Experience Manager Guidesは、単一のHTTP エンドポイントを通じてMCP機能を公開します。

お使いの環境の現在のツールリストを確認するには、アシスタントに次の質問を行います。

List all Experience Manager Guides tools available from the author https://author-pXXXX-eXXXX.adobeaemcloud.com and describe what they do.

組織のアクセスをリクエスト

Experience Manager Guides MCP サーバーへのアクセスは、組織ごとに​ オプトイン ​です。 組織内の誰もが次のことにアクセスできるようになります。

• AEM as a Cloud Service環境でExperience Manager Guidesを有効にする必要があります。
• 組織のIMS組織ID （組織ID）は、Adobe Guides チームが許可リストに登録している必要があります。

アクセスをリクエストするには、Adobe カスタマーサクセス部門にお問い合わせください。

セットアップ

ローカルに何もインストールしません。 クライアントをサーバーURLに指定し、Adobe IMSのサインインフローを使用して認証を行います。

人道クロード

公式のチュートリアルに従います。AEM MCP用にClaudeを設定。 カスタムコネクタを追加する場合は、Experience Manager Guides エンドポイントを使用します。

https://mcp.adobeaemcloud.com/adobe/mcp/guides

カーソル / Visual Studio Code

サーバーをMCP設定に追加します。 カーソルの場合は、.cursor/mcp.jsonに追加します。

{
  "mcpServers": {
    "aem-guides": {
      "url": "https://mcp.adobeaemcloud.com/adobe/mcp/guides"
    }
  }
}

ローカル （Studio） サーバーのみをサポートするクライアントの場合、mcp-remoteを使用してリモート エンドポイントにブリッジします。

{
  "mcpServers": {
    "aem-guides": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.adobeaemcloud.com/adobe/mcp/guides"]
    }
  }
}

Model Context Protocol （MCP）を使用して、サポートされているAI クライアントをExperience Manager Guides オンプレミス インスタンスに接続できます。 接続を確立すると、クライアントはAEM ユーザーアカウントで利用可能なExperience Manager Guides操作にアクセスできます。

すべての操作は、お使いのAEM IDと権限​を使用して実行されます。 接続しているクライアントは、AEM アカウントがアクセスを許可されているコンテンツとリソースのみを表示または変更できます。

認証では、Proof Key for Code Exchange （PKCE）を使用したOAuth 2.0認証コードフローを使用します。 初めてクライアントを接続する際に、AEMで認証を行います。 認証が成功すると、接続はアクセストークンを自動的に更新します。

次のクライアントを接続できます。

前提条件

クライアントを接続する前に、AEM管理者と協力して次の設定を確認します。

1. MCP機能がデプロイされていることを確認します。: MCP機能がデプロイされ、Experience Manager Guides インスタンスで実行されていることを確認します。

2. Granite ベース URLを設定します。: AEM Web Console Configuration Manager （/system/console/configMgr）で、Experience Manager Guides OAuth PKCE Token Wrapper​の設定を探し、Granite ベース URLが設定されていることを確認します。 Graniteのベース URLが正しく設定されていない場合、クライアントは接続を確立できません。

3. Day CQ Link Externalizerを設定します。: AEM Web Console Configuration Managerで、Day CQ Link Externalizer​設定を見つけ、外部オーサーURLが正しいAEM オーサーインスタンスを指していることを確認します。 外部オーサーURLは、OAuthの検出時に使用されます。 URLが正しくないと、クライアントが接続を完了できなくなる可能性があります。

   詳しくは、AEM Guides オンプレミスのMCP接続設定の設定を参照してください

4. MCP サーバーのURLを取得します。: MCP サーバーのURLは、次の形式を使用します。

   code language-none
   http(s)://<AEM-HOST>/bin/guides/v1/mcp/sse

   note
   NOTE
   クライアントの設定時に、完全なSSE エンドポイントを使用します。 URLに末尾のスラッシュを追加しないでください。

   次に例を示します。

   内部AEM オーサーインスタンス：

   code language-none
   http://10.42.42.20:4502/bin/guides/v1/mcp/sse

   パブリック AEM オーサーインスタンス：

   code language-none
   https://author.example.com/bin/guides/v1/mcp/sse

5. AEMの資格情報と権限を確認します。: AEM インスタンスの有効なアカウントが必要です。 AEM ユーザーインターフェイスへのログインに使用するのと同じ資格情報を使用します。 MCPを通じて使用可能な操作は、このアカウントに割り当てられた権限によって決まります。

Claude Desktopを接続する

Claude Desktopはデスクトップ拡張機能（.mcpb）をサポートしています。 Experience Manager Guides MCP拡張機能は、MCP JSON設定を手動で編集する必要がないように、接続設定をパッケージ化します。

1. aem-guides-mcp.mcpb拡張機能ファイルを取得します。

2. Claude Desktop​を開き、設定/拡張機能​に移動します。

3. ファイルをダブルクリックするか、拡張機能ウィンドウにドラッグして、aem-guides-mcp.mcpbをインストールします。

   Adobe Experience Manager Guides MCP​がインストールダイアログに表示されます。

4. インストール​を選択します。

5. 「Experience Manager Guides MCP Server URL」フィールドに、AEM インスタンスのSSE エンドポイント全体を入力します。

   次に例を示します。

   code language-none
   http://<AEM-HOST>:4502/bin/guides/v1/mcp/sse

6. 保存​を選択し、拡張機能が有効になっていることを確認します。

ChatGPTの接続

Experience Manager Guides MCP サーバーは、ChatGPTでカスタムコネクタとして設定できます。

1. MCP サーバーがパブリック HTTPS URLで次の形式で使用可能であることを確認します。

   code language-none
   https://<PUBLIC-AEM-HOST>/bin/guides/v1/mcp/sse

   ブラウザーでエンドポイントを開き、証明書の警告や接続エラーがなくてもホストに到達できることを確認します。

2. ChatGPTで、設定/ プラグイン​を開きます。

   note
   NOTE
   コネクタの可用性は、ChatGPT プランとワークスペース設定によって異なります。 ワークスペース管理者は、カスタムコネクタまたは開発者コネクタを有効にする必要がある場合があります。

3. プラグインを追加または作成するオプションを選択します。

4. コネクタの詳細を指定します。

   • 名前： Experience Manager Guidesまたは他のわかりやすい名前を入力します。
   • MCP サーバーのURL: パブリック HTTPS SSE エンドポイントを入力します。
   • 認証： OAuth​を選択します。

   OAuth クライアント IDまたはクライアントシークレットを指定する必要はありません。 MCP サーバーは、自動クライアント登録をサポートしています。

5. コネクターを作成します。

カーソルを接続

MCP設定にサーバーの詳細を追加して、CursorでExperience Manager Guides MCP サーバーを設定します。

1. カーソルで、カスタマイズ/MCP/新規​に移動します。

   カーソルで~/.cursor/mcp.json設定ファイルが開きます。

2. Experience Manager Guides MCP サーバー設定を追加します。

   次に例を示します。

   code language-json
   { "mcpServers": { "aem-guides": { "url": "http://10.42.34.176:4502/bin/guides/v1/mcp/sse", "type": "http" } } }

3. サンプル URLを、AEM インスタンスのMCP SSE エンドポイントに置き換えます。

4. 設定を保存します。

5. 設定したMCP サーバーを有効にします。