Model Context Protocol server for Sitecore

Sitecore Community MCP

このリポジトリには、Sitecore Community MCP サーバーのソースコードが含まれています。これは、AI エージェントに Sitecore への直接的な読み取り／書き込みアクセスを提供するオープンソースのModel Context Protocolサーバーです。エージェントと Content Editor の間でコピー＆ペーストする必要がなくなります。

• 検索、クエリ、作成、読み取り、更新、削除、メディア、PowerShell、ロギング、セキュリティ、プレゼンテーションにわたる121 個のツール
• 3 つのガイド — guide://compose-page、guide://bulk-update、guide://diagnose-connection。エージェントがタスクの途中で読み取れるリソースです。この MCP を使いたいと思うような、一般的で複雑なワークフロー 2 つに加え、接続の問題を自己診断するためのヘルパーを提供します。
• Authoring and Management GraphQL API、Item Service、GraphQL Edge、Sitecore PowerShell Extensions の 4 つの Sitecore API サーフェスに対応
• あらゆる MCP 対応クライアントから、SitecoreAI および Sitecore XM/XP（全バージョン）で動作
• MCP プロトコルリビジョン 2026-07-28 を実装し、同じツール登録を使って旧形式の initialize ハンドシェイクにも応答します。2025-11-25 から 2024-10-07 までの任意のリビジョンにネゴシエーションで対応するため、どちらの世代のクライアントでも同じツールを利用できます。
• 報告されている効果：Figma から Sitecore へのワークフローが5 倍高速化し、手動の足場づくりが約 70％削減されます（事例）。
• 実行方法は npm、Docker、ソースからの 3 通りです。

Sitecore Community MCP の始め方

Sitecore Community MCP サーバーを実行するには、次のものが必要です。

• Node — 最新の長期サポート（LTS）リリース。
• Sitecore XM、XP、または SitecoreAI のインスタンス。どの機能を有効にするかによって、使用できるツールが決まります。authoring.* グループには Authoring and Management API（クラウドでは通常すでに有効）とトークンだけが必要ですが、Item Service と SPE Remoting はデフォルトで無効になっており、設定パッチが必要です。Sitecore インスタンスの準備では、3 つすべての設定方法と、それぞれの確認方法を説明しています。

MCP クライアントへのサーバーの追加

以下のエントリをクライアントのサーバーマップに追加します。Cursor、Claude Code、その他のほとんどのクライアントでは mcpServers、VS Code では servers を使用し、独自のエンドポイントと認証情報を設定してください。

{
  "mcpServers": {
    "sitecore-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@antonytm/mcp-sitecore-server@latest"],
      "env": {
        "TRANSPORT": "stdio",
        "GRAPHQL_ENDPOINT": "https://xmcloudcm.localhost/sitecore/api/graph/",
        "GRAPHQL_SCHEMAS": "edge",
        "GRAPHQL_API_KEY": "{6D3F291E-66A5-4703-887A-D549AF83D859}",
        "GRAPHQL_HEADERS": "",
        "ITEM_SERVICE_DOMAIN": "sitecore",
        "ITEM_SERVICE_USERNAME": "admin",
        "ITEM_SERVICE_PASSWORD": "b",
        "ITEM_SERVICE_SERVER_URL": "https://xmcloudcm.localhost/",
        "POWERSHELL_DOMAIN": "sitecore",
        "POWERSHELL_USERNAME": "admin",
        "POWERSHELL_PASSWORD": "b",
        "POWERSHELL_SERVER_URL": "https://xmcloudcm.localhost/",
        "AUTHORING_CLIENT_ID": "",
        "AUTHORING_CLIENT_SECRET": "",
        "TOOL_PROFILE": ""
      }
    }
  }
}

TOOL_PROFILE にはプリセットをカンマ区切りで指定でき、各プリセットで非表示になる項目が統合されます。各プリセットは、プラットフォームではなく、存在しないもの、または不要なものを指定します。4 つのプリセット、no-spe、no-item-service、no-edge-graphql、no-authoring-api は、インスタンスが提供していない API サーフェスを指定するものです。そのため、2 つのサーフェスがないインスタンスでは、その旨を指定できます。no-account-management は、欠けているサーフェスを指定するものではありません。CM 上でアカウントを作成または編集する 12 個のツールを非表示にするもので、エージェントにそうした操作を一切許可したくないデプロイ向けです（アイテムのセキュリティ設定、アカウントとロールの読み取りには影響しません）。

TOOL_PROFILE=no-spe,no-item-service

no-spe は最も重要なプリセットです。SPE がインストールされ、remoting サービスが有効になっていない場合、このサーバーのツールのおよそ 4 分の 3 は実行できません。それらを非表示にすれば、エージェントが毎ターン考慮するスキーマを減らせます。不明な名前は stderr に報告されて無視され、リスト内の残りの設定は適用されます。

各設定については、Configuration に記載されています。エージェントが保持できるツールの数には上限があるため、作業を進める前にツールの選択を読み、TOOL_PROFILE、TOOL_GROUPS、DISABLED_TOOLS を使ってサーフェスを絞り込んでください。

コンテナー内で、またはソースからサーバーを実行する方法については、サーバーの実行を参照してください。

Sitecore Marketer MCP との比較

Sitecore 独自のMarketer MCPは、SitecoreAI を利用するマーケター向けのホステッドサービスです。このサーバーは開発者向けの対応製品であり、その点ではこちらのほうが優れたツールです。

	Sitecore Community MCP	Sitecore Marketer MCP
プラットフォーム	SitecoreAI および XM/XP、すべてのバージョン — ローカルの Docker CM を含む	SitecoreAI のみ
ホスティング	セルフホスト（npm、Docker、ソース）；認証情報がインフラストラクチャの外に出ることはありません	Sitecore がホスト；クラウド経由の OAuth
対応範囲	開発者向け機能全般にわたる 121 個のツール：アイテム、テンプレート、プレゼンテーション、メディア、セキュリティ、インデックス作成、ログ、パブリッシュ、GraphQL、生の PowerShell	マーケター向け操作：ページ、コンポーネント、ブリーフ、ブランドキット、パーソナライゼーション、A/B テスト
代替手段	run-powershell-script、生の Edge GraphQL、生の Authoring GraphQL — ツールが存在しなくても、その機能は利用できます	クローズドなツールセット
レイアウトの安全性	add-rendering-to-placeholder は、プレースホルダー設定で許可されていないコンポーネントを拒否し、許可リストを示します	書き込み時にプレースホルダー設定との照合は行われません
ツールの制御	TOOL_GROUPS / DISABLED_TOOLS / TOOL_PROFILE により、ターンごとのスキーマコストを削減できます	固定のツールリスト

両者は排他的ではなく、相互に補完するものです。Marketer MCP は、このサーバーには API がないクラウドマーケティング機能（ブリーフ、ブランドキット、パーソナライゼーションのバリエーション、A/B テスト）を備えており、クライアントが両方に接続することもできます。Sitecore ソリューションの構築、移行、監査、運用には、このサーバーがより幅広く対応します。

ドキュメントとコミュニティリソース

• Sitecore インスタンスの準備 — SPE Remoting、Item Service、GraphQL キー、およびそれらを有効にする設定パッチ
• サーバーの実行 — npm、Docker、ソースからの実行、および 2 種類のトランスポート
• ツールリファレンス — API の機能領域ごとにまとめた全ツール
• 設定 — 環境変数、トランスポート、タイムアウト、TLS
• ツールの選択 — TOOL_GROUPS、DISABLED_TOOLS、TOOL_PROFILE
• ガイド — guide://compose-page、guide://bulk-update、guide://diagnose-connection リソース、およびそれぞれが提示されるタイミング
• Docker イメージ — 公開済みの Linux および Windows イメージ
• 変更履歴 — 2.0 の新機能と破壊的変更

コミュニティリソース：

• Model Context Protocol の仕様
• Sitecore PowerShell Extensions のドキュメント
• Sitecore Stack Exchange
• Sitecore Community Slack
• Sitecore Community Forum

貢献

バグ修正や改善に貢献してくださるコミュニティの皆さまに、心より感謝いたします。このサーバーの発展と改善に向けたあらゆる取り組みを歓迎します。参加方法については、以下をご覧ください。

貢献ガイド

開発プロセス、バグ修正や改善の提案方法、変更内容のビルド、デバッグ、テスト方法については、貢献ガイドをご覧ください。

ライセンス

Sitecore Community MCP は、Apache 2.0 ライセンスを使用しています。

サポート

これはコミュニティプロジェクトであり、Sitecore によるサポートはありません。

• 問題、バグ、機能リクエスト： Antonytm/mcp-sitecore-server/issues でイシューを作成してください。
• Sitecore 自体に関する質問： GitHub のイシューよりも、Sitecore Stack Exchange または Sitecore Community Slack のほうが適しています。