mcpField
M
marketplace-add-xmc

marketplace-add-xmc

github.com/vercel-labs開発557 回インストール30 週間前に更新
リポジトリ

marketplace-add-xmc について

Sitecore Marketplace アプリに XM Cloud API 連携を追加するためのスキルです。必要な API の選定と、クライアント側またはサーバー側の実装方法を支援します。

主な機能

  1. 01XM Cloud API の選択
  2. 02クライアント側・サーバー側の選択
  3. 03API 実装パターンの参照
  4. 04関連する Marketplace スキルの提案

活用シーン

  1. 01サイトやページのデータアクセス追加
  2. 02Authoring API クエリの実装
  3. 03コンテンツのインポート・エクスポート
  4. 04XM Cloud エージェントの呼び出し

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vercel-labs/sitecore-skills --skill marketplace-add-xmc

インストール後、Claude Code で/marketplace-add-xmcを入力して読み込まれたか確認します。

同梱ファイルreferences/xmc-patterns.md

詳細

XM Cloud API 統合の追加

ユーザーが Sitecore Marketplace アプリに XM Cloud API 統合を追加するのを支援します。

前提条件

XMC パッケージがインストールされている必要があります。インストールされていない場合：

npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/xmc.json

ステップ 1：使用する API を決定する

ユーザーに確認するか、$ARGUMENTS から推測して、必要な XMC API を特定します：

API名前空間用途
Sitesxmc.sites.*サイトの一覧表示・取得、現在のサイトコンテキスト
Pagesxmc.pages.*ページの一覧表示・取得、現在のページコンテキスト
Authoringxmc.authoring.*Authoring API に対する GraphQL クエリ／ミューテーション
Content Transferxmc.contentTransfer.*コンテンツのインポート／エクスポート
Searchxmc.search.*コンテンツアイテムの検索
Agentxmc.agent.*XM Cloud エージェントの呼び出し

ステップ 2：クライアント側かサーバー側かを選択する

  • クライアント側：client.query() ／ client.mutate() を使用します。よりシンプルで、あらゆるアーキテクチャで動作します
  • サーバー側：experimental_createXMCClient() を使用します。Auth0 が必要です（フルスタックアーキテクチャ）

ステップ 3：実装する

各 API の完全なコードパターンについては、xmc-patterns.md を参照してください。

ステップ 4：関連するスキルを提案する

  • データの UI を構築するには、/marketplace-build-component を使用します
  • 詳細な型情報については、/marketplace-sdk-reference を使用します

参考ファイル

コメント

Markdown 対応