Next TokenParallel World

← ラボ / Claude Code ガイド / 連携台帳

Contentful・コンテンツ・CMS・海外　公式サイト
公式ドキュメントでは、AIエージェントがコンテンツを読み書きできるMCPサーバー（リモート版とオープンソースのローカル版）、Content Management API、公式CLIが案内されている。ヘッドレスCMS（コンテンツをAPIで配信するCMS）。

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか あり
リモートMCP: 管理者がスペース・環境ごとにMCPアプリでツールのカテゴリごとに read-only か read/write を選べる（無効のツールは呼ばれても拒否される）。ローカルMCP（@contentful/mcp-server）: 全体の読み取り専用モードの記載なし。環境変数 PROTECTED_ENVIRONMENTS に挙げた環境への書き込み・削除を止められる（読み取りは可。組織レベルのconcept/concept schemeと invoke_ai_action には効かない。ロールの権限と併用するよう書かれている）。https://www.contentful.com/developers/docs/tools/mcp-server/ ／ https://github.com/contentful/contentful-mcp-server
権限（スコープ）を選べるか あり
リモート: スペース・環境の組ごとにMCPアプリを入れ、カテゴリ単位で読み取り／読み書きを選ぶ（リモートはOAuth 2.1でサインインしたユーザーとして動く）。ローカル/CMA: 個人アクセストークンは「アカウント所有者と同じ権限」（認証ページ。スコープ指定の記載なし）。
危険な操作の既定
制御の記載なし（サーバー側の確認ステップの記載なし）。公式は「クライアント側でツール呼び出しの人手確認を有効にする」「まず read-only で始めてから書き込みを有効にする」ことを推奨。
削除ができるか できる
リモートMCPのツール一覧に delete_entry、delete_asset、delete_environment、delete_content_type、delete_content_type_field、delete_locale、delete_ai_action、delete_concept、delete_concept_scheme がある（スペース自体の削除ツールは掲載なし）。ローカルMCPのREADMEの削除ツールは delete_content_type、delete_entry、delete_asset、delete_environment、delete_locale、delete_ai_action。アーカイブ／公開停止のツールもある。削除の復元手順は未確認。
取り消し方（キー・接続）
個人アクセストークン（CMAトークン）: Webアプリの Settings > CMA tokens で一覧から取り消せる。APIでは PUT .../users/me/access_tokens/<tokenId>/revoked。ユーザーを組織から外すと、そのユーザーの他トークンの組織へのアクセスも外れる。OAuthアプリ認可の取り消し手順は同ページに記載なし。（根拠: https://www.contentful.com/help/personal-access-tokens/）

根拠のページ

つなぎ方（公式の資料にある範囲）

公式MCP あり

公式ドキュメントに「provide tools that AI agents can use to read and write content」とある。リモート版（https://mcp.contentful.com/mcp、EUは https://mcp.eu.contentful.com/mcp）とローカル版（github.com/contentful/contentful-mcp-server）の2種類。ツール: エントリの作成・更新・公開（publish_entry）・公開停止（unpublish_entry）・アーカイブ（archive_entry）・削除（delete_entry）・検索・スナップショット・参照解決、アセットのアップロード・更新・公開・公開停止・アーカイブ・アーカイブ解除・削除、スペース／環境の一覧・取得、環境の作成（create_environment）・削除（delete_environment）。リモート版のツール一覧には、このほか delete_content_type、delete_content_type_field、delete_locale、delete_ai_action、delete_concept、delete_concept_scheme、公開リリース系（publish_release、schedule_publish_release）、AI Actionの実行（invoke_ai_action）も載っている。スペース自体の作成・更新・削除ツールは掲載なし。ローカル版のREADMEには、環境変数 PROTECTED_ENVIRONMENTS で列挙した環境への書き込み・削除を止める設定がある。

つなぎ方（公式の記載）
取得できたページ本文には Claude Code 用のコマンドは無く、他のクライアント向けに {"mcpServers":{"contentful":{"url":"https://mcp.contentful.com/mcp"}}} の例だけがあった（ページに Claude Code のタブはあるが中身は取得できず）。

根拠のページ

公式CLI あり

github.com/contentful/contentful-cli が「The official Contentful command line interface」と自称。インストールは npm install -g contentful-cli。機能一覧: init、space（一覧・作成・削除など）、スペースのJSONエクスポート／インポート、マイグレーションスクリプトの実行・生成、サンプルデータの投入、拡張機能の管理、login/logout（OAuth）、organization sec-check、config add。

根拠のページ

公式API あり

Content Management API（read/write API。アクセストークンでHTTPS認証）。エントリの公開・公開停止・アーカイブ・削除、スナップショット取得のエンドポイントが一覧に載っている。既定のレート制限は毎秒7リクエスト（超過時は429）。更新時は X-Contentful-Version ヘッダで楽観ロック。大量配信にはContent Delivery APIを使うよう案内されている。

根拠のページ

第三者製MCP（公式ではない） 2件

  • ivo-toby/contentful-mcp（作者: ivo-toby（個人）・最終更新: 未確認（GitHubのページ上で最終コミット日を読み取れず））
    書き込み・削除: True
    Content Management API向け。READMEにエントリ・アセットの作成/更新/削除/公開、コンテンツタイプ・環境の作成/削除、一括公開などのツールが載り、「コンテンツやスペース・モデルを更新・削除できる」旨の注意書きがある。コミュニティ製で、Contentfulが別に公式サーバーを出したとも書かれている。MIT。
    https://github.com/ivo-toby/contentful-mcp
  • mshaaban0/contentful-delivery-mcp（作者: mshaaban0（個人）・最終更新: 未確認（GitHubのページ上で最終コミット日を読み取れず））
    書き込み・削除: False
    Delivery API向け。ツールは query_entries、get_entry、get_entries、get_assets、get_asset、get_content_type、get_content_types など取得系のみ。書き込み・削除の記載なし（READMEが読み取り専用と明言しているわけではない）。MIT。
    https://github.com/mshaaban0/contentful-delivery-mcp

第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。

探した場所（5件）

できる操作

読み取りでできる操作

  • 【MCP】エントリ・アセットの一覧／取得／検索、スナップショットの取得、参照の解決、スペース・環境の一覧／取得
  • 【API】Content Management API でのエントリ取得、スナップショット取得

書き込みでできる操作

  • 【MCP】エントリの作成・更新・公開・公開停止・アーカイブ、アセットのアップロード・更新・公開・公開停止・アーカイブ／アーカイブ解除、環境の作成、公開リリース（publish_release、schedule_publish_release）、AI Actionの実行（invoke_ai_action）
  • 【API】エントリの公開・公開停止・アーカイブ（エンドポイント名がページに掲載）

管理者操作（削除・課金・設定変更など）

  • 【MCP】リモート版: エントリ削除（delete_entry）、アセット削除（delete_asset）、環境削除（delete_environment）、コンテンツタイプ削除（delete_content_type）、コンテンツタイプのフィールド削除（delete_content_type_field）、ロケール削除（delete_locale）、AI Action削除（delete_ai_action）、concept削除（delete_concept）、concept scheme削除（delete_concept_scheme）ができる。スペースの作成・更新・削除ツールは掲載なし。ローカル版READMEの削除ツールは delete_content_type、delete_entry、delete_asset、delete_environment、delete_locale、delete_ai_action
  • 【CLI】space の削除ができる旨が機能一覧にある（確認プロンプトの記載は読めた範囲に無い）
  • 【MCP】リモート版は管理者がスペース・環境ごとにMCPアプリを入れ、ツールのカテゴリごとに「読み取りのみ」か「読み書き」を設定する
  • 【MCP】ローカル版は環境変数 PROTECTED_ENVIRONMENTS で、列挙した環境への書き込み・削除を止められる（読み取りは可。concept / concept scheme と invoke_ai_action には効かない。ロールの権限と併用するよう書かれている）

制限

  • リモートMCPは、使う各スペース・環境にContentful MCPアプリのインストールが必要
  • 環境エイリアスは未対応（実際の環境IDを使う）
  • CMAは既定で毎秒7リクエスト（超過で429）
  • Freeプランは月10万APIコール・Liteは月100万（料金ページ）
  • ローカルMCPの PROTECTED_ENVIRONMENTS は、concept / concept scheme と invoke_ai_action には効かない（README）
注意
  • 公開（publish_entry）・公開停止・削除がMCPから実行できる。リモート版にはコンテンツタイプ・フィールド・ロケール・AI Action・concept / concept scheme の削除、公開リリース（publish_release、schedule_publish_release）、AI Actionの実行（invoke_ai_action）のツールもある。公式は、まず読み取りのみで有効にし、書き込みは人手確認を付けてから有効にするよう勧めている
  • 削除したエントリの復元可否は読めた範囲に記載なし。スナップショット取得のツール／エンドポイントは存在するが、復元手順は未確認
  • 公開停止・アーカイブは削除より手前の段階の操作として用意されている（ツール一覧より）

認証・料金・日本語・実機検証

認証方式
リモートMCP: OAuth 2.1（各ユーザーがクライアント経由でContentfulにサインイン）。ローカルMCP: Content Management API の個人アクセストークン（環境変数で渡す。認証ページに「アカウント所有者と同じ権限」とあり、スコープ指定の記載はない）。CLI: OAuthでlogin。API: アクセストークン。
公表されている料金（2026年10月16日確認）
Free: 0ドル（ずっと）／Lite: 月額300ドル／Lite Spaceアドオン: 月額850ドル（Liteに追加）／Enterprise・Studio: 要問い合わせ（2026年10月確認。ページには「$」とあるだけで通貨コードの表記は読めなかった） 料金ページ
日本語対応
なし。公式ヘルプ『Localization in Contentful』に、Contentful UI とヘルプセンターを English・French・German で表示できると記載があり、日本語は含まれない（開発者向けドキュメントの言語は今回未確認。/ja-jp/ は取得エラー）。
Claude Code実機検証
未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）
確認できていない点（9件）
  • Claude Codeでの追加コマンド（ページ本文に無し）
  • 削除したエントリの復元（スナップショットからの復元手順）
  • トークンの取り消し方法（MCPページと認証ページに記載なし。CMAの「Revoke an access token」は項目名のみで本文は取得できていない）
  • CLIの削除コマンドの確認プロンプト、CLI公式ドキュメントページ（取得エラー）
  • 第三者製MCP、日本語対応の確認
  • リモートMCPの管理者設定を誰ができるか（ページに記載なし）
  • 2026-10-17再確認で残った点: ja: 公式サイトトップに言語選択の表示が見当たらなかったが、日本語ページの有無・ドキュメントの日本語は確定できず（/ja-jp/ は取得エラー）
  • 2026-10-17再確認で残った点: permission.revoke: MCP（OAuth接続）の取り消し手順は未確認。上記はCMAトークンの手順
  • 2026-10-17再確認で残った点: third_party_mcp.updated: 最終更新日はGitHubページから読み取れず
出典（9件）

この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。

ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。