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

敷地管理

ツール

概要

list_sites

ID、名前、ターゲットホスト名、ルート項目などの基本情報を含む利用可能なサイトの一覧を取得します。

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

ページ上のコンポーネントを取得し、各コンポーネントごとにアイテムID、名前、テンプレート、フィールド値、子項目を含む解決済みの dataSourceItem を含みます。このツールを使って、コンポーネントデータソースのコンテンツから現在ページ上に表示されるテキストを見つけられます。

特定のパーソナライズやA/B/nテストバリアントのコンポーネントを取得するための variantId を提供します。利用可能なバリアントIDを見つけるには 、list_page_flows

variantIdが提供されていない場合、ツールはページのコンポーネントを返します。

set_component_datasource

ページ上のコンポーネントのデータソースをセットまたはクリアします。

特定のパーソナライズやA/B/nテストバリアントのデータソースを更新する variantId を提供します。利用可能なバリアントIDを見つけるには list_page_flowsを使用します。

variantIdが提供されていない場合は、その変更はページに適用されます。

search_site

ページ名に合致する検索語を用いて特定のサイト内のページを検索します。このツールはページ本文やコンポーネントコンテンツを検索しません。

get_page_path_by_live_url

ウェブサイト上のライブURLに対応するページアイテムパスを取得します。

get_page_screenshot

base64でエンコードされたページのスクリーンショットを取得します。

特定のパーソナライズやA/B/nテストバリアントのスクリーンショットを取得する variantId を提供します。利用可能なバリアントIDを見つけるには list_page_flowsを使います。

variantIdが提供されていなければ、スクリーンショットにページが表示されます。

get_page_html

マークアップに埋め込まれたレイアウトJSONを含むページのHTMLコンテンツを取得します。HTMLレスポンスは通常数百KBです。

特定のパーソナライズやA/B/nテストバリアントのHTML内容を取得するための variantId を提供します。利用可能なバリアントIDを見つけるには list_page_flowsを使用します。

variantIdが提供されていない場合、ツールはページの内容HTML返します。

get_page_preview_url

ページプレビュー用のURLを取得します。

特定のパーソナライズやA/B/nテストバリアントのプレビューURLを取得するための variantId を提供します。利用可能なバリアントIDを見つけるには list_page_flowsを使用します。

variantIdが提供されていない場合、ツールはページのプレビューURLを返します。

get_page_template_by_id

特定のページテンプレートの詳細、フィールドや設定を取得します。

get_page

IDと言語コードによってページの詳細を取得します。

get_allowed_comps_by_ph

ページ上のプレースホルダーに追加できるコンポーネントを取得します。

特定のパーソナライズやA/B/nテストバリアントで許可されたコンポーネントを取得するための variantId を提供します。利用可能なバリアントIDを見つけるには list_page_flowsを使用します。

variantIdが提供されていない場合、ツールはページに許可されたコンポーネントを返します。

Content Management

ツール

概要

create_content_item

指定されたテンプレートとフィールド値を使って新しいコンテンツ項目を作成します。

update_content

既存のコンテンツ項目を更新し、そのフィールドや言語も含めて更新します。項目が最終または承認済みのワークフロー状態にある場合、更新によって自動的に新しいバージョンが作成されます。このツールはアイテムを公開しないため、公開するまで変更は有効になりません。

delete_content

コンテンツ項目を削除し、オプションで子項目をすべて削除します。

> [!警告]
> 言語クエリパラメータは現在使用されていません。そのコンテンツ項目全体が、その値に関係なく削除されます。

get_content_item_by_path

コンテンツツリー内のパスを指定することで、コンテンツアイテムの詳細を取得します。

get_content_item_by_id

特定のコンテンツ項目のIDを指定することで詳細を取得します。

list_avail_insertopts

指定された親項目の下に子項目として挿入可能なコンテンツテンプレートのリストを取得します。

update_fields_on_item

コンテンツ項目のフィールドを更新します。

コンポーネント管理

ツール

概要

list_components

特定のサイトで利用可能なコンポーネントのリストを取得します。

get_component

特定のコンポーネントの詳細、ID、名前、データソースオプションを取得します。

create_component_ds

提供されたデータフィールドの値を使って、特定のコンポーネントに対して新しいデータソース項目を作成します。

search_component_ds

特定のコンポーネントで利用可能なデータソースを検索します。

資産運用

ツール

概要

search_assets

クエリ用語、ファイル形式、タグを使って動画、画像、ドキュメントなどのデジタル資産を検索できます。

get_asset_information

特定のデジタル資産のIDを指定することで詳細を取得します。

update_asset

既存のデジタル資産のメタデータやプロパティ(代替テキスト、説明、タグなど)を更新します。

パーソナライズ

!重要これらのツールを使用する前に、SitecoreAIテナントでパーソナライズを有効にする必要があります。分析識別子を使って サイトのパーソナライズを管理する方法 をご覧ください。

ツール

概要

get_perso_ver_by_page

特定のページに定義されたすべてのパーソナライズバリアントを取得します。

create_perso_version

特定のオーディエンス向けに条件を使って新しいパーソナライゼーションのバリエーションを作成します。

create_perso_version_multi

特定のオーディエンス向けに、1つまたは複数の条件を用いてページの新しいパーソナライズバリアントを作成します。

get_perso_cond_tmpls

パーソナライズ用の利用可能なすべての条件テンプレートを取得します。

get_perso_cond_tmpl_by_id

ページ上でパーソナライズバリアントを作成するためのパラメータを含む条件テンプレートをIDで取得します。

update_perso_version

パーソナライズバリアントのオーディエンス名、バリアント名、ターゲティングルールを更新します。

hide_component_perso_default_page

デフォルトのページバリアントでコンポーネントを隠します。このツールを使う前に、パーソナライズがすでにページ上に存在していなければなりません。デフォルトのページバリアントは、ページをパーソナライズするために作成された後にのみ存在します。

ブランドキット

ツール

概要

list_brandkits

利用可能なすべてのブランドキットを取得し、名前、ID、ブランド、会社、ステータスを含みます。

get_brandkit_by_id

ブランドキットのIDによる詳細、セクションおよび関連するフィールド(サブセクション)を取得します。

ブランドの文脈

ツール

概要

list_brand_contexts

組織内で利用可能なブランドコンテキストを一覧にし、メタデータのみを返します。

get_brand_context

ブランドコンテキストのメタデータや、入れ子リストされたフォルダおよびファイルツリーのインデックスを取得します。

get_brand_context_items

1回のバッチ通話で最大50個のブランドコンテキストファイルまたはフォルダを取得します。ファイル応答にはMarkdownコンテンツが含まれます。

ブリーフ

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

ツール

概要

list_brief_types

利用可能なすべてのブリーフタイプ(名前、ラベル、IDを含む)を取得します。

list_briefs

利用可能なすべてのブリーフを取得し、ステータス、作成者、ブリーフタイプによるオプションのソートとフィルタリングが可能です。

generate_brief_draft

選択したブランドキットとブリーフタイプに基づいて新しいブリーフドラフを作成してレビューします。ドラフトは create_brief_from_draft 使用されるまで保存されません。

create_brief_from_draft

以前に作成されたブリーフ草稿から新しいブリーフを作成・保存します。

generate_brief_revision

更新された指示に基づいてレビュー用の改訂ブリーフ草稿を作成します。既存のブリーフは update_brief_from_revision が使用されるまで変更されません。

update_brief_from_revision

既存のブリーフを生成された簡潔な改訂から更新・保存します。

get_brief_type_by_id

IDでブリーフ型の詳細を取得し、フィールド定義や監査メタデータを含みます。

get_brief_by_id

特定のブリーフをIDで取得し、フィールド、型参照、監査メタデータなどを含みます。

実験

!重要これらのツールを使用する前に、SitecoreAIテナントでパーソナライズを有効にする必要があります。分析識別子を使って サイトのパーソナライズを管理する方法 をご覧ください。

ツール

概要

create_component_ab_test

サイト、ページ、コンポーネントの詳細、バリエーション、目標を使ってページコンポーネントの新しいA/B/nテストを作成します。

update_ab_test

既存のA/B/nテストをバリアント、ターゲティングルール、設定を変更して更新してください。

フローの定義

ツール

概要

list_page_flows

A/B/nテストやパーソナライズを含むページのすべてのフロー定義を取得し、構造、バリアント、構成も含めて取得します。

set_component_variant

元のコンポーネントをコピー、隠し、または入れ替えすることで、特定のA/B/nテストやパーソナライズのためのバリアントを設定します。

reset_component_variant

コンポーネントから適用されたパーソナライズやA/B/nテストのバリアント設定(コピー、隠し、スワップなど)を削除し、元の状態に復元します。

特定のパーソナライズやA/B/nテストのバリアントをリセットするための variantId を提供します。利用可能なバリアントIDを見つけるには list_page_flowsを使用します。

パーソナライズ専用の場合、 variantId が提供されていない場合、デフォルトのページバリアントのコンポーネントがリセットされます。

get_flow_definition

フロー定義(A/B/nテストまたはパーソナライズ)を取得し、構造、バリエーション、構成を含みます。

get_flow_variant_by_id

特定のA/B/nテストやパーソナライズバリアントの詳細、データソースやコンポーネントを取得します。

技術仕様

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

特性

概要

プロトコル

JSON-RPC 2.0ベースのAPI形式を使用しています。

司会

エッジのパフォーマンスとスケーラビリティのためにCloudflare Workers上でホストしています。

APIフォーマット

JSON応答を持つOpenAPI RESTエンドポイント。

モニタリング

パフォーマンストラッキングのための観察可能性と監査の軌跡。

セキュリティとコンプライアンス

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

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

能力と制限

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

• テナント処理 - テナントコンテキストを自動的に検出します。
• トークン管理 - 安全なセッションのための認証トークンを管理します。
• スマートオーケストレーション - 複数のAPI呼び出しを簡易化した動作にまとめます。
• データの整合 性 - データの検証と標準化。
• アクセス境界 - ユーザーのテナントに限定;テナント間または上位アクセス禁止。
• セキュリティコントロール - Sitecoreの既存のロールベース権限を強制します。
• 監査とコンプライアンス - 透明性とトレーサビリティのためにすべての業務を追跡します。

アクセスおよび権限の問題

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

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

リソースパラメータは必要エラーです

OAuth認証中にResource parameter is requiredエラーに遭遇した場合:

• 認可URLにresourceクエリパラメータが必要な場合もあります。

• 認可URLに以下のパラメータを追加してください:

  &resource=https%3A%2F%2Fmarketer.sitecorecloud.io%2Fmcp%2Fmarketer-mcp-prod

• 認証を続けるには、新しいブラウザウィンドウで更新されたURLを開きます。

ツールが表示されない

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

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

接続エラーやタイムアウトエラー

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

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

サポートに連絡するタイミング

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

アクセスと設定

仕組み

セキュリティと許可

レビューとガバナンス