Sanity

Sanity Agent Toolkit

AI エージェントが Sanity を活用してより良い開発を行えるよう支援するリソース集です。Cursor、Claude Code、Codex、VS Code、Lovable、v0、Replit、OpenCode、および MCP または Agent Skills に対応するその他のエディター／エージェントをサポートしています。

機能

• MCP サーバー： Sanity プロジェクト（コンテンツ、データセット、リリース、スキーマ）とエージェントルールに直接アクセスできます。
• エージェントスキル： Sanity 開発、コンテンツモデリング、SEO/AEO、実験に関する包括的なベストプラクティススキルです。25 件の統合／トピックガイドと、26 件の対象を絞ったベストプラクティスルールが含まれています。
• Agent Plugin： Agent Plugins 対応クライアント向けの plugin.json、skills/、mcp.json コンポーネントです。
• Claude Code plugin： Claude Code ユーザー向けの MCP サーバー、エージェントスキル、スラッシュコマンドです。公式 Anthropic plugin marketplace で利用できます。
• Cursor plugin： Cursor Marketplace の MCP サーバー、エージェントスキル、コマンドです。
• Codex plugin： OpenAI Codex ユーザー向けの MCP サーバーとエージェントスキルです。

はじめに

エージェントに Sanity をどのように利用させるかに応じて、方法を選択してください。

1. MCP サーバー — エージェントに、常に最新のルールと Sanity プロジェクトへのフルアクセスを提供します。ローカルファイルの管理は不要です。Cursor、VS Code、Claude Code、Lovable、v0、Replit、OpenCode、およびその他の MCP 対応クライアントで動作します。
2. エージェントスキル — Sanity、コンテンツモデリング、SEO/AEO、実験に関するベストプラクティススキルをインストールします。Cursor、Claude Code、および Agent Skills 対応のあらゆるエージェントで動作します。
3. プラグイン — Cursor、Claude Code、または Agent Plugins 対応クライアント向けの Sanity プラグインをインストールします。MCP サーバー、エージェントスキル、コマンドが含まれています。
4. 手動インストール — オフラインで使用するため、スキルのリファレンスをローカルにコピーします。更新はご自身で行う必要があります。

オプション 1：MCP サーバーをインストールする（推奨）

MCP サーバーを通じて、エージェントに Sanity プロジェクトへの直接アクセスと、常に最新のエージェントルールを提供します。

Sanity CLI から簡単にインストール

ターミナルで実行すると、Cursor、Claude Code、VS Code 向けの MCP を自動的に検出して設定します。

npx sanity@latest mcp configure

認証にはログイン済みの CLI ユーザーを使用するため、手動でトークンや OAuth を設定する必要はありません。

クライアント固有の手順

{
  "mcpServers": {
    "Sanity": {
      "type": "http",
      "url": "https://mcp.sanity.io"
    }
  }
}

claude mcp add Sanity -t http https://mcp.sanity.io --scope user

codex mcp add Sanity --url https://mcp.sanity.io

[mcp_servers.Sanity]
url = "https://mcp.sanity.io"

{
  "servers": {
    "Sanity": {
      "type": "http",
      "url": "https://mcp.sanity.io"
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sanity": {
      "type": "remote",
      "url": "https://mcp.sanity.io",
      "oauth": {}
    }
  }
}

{
  "mcpServers": {
    "Sanity": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.sanity.io", "--transport", "http-only"]
    }
  }
}

認証とトラブルシューティング

手動でのMCP設定では、デフォルトでOAuthを使用します。代わりにトークン認証を使用するには、MCP設定で Authorization: Bearer <token> ヘッダーを設定します。CLIの設定後に認証に失敗した場合は、npx sanity@latest mcp configure を再実行し、MCPクライアントを再起動してください。OAuthのリセットに関する問題については、Cursorには Cursor: Clear All MCP Tokens、VS Codeには Authentication: Remove Dynamic Authentication Providers があります。

認証方法とトラブルシューティングについては、Sanity MCP ドキュメントをご覧ください。

オプション 2：Agent Skills をインストールする

あらゆるAgent Skills互換エージェントで使える、ベストプラクティスのスキルをインストールします。

npx skills add sanity-io/agent-toolkit

プラグインのインストールについては、オプション 3をご覧ください。

オプション 3：プラグインをインストールする

Sanity プラグインをインストールすると、MCP サーバー、エージェントスキル、コマンドを利用できます。 Claude Code マーケットプレイス、Cursor Marketplace、またはこのリポジトリのAgent Pluginとして入手できます。

Claude Code

Sanity プラグインは、公式の Anthropic プラグインマーケットプレイスに掲載されています。公式マーケットプレイス（claude-plugins-official）は Claude Code の起動時に事前登録されるため、カスタムマーケットプレイスを追加する必要はありません。

Claude Code からインストールします。

/plugin install sanity@claude-plugins-official

プラグインが見つからない場合は、マーケットプレイスのカタログを更新して、もう一度試してください。

/plugin marketplace update claude-plugins-official

次に /reload-plugins を実行すると、再起動せずに有効化できます。

別の方法：対話形式でインストール

1. /plugin を実行し、Discover タブを開きます
2. Sanity を検索します
3. インストールを確定する前に、プラグインでインストールされるコマンド、スキル、フック、MCP サーバーを確認します（Anthropic は、インストール前にプラグインの権限とソースを確認することを推奨しています）
4. インストールするスコープを選択します。
   • User（デフォルト）：このマシン上のすべてのプロジェクト
   • Project：.claude/settings.json を通じて共同作業者と共有
   • Local：このリポジトリのみ
5. /reload-plugins を実行すると、再起動せずに有効化できます

インストールの確認： Claude Code に「どのスキルを利用できますか？」と尋ねてください。

Sanity のスキルが表示されます。

使い始める： 自然言語で指示すると、スキルが自動的に有効になります。

Sanity でブログ投稿のスキーマを作成するのを手伝ってください

GROQ クエリと Next.js Visual Editing の設定を確認してください

または /sanity を実行して、すべての機能を確認してください。

Cursor

Cursor チャットで次のコマンドを実行し、Cursor Marketplace からインストールします。

/add-plugin sanity

インストールの確認： Cursor に「どのスキルを利用できますか？」と尋ねてください。

Sanity のスキルが表示されます。

使い始める： 自然言語で指示すると、スキルが自動的に有効になります。

Sanity でブログ投稿のスキーマを作成するのを手伝ってください

GROQ クエリと Next.js Visual Editing の設定を確認してください

Codex

1. Sanity マーケットプレイスを追加します。

codex plugin marketplace add sanity-io/agent-toolkit

2. Codex のプラグインディレクトリからプラグインをインストールします（Sanity Agent Toolkit マーケットプレイスを選択し、Sanity をインストールします）。

3. Codex を再起動します。「どのスキルを利用できますか？」と尋ねて確認してください。Sanity のスキルが表示されます。

オプション 4：手動インストール

スキルの参照情報をローカルにインストールし、エディターに Sanity のベストプラクティスを学習させます。

1. skills/sanity-best-practices/ をプロジェクトにコピーします。
2. （推奨）AGENTS.md をプロジェクトのルートにコピーし、ナレッジルーターとして使用します。

機能

MCP ツール

MCP を接続すると、AI は次のようなツールを使用できます。

• query_documents — GROQ クエリを直接実行します
• create_documents — 構造化コンテンツからドラフトドキュメントを作成します。または、リリース ID が指定されている場合はドキュメントのバージョンを作成します
• patch_documents — 既存ドキュメントをピンポイントで編集します。公開済みドキュメントを編集する場合は、ドラフトを作成または更新します
• publish_documents / unpublish_documents — ドキュメントのライフサイクルを管理します
• deploy_schema / get_schema — MCP 管理スキーマをデプロイし、デプロイ済みスキーマを確認します
• deploy_studio — MCP 管理スキーマに紐付けられたホスト型 Studio をデプロイします
• create_release / list_releases — コンテンツリリースを作成して確認します
• create_version — リリース用のバージョンドキュメントを作成します
• generate_image / transform_image — AI による画像生成と編集を行います
• whoami — 認証済みの Sanity ユーザーを確認します
• get_project_studios — プロジェクトにリンクされた Studio アプリケーションを一覧表示します
• search_docs / read_docs — Sanity のドキュメントを検索して読み込みます
• list_sanity_rules / get_sanity_rules — エージェントルールを必要に応じて読み込みます
• give_feedback — MCP ツールのエラー、機能の不足、わかりにくい出力、ドキュメントの問題を報告します

MCP 管理スキーマは、Studio でデプロイされたスキーマやレガシースキーマより優先して解決されます。deploy_schema でスキーマを変更した場合は、該当する MCP 管理 Studio を deploy_studio で再デプロイし、最新のスキーマを反映してください。instruction を指定した generate_image、transform_image、create_version は、Sanity AI クレジットを消費します。

利用可能なツールの全一覧をご覧ください。

エージェントスキル

Claude Code、Cursor、GitHub Copilot などのエージェントが自動的に検出して使用できる、ベストプラクティスのスキルです。スキルは Agent Skills 形式に準拠しています。インストール方法については、オプション 2をご覧ください。

はじめ方の流れ

オンボーディングガイドは、次の 3 つのフェーズに沿って進みます。

1. Studio とスキーマ — Sanity Studio をセットアップし、コンテンツモデルを定義します
2. コンテンツ — 既存のコンテンツをインポートするか、MCP を使ってプレースホルダーコンテンツを生成します
3. フロントエンド — アプリケーションに統合します（フレームワークに応じた手順）

「Sanity を始める」と言うだけで開始できます。

スラッシュコマンド（Claude Code）

リポジトリ構成

注記： skills/sanity-best-practices/references/ 内の参照ファイルは、Sanity MCP サーバーの list_sanity_rules / get_sanity_rules ツールの正規コンテンツです。各ファイルには、有効な name と description のフロントマターが必要です。ルール名はファイル名から導出されます（例：nextjs.md → nextjs）。

sanity-io/agent-toolkit/
├── AGENTS.md                      # Knowledge router & agent behavior
├── README.md                      # This file
├── plugin.json                    # Portable Agent Plugins v1 manifest
├── mcp.json                       # Portable Agent Plugins v1 MCP configuration
├── .agents/plugins/               # Codex marketplace
│   └── marketplace.json           # Codex marketplace metadata
├── .claude-plugin/                # Claude Code plugin configuration (distributed via claude-plugins-official)
│   ├── plugin.json                # Plugin manifest (name: sanity)
│   └── marketplace.json           # Marketplace manifest for repo-based discovery
├── .codex-plugin/                 # Codex plugin configuration
│   └── plugin.json                # Codex plugin manifest
├── .cursor-plugin/                # Cursor plugin configuration (distributed via cursor.com/marketplace)
│   ├── marketplace.json           # Cursor marketplace metadata
│   └── plugin.json                # Per-plugin manifest
├── .mcp.json                      # Legacy client MCP compatibility configuration
├── assets/                        # Plugin branding
│   └── logo.svg                   # Sanity logo for marketplace display
├── commands/                      # Agent commands
│   ├── sanity.md                  # /sanity help
│   ├── sanity-review.md           # /sanity-review
│   ├── typegen.md                 # /typegen
│   └── deploy-schema.md           # /deploy-schema
├── scripts/                       # Validation and CI scripts
│   ├── validate-agent-plugin.mjs  # Validate manifests against the v1 JSON Schemas
│   └── validate-cursor-plugin.mjs # Cursor plugin validator
└── skills/                        # Agent skills (agentskills.io format)
    ├── sanity-best-practices/     # Comprehensive Sanity skill
    │   ├── SKILL.md               # Skill definition and quick reference
    │   └── references/            # Canonical content (25 guides)
    │       ├── get-started.md     # Onboarding guide
    │       ├── nextjs.md          # Next.js integration
    │       ├── groq.md            # GROQ patterns & performance
    │       ├── schema.md          # Schema design & validation
    │       └── ...                # See SKILL.md for full index
    ├── content-modeling-best-practices/      # Modeling guidance + topic references
    ├── seo-aeo-best-practices/               # SEO/AEO guidance + topic references
    ├── content-experimentation-best-practices/ # Experiment design + stats references
    ├── sanity-singletons/                    # First-class singleton documents (Studio 6.17+)
    └── sanity-form-component-suspense/       # Suspense boundaries for custom form components

すべてのスキルでは、必要に応じて読み込む詳細なコンテンツに references/ を使用します。sanity-best-practices の参照ファイルは、MCP サーバーの Sanity ルールの正規ソースでもあります。

リソース

• Sanity アカウントを作成
• Sanity ドキュメント
• GROQ 言語リファレンス
• ビジュアル編集ガイド
• Sanity TypeGen
• MCP サーバーのドキュメント
• エージェントプラグイン仕様
• Blueprints Infrastructure as Code

コントリビューション

より良いパターンを見つけましたか？フレームワークやベストプラクティスが不足していますか？スキルの仕組みと、優れたコントリビューションの条件については、コントリビューションガイドを読んでから、次の手順に進んでください。

1. リポジトリをフォークします。
2. npm install で依存関係をインストールします。
3. skills/<skill-name>/ で変更を加えます。
4. npm run validate:all を実行して、スキルとプラグインの有効性を確認します。
5. PR を送信します。

サポート

• Sanity コミュニティ（Discord）
• GitHub の issue

ライセンス： MIT