Sitecoreとエージェントプラットフォームの統合

AIとの仕事
Sitecoreとエージェントプラットフォームの統合
マーケターMCPツールの参考およびその他の情報

マーケターMCPツールの参考およびその他の情報

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このトピックでは、Sitecore Marketer MCPサーバーで利用可能なツールと、それらがどのようにアクションを実行するかについて詳しく説明SitecoreAI。また、機能の理解、トラブルシューティング、よくある質問への回答を見つけるための支援リソースも含まれています。

このセクションを使って利用可能なツールの探索、追加のガイダンス確認、マーケターMCPサーバーでの対応に関する問題の解決に活用してください。

ツールリファレンス

Sitecore Marketer MCPサーバー内のすべてのツールはデフォルトで有効化されています。完全な機能を確保するために、これらの機能を有効にしておくことをお勧めします。各ツールはエージェントAPIのエンドポイントに対応しており、サーバーはSitecoreAIのアクションを実行するためにこれを用います。

以下の表は、ユースケースごとにグループ化された利用可能なツールを示しています:

ツール	概要
list_sites	利用可能なサイトの一覧と、名前、表示名、URLなどの基本情報を取得します。
get_site_information	特定のサイトのIDで詳細を取得します。
get_site_id_from_item	特定のアイテムIDに関連付けられたサイトIDを取得します。
get_all_pages_by_site	特定のサイトのページ一覧を取得し、各ページのIDやパスを含みます。
get_all_languages	システム内のすべての言語を取得します。

ツール	概要
create_page	親ページの下に指定されたテンプレートを使って新しいページを作成します。
add_language_to_page	既存のページに新しい言語版を追加します。
add_component_on_page	ページの特定のプレースホルダーにコンポーネントを追加します。
get_components_on_page	現在特定のページに追加されているコンポーネントのリストを取得します
set_component_datasource	ページ上の特定のコンポーネントのデータソースを設定します
search_site	ページタイトルや内容に合致する検索語を用いて、特定のサイト内のすべてのページを検索します。
get_page_path_by_live_url	ウェブサイト上のライブURLに対応するページアイテムパスを取得します。
get_page_screenshot	特定のページのスクリーンショットをbase64でエンコードされた画像として取得します。
get_page_html	特定のページのHTMLコンテンツを取得します。
get_page_preview_url	ページのプレビューに使えるURLを取得します。
get_page_template_by_id	特定のページテンプレートの詳細、フィールドや設定を取得します。
get_page	IDと言語コードによってページの詳細を取得します。
get_allowed_comps_by_ph	ページ上の特定のプレースホルダーに追加できるコンポーネントのリストを取得します。

ツール	概要
create_content_item	指定されたテンプレートとフィールド値を使って新しいコンテンツ項目を作成します。
update_content	既存のコンテンツ項目を更新し、そのフィールドや言語も含めて更新します。
delete_content	コンテンツ項目を削除し、オプションで子項目をすべて削除します。警告 languageクエリパラメータは現在使用されていません。そのコンテンツ全体は、その価値に関係なく削除されます。
get_content_item_by_path	コンテンツツリー内のパスを指定することで、コンテンツアイテムの詳細を取得します。
get_content_item_by_id	特定のコンテンツ項目のIDを指定することで詳細を取得します。
list_avail_insertopts	指定された親項目の下に子項目として挿入可能なコンテンツテンプレートのリストを取得します。
update_fields_on_item	コンテンツ項目のフィールドを更新します。

ツール	概要
list_components	特定のサイトで利用可能なコンポーネントのリストを取得します。
get_component	特定のコンポーネントの詳細、ID、名前、データソースオプションを取得します。
get_components_by_ph	特定のプレースホルダー内で許可されるコンポーネントのリストを取得します。
create_component_ds	提供されたデータフィールドの値を使って、特定のコンポーネントに対して新しいデータソース項目を作成します。
search_component_ds	特定のコンポーネントで利用可能なデータソースを検索します。

ツール	概要
search_assets	クエリ用語、ファイル形式、タグを使って動画、画像、ドキュメントなどのデジタル資産を検索できます。
get_asset_information	特定のデジタル資産のIDを指定することで詳細を取得します。
update_asset	既存のデジタル資産のメタデータやプロパティ(代替テキスト、説明、タグなど)を更新します。

ツール	概要
get_perso_ver_by_page	特定のページに定義されたすべてのパーソナライズバリアントを取得します。
create_perso_version	ページの新しいパーソナライズバリアントを作成し、異なるオーディエンス向けにターゲティングルールを定義できるようにします。
get_perso_cond_tmpls	パーソナライズ用の利用可能なすべての条件テンプレートを取得します。
get_perso_cond_tmpl_by_id	ページ上でパーソナライズバリアントを作成するためのパラメータを含む条件テンプレートをIDで取得します。

ツール	概要
list_brandkits	利用可能なすべてのブランドキットを取得し、名前、ID、ブランド、会社、ステータスを含みます。
get_brandkit_by_id	ブランドキットのIDによる詳細、セクションおよび関連するフィールド(サブセクション)を取得します。

重要

これらのツールは通常、LLMが駆動する会話型ブリーフ作成フローの一部として使われますが、必要に応じて個別に使用することも可能です。

ブリーフは会話中に作成・洗練することができます。最終版を確認し承認した後、save_briefツールはそれをドラフトとして保存します。

ツール	概要
list-brief_types	利用可能なすべてのブリーフタイプ(名前、ラベル、IDを含む)を取得します。
generate_brief	指定されたブランドキットとブリーフタイプを使って新しいブリーフを作成します。ブリーフは保存されません。
update_brief	更新指示に基づいて既存のブリーフの改訂版を作成します。
save_brief	承認されたブリーフはブリーフ管理ツールのDraftとして保存してください。

例示プロンプト

Sitecore Marketer MCPサーバーは、自然言語プロンプトを使って一般的なマーケティングやコンテンツタスクを実行できるようにします。

重要

Marketer MCPサーバーは、ここで挙げるサポートされたユースケースでのみ信頼性があります。この範囲外の回答はSitecoreによって検証されておらず、不正確である可能性があります。

以下の例は、異なるユースケースでサーバーとどのように相互作用するかを示しています。

List all available sites in my tenant.
Get information about the Habitat site.
Show all or specific pages for the Habitat site.

Search for pages containing a specific term like Spring Sale in the title.
Create a landing page in the Habitat site.
Add a French language version to the homepage.
Get the HTML content for the Contact us page.

Create a new blog post about AI trends under the technology section.
Update the hero text on the homepage to Welcome to Innovation.
List all available templates I can use for new content.

Add a hero component to the homepage main placeholder.
List all components available for the Habitat site.
Show me components I can add to the sidebar placeholder.

Update alt text for all images tagged with hero.
Find assets related to the spring campaign.
Get details for the brand logo asset.

Create a personalization version for returning customers on the homepage.
List all personalization versions for the product page.

List all brand kits available in the organization.
Retrieve the the Powerful brand kit.

List all available brief types.
Generate a brief for a new product launch campaign for Easter.

その他の技術情報

このセクションでは、Sitecore Marketer MCPサーバーがどのようにセキュリティを強制し、技術的な観点から動作するかを説明します。

以下の表は、Marketer MCPサーバーの主要な技術的詳細を示しています。

特性	概要
プロトコル	JSON-RPC 2.0ベースのAPI形式を使用しています。
司会	エッジのパフォーマンスとスケーラビリティのためにCloudflare Workers上でホストしています。
APIフォーマット	JSON応答を持つOpenAPI RESTエンドポイント。
モニタリング	パフォーマンストラッキングのための観察可能性と監査の軌跡。

Marketer MCPサーバーは、安全で監査可能な運用を確保するためにセキュリティおよびコンプライアンス管理を強制します。

テナント対応の作業と自動隔離。
短命トークンで安全なリフレッシュ。
既存のSitecore権限に従う役割ベースのアクセス。
すべての操作とデータアクセスに対する監査ログ。
システムの安定性を保護するためのレート制限(10秒あたり50リクエスト)。

Marketer MCPサーバーは、厳格なアクセスおよびセキュリティの境界を維持しつつ、自動化でSitecore APIを拡張します。

Tenant handling - テナントコンテキストを自動的に検出します。
Token management - 安全なセッションの認証トークンを管理します。
Smart orchestration - 複数のAPI呼び出しを簡略化したアクションにまとめる。
Data consistency - データの検証と標準化。
Access boundaries - ユーザーのテナントに限定される;入居者間の通行や高架アクセスはありません。
Security controls - Sitecoreの既存のロールベース権限を強制する。
Audit and compliance - 透明性とトレーサビリティのためにすべての作業を追跡する。

トラブルシューティング

このセクションでは、Marketer MCPサーバーを使用する際によくある問題を特定し解決するのに役立ちます。

サインインできない場合は、期待するツールが表示されるか、Access deniedメッセージが表示されます。

正しい組織とテナントに登録されていることを確認してください。
繰り返しサインインを促された場合は、セッションが終了している可能性があるため、再度サインインする必要があります。
ユーザーロールに必要なツールやアクションへのアクセスが含まれているか確認してください
問題が続く場合は、管理者に連絡して権限を確認してください。

OAuth認証中にResource parameter is requiredエラーが発生した場合:

認可URLに必要なresourceクエリパラメータが欠けている可能性があります。
認証URLに以下のパラメータを追加します:
&resource=https%3A%2F%2Fmarketer.sitecorecloud.io%2Fmcp%2Fmarketer-mcp-prod
認証を続けるには、新しいブラウザウィンドウで更新されたURLをOpenしてください。

接続後に期待されるMarketerのMCPツールや統合が見られない場合は:

正しい入居者にサインインしているか確認してください。
管理者に、あなたの役割にツールへのアクセスが含まれているか確認してください。
接続をリフレッシュするか、MCPクライアントを再起動してください。

マーケターMCPサーバーの応答が遅いか接続に失敗した場合:

数秒待ってから再度試してください(レート制限が適用される場合があります:10秒あたり50リクエスト)。
インターネット接続とVPNの状態を確認してください。
マリファルタルやプロキシがその端末のURLを許可しているか確認してください。

問題が続く場合は、エラーメッセージ、テナント、実行されたアクションなどの詳細を収集し、サポートケースを作成しましょう。

よくある質問

このセクションでは、Marketer MCPに関する最もよくある質問にお答えします。

はい。組織やテナントに適した権限を持つ有効なSitecore認証情報が必要です。サーバーは既存のアクセス制御とユーザーロールを尊重します。

Marketer MCPサーバーが有効で、有効な認証情報、ClaudeやCursorなどのMCP互換AIクライアントを備えたSitecore環境へのアクセスが必要です。

サーバーはSitecore内の操作を行うためにAgent APIに接続します。AIエージェントがプロンプトを受け取ると、それをAgent APIが実行する構造化リクエストに変換します。

マーケター、コンテンツ作成者、開発者、パートナー、そしてサポートMCPクライアントを通じてSitecoreに接続するAIシステム。

いいえ。サーバーは、マーケターがコードやAPI呼び出しの代わりに自然言語コマンドでページ、コンテンツ、パーソナライズを管理できるようにします。

はい。サーバーはSitecoreで動作するための別の方法を追加しますが、従来のインターフェースに代わるものではありません。両方をいつでも切り替えることができます。

はい。Sitecore Identityを通じたOAuth 2.0認証を使用し、テナント隔離、短期間トークン、すべての操作に対する監査ログを備えています。

いいえ。サーバーはAIツールとAgent APIの間の安全な架け橋として機能します。コンテンツやプロンプト、パスワードを永久に保存するわけではなく、AIクライアントはあなたの認証情報を見たり、モデルトレーニングにデータを使用したりしません。

いいえ。ユーザーはSitecoreの役割と権限で許可された操作のみを実行できます。

重要な更新は必ず公開前に確認してください。サーバーはあなたの権限内で動作するため、既存の承認やレビューの手順は引き続き適用されます。

この記事を改善するための提案がある場合は、お知らせください!