--- title: "マーケターMCPツールの参考およびその他の情報" slug: "marketer-mcp-tool-reference-and-other-information" abstract: "Sitecore Marketer MCPサーバーツールの概要、トラブルシューティングのためのサポート情報、よくある質問をまとめています。" --- # マーケターMCPツールの参考およびその他の情報 このトピックでは、Sitecore Marketer MCPサーバーで利用可能なツールと、それらがどのようにSitecoreAIでアクションを実行するかについて詳しく説明します。また、機能の理解、トラブルシューティング、よくある質問への回答を見つけるためのサポートリソースも含まれています。 このセクションを使って利用可能なツールの探索、追加のガイダンス確認、マーケターMCPサーバーでの対応に関する問題の解決に活用してください。 - [ツールリファレンス](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#tool-reference "Tool reference") - [その他の技術情報](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#other-technical-information "Other technical information") - [トラブルシューティング](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#troubleshooting "Troubleshooting") - [よくある質問](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#faqs "FAQs") ## ツールリファレンス Sitecore Marketer MCPサーバー内のすべてのツールはデフォルトで有効化されています。完全な機能を確保するために、これらのツールは有効にしておくことをお勧めします。各ツールは[Agent API](https://api-docs.sitecore.com/ai-capabilities/agent-api)内のエンドポイントに対応しており、サーバーはSitecoreAI内の操作を行うためにそれを使用します。 以下の表は、ユースケースごとにグループ化された利用可能なツールを示しています: ### 敷地管理 ツール 概要 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](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#flow-definitions) variantIdが提供されていない場合、ツールはページのコンポーネントを返します。 set\_component\_datasource ページ上のコンポーネントのデータソースをセットまたはクリアします。 特定のパーソナライズやA/B/nテストバリアントのデータソースを更新する variantId を提供します。利用可能なバリアントIDを見つけるには [list\_page\_flows](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#flow-definitions)を使用します。 variantIdが提供されていない場合は、その変更はページに適用されます。 search\_site ページ名に合致する検索語を用いて特定のサイト内のページを検索します。このツールはページ本文やコンポーネントコンテンツを検索しません。 get\_page\_path\_by\_live\_url ウェブサイト上のライブURLに対応するページアイテムパスを取得します。 get\_page\_screenshot base64でエンコードされたページのスクリーンショットを取得します。 特定のパーソナライズやA/B/nテストバリアントのスクリーンショットを取得する variantId を提供します。利用可能なバリアントIDを見つけるには [list\_page\_flows](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#flow-definitions)を使います。 variantIdが提供されていなければ、スクリーンショットにページが表示されます。 get\_page\_html マークアップに埋め込まれたレイアウトJSONを含むページのHTMLコンテンツを取得します。HTMLレスポンスは通常数百KBです。 特定のパーソナライズやA/B/nテストバリアントのHTML内容を取得するための variantId を提供します。利用可能なバリアントIDを見つけるには [list\_page\_flows](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#flow-definitions)を使用します。 variantIdが提供されていない場合、ツールはページの内容HTML返します。 get\_page\_preview\_url ページプレビュー用のURLを取得します。 特定のパーソナライズやA/B/nテストバリアントのプレビューURLを取得するための variantId を提供します。利用可能なバリアントIDを見つけるには [list\_page\_flows](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#flow-definitions)を使用します。 variantIdが提供されていない場合、ツールはページのプレビューURLを返します。 get\_page\_template\_by\_id 特定のページテンプレートの詳細、フィールドや設定を取得します。 get\_page IDと言語コードによってページの詳細を取得します。 get\_allowed\_comps\_by\_ph ページ上のプレースホルダーに追加できるコンポーネントを取得します。 特定のパーソナライズやA/B/nテストバリアントで許可されたコンポーネントを取得するための variantId を提供します。利用可能なバリアントIDを見つけるには [list\_page\_flows](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#flow-definitions)を使用します。 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テナントでパーソナライズを有効にする必要があります。分析識別子を使って [サイトのパーソナライズを管理する方法](https://doc.sitecore.com/sai/en/users/sitecoreai/manage-personalization-and-analytics-for-sites.html) をご覧ください。 ツール 概要 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テナントでパーソナライズを有効にする必要があります。分析識別子を使って [サイトのパーソナライズを管理する方法](https://doc.sitecore.com/sai/en/users/sitecoreai/manage-personalization-and-analytics-for-sites.html) をご覧ください。 ツール 概要 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](https://doc.sitecore.com/sai/ja/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#flow-definitions)を使用します。 パーソナライズ専用の場合、 variantId が提供されていない場合、デフォルトのページバリアントのコンポーネントがリセットされます。 get\_flow\_definition フロー定義(A/B/nテストまたはパーソナライズ)を取得し、構造、バリエーション、構成を含みます。 get\_flow\_variant\_by\_id 特定のA/B/nテストやパーソナライズバリアントの詳細、データソースやコンポーネントを取得します。 ## 例示プロンプト Sitecore Marketer MCPサーバーは、自然言語プロンプトを使って一般的なマーケティングやコンテンツタスクを実行できるようにします。 > !重要MarketerのMCPサーバーは、ここに記載されたサポートされているユースケースでのみ信頼性があります。この範囲外の回答はSitecoreによって検証されておらず、不正確な場合があります。 以下の例は、異なるユースケースでサーバーとどのように相互作用するかを示しています。 敷地管理 - *テナント内の利用可能なすべてのサイトをリストアップしてください。* - *ハビタットサイトに関する情報を入手しましょう。* - *ハビタットサイトの全ページまたは特定のページを表示してください。* ページ管理 - *タイトルに「Spring Sale」などの特定の用語が含まれているページをSearchしてください*。 - *「ホームページのヒーローバナーには現在どんなテキストが表示されている?* - *Productsページですべてのティーザーコンポーネントを見つけて、その内容を見せてください。* - *「About Us」ページのどのコンポーネントに編集可能なデータソースがありますか?* - *コンポーネントデータソースのフィールドから、製品ページの最新の見出しやCTAテキストを取得しましょう。* - *フランス語版ホームページのフッタープロモーションコンポーネントに表示されているテキストを見つけてください。* - *Habitatのサイトにランディングページを作成し*ましょう。 - *ホームページにフランス語版を追加*してください。 - *お問い合わせページのHTMLコンテンツを取得してください。* Content Management - *テクノロジーセクションの下にAIトレンドに関する新しいブログ記事を作成し*ましょう。 - *ホームページのヒーローテキストを「イノベーションへようこそ」に更新*してください。 - *新しいコンテンツに使えるテンプレートをすべてリストアップしてください*。 コンポーネント管理 - *ホームページのメインプレースホルダーにヒーローコンポーネントを追加*してください。 - *ハビタットサイトで利用可能なすべてのコンポーネントをリストアップ*してください。 - *サイドバーの仮設に使えるコンポーネントを教えてください*。 資産運用 - *ヒーロータグ付きのすべての画像の代替テキストを更新*してください。 - *春のキャンペーンに関連する資産を探し*ましょう。 - *ブランドロゴの資産の詳細を入手*しましょう。 パーソナライズ - *ホームページでリピーター向けのパーソナライズ版を作成しましょう*。 - *製品ページのすべてのパーソナライズバージョンをリストアップ*してください。 - *リターンビジターバリアントの読者に10回以上の訪問記録を更新してください* ブランドキット - *組織内で入手可能なすべてのブランドキットをリストアップ*してください。 - *パワフルブランドのキットを回収してください*。 ブランドの文脈 - *私の組織で利用可能なすべてのブランドコンテキストをリストアップしてください。* - *ブランドコンテキストの構造を見せてくれれば、メッセージング文書が見つかります。* - *メッセージやポジショニング文書の全文をブランドの文脈で入手してください。* ブリーフ - *利用可能なすべてのブリーフタイプをリストアップ*してください。 - *イースターの新製品発売キャンペーンのブリーフを作成してください。* - *6月のマーケティングブリーフの目的の概要 - 15ユーロ予算*。 実験 - *ホームページのバナーコンポーネントに対してA/Bテストを作成し*てください。 - *バナーコンポーネントに追加されたA/B/nテストの目標を変更してください。* - *ホームページのバナーコンポーネント用に新しいテストバリアントを追加*してください。 フローの定義 - *ホームページに利用可能なすべてのA/B/nテストをリストアップ*してください。 - *パーソナライズの流れについてはホームページでご確認ください。* - *A/BテストのバリアントBを設定し、元のコンポーネントとサインアップバナーを交換します。* ## その他の技術情報 このセクションでは、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を拡張します。 - **テナント処理** - テナントコンテキストを自動的に検出します。 - **トークン管理** - 安全なセッションのための認証トークンを管理します。 - **スマートオーケストレーション** - 複数のAPI呼び出しを簡易化した動作にまとめます。 - **データの整合** 性 - データの検証と標準化。 - **アクセス境界** - ユーザーのテナントに限定;テナント間または上位アクセス禁止。 - **セキュリティコントロール** - Sitecoreの既存のロールベース権限を強制します。 - **監査とコンプライアンス** - 透明性とトレーサビリティのためにすべての業務を追跡します。 ## トラブルシューティング このセクションでは、Marketer MCPサーバーを使用する際によくある問題を特定し解決するのに役立ちます。 ### アクセスおよび権限の問題 サインインできない場合は、期待するツールが表示されるか、*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サーバーの応答が遅いか接続に失敗した場合: - 数秒待ってから再度試してください(レート制限が適用される場合があります:10秒あたり50リクエスト)。 - インターネット接続とVPNの状態を確認してください。 - マリファルスやプロキシがそのエンドポイントURLを許可していることを確認してください。 ### サポートに連絡するタイミング 問題が続く場合は、エラーメッセージ、テナント、実行されたアクションなどの詳細を収集し、[サポートケースを作成し](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/create-a-support-case.html)ましょう。 ## よくある質問 このセクションでは、Marketer MCPに関する最もよくある質問にお答えします。 ### アクセスと設定 #### MarketerのMCPサーバーを使うにはSitecoreアカウントが必要ですか? はい。有効なSitecore認証情報と、組織およびテナントに適した権限が必要です。MarketerのMCPは既存のSitecoreアクセス制御とユーザーロールを尊重しています。 #### 始めるには何が必要ですか? 必要なもの: - Marketer MCPサーバーによるSitecore環境へのアクセス - 有効なSitecore認証情報 - ClaudeやCursorのようなMCP互換AIクライアント。 #### 誰がマーケターMCPを使えますか? Marketer MCPは、マーケター、コンテンツ作成者、開発者、パートナー、そして対応MCPクライアントを通じてSitecoreに接続する認可AIシステムによって使用できます。 #### Marketer MCPを使うには技術的なスキルが必要ですか? いいえ。Marketer MCPは、ユーザーがコードを書いたりAPI呼び出しを行う代わりに、自然言語命令を通じてサポートされているSitecoreタスクを管理できるようにします。 ### 仕組み #### Marketer MCPはAgent APIとどのように連携していますか? マーケターMCPはSitecoreでサポートされているアクションを実行するためにAgent APIを使用します。 AIクライアントがリクエストを受け取ると、適切なMarketer MCPツールを選択し、Agent APIに構造化リクエストを送信して実行させます。 #### Sitecoreのユーザーインターフェースはまだ使えますか? はい。Marketer MCPはSitecoreと連携するための追加の方法を提供し、標準のSitecoreインターフェースの代わりにはなりません。 どちらの経験も課題に応じて活用できます。 ### セキュリティと許可 #### MarketerのMCPサーバーは安全ですか? Marketer MCPはSitecoreの既存のセキュリティモデル内で動作し、認証、テナント隔離、短命トークン、権限チェック、監査ログなどの制御を用いています。 #### マーケターMCPは私のデータや資格情報を保存または公開していますか? Marketer MCPはAIクライアントとSitecore APIの間の橋渡し役を果たします。データ処理や保持は、AIクライアント、モデルプロバイダー、展開設定にも依存する場合があります。 機密情報を提出する前に、該当するSitecoreおよびAIプロバイダーのドキュメントを必ず確認してください。 #### どのユーザーでも何か行動ができますか? いいえ。ユーザーは割り当てられたSitecoreの役割と権限によって許可された操作のみを実行できます。 AIクライアントの使用は追加アクセス権を与えたり、Sitecoreの認証管理を回避したりしません。 ### レビューとガバナンス #### もしAIがミスをしたり、間違った変更を適用したらどうなるのでしょうか? 重要な変更点を公開する前に必ず確認してください。 Marketer MCPを通じて行われる操作は、ユーザーの許可および適用されるSitecoreのレビュー、承認、バージョン管理、公開ワークフローの対象となります。