MCP 経由で Prismic を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Prismic をクリック、キーなしでインストール、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Prismic + Gemini

ヘッドレスなページビルダー Prismic を、公開リポジトリならキーなしで：Prismic のフィルターで公開済みと予約済みのドキュメントを照会し、ID、UID、タイプでドキュメントを読み、カスタムタイプとスライスのモデルを参照し、メディアを閲覧してアップロードし、Migration API でドキュメントの下書きを作成または更新できます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

PRISMIC_REPOSITORY（任意: PRISMIC_ACCESS_TOKEN、PRISMIC_WRITE_TOKEN）

ステップ 1 — コネクタを設定

公開リポジトリならキー不要: 設定は約 3 分です。コネクタは Content API（https://<repository>.cdn.prismic.io/api/v2）で Prismic のリポジトリを読み取ります。この API が公開されていれば、必要なのはリポジトリ名だけです。コンテンツモデル、メディア、書き込みは Prismic の書き込み用 API（Types API、Asset API、Migration API）を使うため、write token が必要です。

1. PRISMIC_REPOSITORY: リポジトリ名です。ダッシュボード URL の .prismic.io の前の部分です（例: your-repo-name）。
2. PRISMIC_ACCESS_TOKEN（任意）: Content API が非公開の場合だけ必要です。リポジトリの Settings > API & Security でアクセストークンを生成するか、npx prismic token create を実行します。公開 API なら空のままにします。
3. PRISMIC_WRITE_TOKEN（任意）: 説明に "Needs the write token" とあるツールと、すべての書き込みに必要です。Settings > API & Security > Write APIs でトークンを生成するか、npx prismic token create --write を実行します。repository ヘッダーとともに Authorization: Bearer <token> として送信されます。広い権限を持つため、信頼できるワークスペースだけで使ってください。
4. コネクタをインストールし、prismic_get_repository を実行してリポジトリ名を確認します。

Prismic 公式の MCP サーバー: Prismic は、アシスタントから編集や公開を行うための MCP サーバー（https://mcp.prismic.io/mcp、OAuth でサインイン）も提供しています。このコネクタはトークンを使う代替手段です。

コンテンツは 2 段階で読みます:

1. prismic_get_repository は refs を返します。AI は公開済みコンテンツには isMasterRef: true のエントリの ref を、予約済みコンテンツのプレビューにはリリースの ref を使います。すべてのコンテンツ照会に必要で、公開のたびに変わります。同じ応答にカスタムタイプ、タグ、言語、ブックマークも含まれます。
2. 次に、q にフィルターを指定する prismic_search_documents、ID で取得する prismic_get_document、タイプと UID で取得する prismic_get_document_by_uid（例: タイプ page、uid about-us）、または prismic_list_documents_by_type を使います。lang、fetch_links、graph_query で応答の内容を調整できます。

フィルター（q）: [[at(document.type,"blog_post")]]。複数のフィルターを並べると組み合わされます: [[at(document.type,"blog_post")][any(document.tags,["news","events"])]]。ほかに fulltext(document,"text")、at(my.blog_post.author,"<id>")、date.after(document.first_publication_date,"2026-01-01")、not、in(document.id,[...])、number.lt(my.product.price,100) があります。並べ替えには [my.blog_post.date desc] のような orderings を使います。

モデルとメディア（write token）: prismic_list_custom_types と prismic_get_custom_type は各ページタイプのフィールド構造（タブ、スライスゾーン、繰り返しか単一か、ステータス）を返し、prismic_list_shared_slices と prismic_get_shared_slice はバリエーション付きの共有スライスを返します。prismic_list_assets は種類やキーワードでメディアライブラリを閲覧し、prismic_upload_asset は公開 URL からファイルをアップロードしてアセット ID を返し、prismic_update_asset は代替テキスト、クレジット、メモを編集します。

ドキュメントの書き込み（write token）: prismic_create_document と prismic_update_document は下書きを migration release に保存します。編集者がダッシュボード（Migration Releases タブ）でそのリリースを公開するまでは公開されません。これらの API に公開の呼び出しはありません。AI はカスタムタイプのモデルに沿って data を組み立てます。リッチテキストはブロックのリスト（{"type": "paragraph", "text": "...", "spans": []}）、画像とメディアはアセット ID、リンクは {"link_type": "Document", "id": "..."} または {"link_type": "Web", "url": "..."} です。更新はすべてのコンテンツとタグを置き換えるため、AI は先にドキュメントを読み、すべてを送り返します。タイプとロケールは変更できません。

インストール時に無効になっているツールはありません: 削除や公開のツールはありません。コンテンツモデルの変更と削除は、Prismic のダッシュボードか CLI で行います。

データ形式: コンテンツのリストには results、page、total_pages、total_results_size、next_page が含まれます。リッチテキストのフィールドはブロックのリストで、日付は YYYY-MM-DD、タイムスタンプは ISO 8601 です。ドキュメント ID は ZMI65RQAADkECUFM のような形式です。

ページング: page（1 から）と page_size（既定 20、最大 100）、または orderings と、最後のドキュメントの ID を指定した after を組み合わせます。アセットは cursor でページングします。

制限: Content API はキャッシュされないリクエストを毎秒 200 件まで、URL は 2,048 文字まで受け付けるため、AI は graph_query を短く保ちます。Migration API と Asset API はリポジトリごとに毎秒 1 リクエストです。

よくあるエラー: prismic_get_repository での 404 はリポジトリ名の誤りです。401 または 403 は、有効なアクセストークンのない非公開 API、または有効な write token のない書き込みです。400 はフィルターの書式誤りか無効な ref、422 はモデルに合わないデータです。

このコネクタはドキュメントの公開、ドキュメントやアセットの削除、カスタムタイプやスライスの変更は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Prismic のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「最新のブログ記事 10 件を、タイトルと初回公開日付きで一覧にして。」
• 「about-us ページを表示して、スライスの内容を要約して。」
• 「news タグが付いていて、2026 年 1 月 1 日以降に初めて公開されたドキュメントはどれ？」
• 「カスタムタイプ blog_post にはどんなフィールドがある？」
• 「「2026 年のロードマップ」というタイトルで、短い導入段落付きのブログ記事の下書きを作って。編集者に確認してもらうために。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続