Contentful Automation
Contentful ヘッドレスCMSスペースをClaude Codeから直接管理します。ターミナルから離れずに、スペースの一覧表示、メタデータの取得、設定の更新が可能です。
ツールキットドキュメント: composio.dev/toolkits/contentful
セットアップ
- 設定にComposio MCPサーバーを追加します:
https://rube.app/mcp - プロンプトに従ってContentfulアカウントを接続します。エージェントが認証リンクを提供します。アクセストークンにスペース管理スコープがあることを確認してください。
主要ワークフロー
1. 全スペースの一覧表示
認証されたアカウントからアクセス可能なすべてのContentfulスペースを表示します。通常、最初に実行する操作です。他のほとんどのアクションでは space_id が必要になるためです。
ツール: CONTENTFUL_LIST_SPACES
主要パラメータ:
limit(1～1000) -- 返すスペースの最大数（デフォルト: 100）skip-- ページネーションのためのスキップ数order-- ソートフィールド（例:sys.createdAtまたは降順の-sys.createdAt）
プロンプト例: "Contentfulのスペースをすべて表示して"
2. スペース詳細の取得
特定のスペースの詳細メタデータ（現在の sys.version を含む）を取得します。このバージョン番号は更新時に必要です。
ツール: CONTENTFUL_GET_SPACE
主要パラメータ:
space_id(必須) -- 取得するスペースのID（英数字、1～64文字）
プロンプト例: "Contentfulスペース abc123def の詳細を取得して"
3. スペース名の更新
特定のスペースの名前を更新します。同時変更の競合を防ぐため、現在のバージョン番号による楽観的ロックが必要です。
ツール: CONTENTFUL_UPDATE_SPACE
主要パラメータ:
space_id(必須) -- 更新するスペースのIDname(必須) -- 新しいスペース名（1～255文字）version(必須) --sys.versionからの現在のスペースバージョン（0より大きい値）
プロンプト例: "Contentfulスペース abc123def の名前を 'Production Content Hub' に変更して"
4. スペースインベントリの監査
スペース一覧表示と詳細取得を組み合わせて、組織内のContentfulスペースを監査します。
ツール: CONTENTFUL_LIST_SPACES の後に CONTENTFUL_GET_SPACE
ワークフロー:
- 全スペースを一覧表示してIDと名前を取得
- 各スペースの詳細を取得してバージョン情報、作成日、メタデータを取得
プロンプト例: "Contentfulの全スペースを監査して -- 作成日と現在のバージョンとともに一覧表示して"
既知の問題点
- 更新時のバージョン競合:
CONTENTFUL_UPDATE_SPACEはCONTENTFUL_GET_SPACEから取得した最新のsys.versionを必要とします。読み取りと書き込みの間に別のユーザーがスペースを変更した場合、更新はバージョン競合で失敗します。更新の直前に必ずスペースを取得してください。 - 多数のスペースがある場合のページネーション:
CONTENTFUL_LIST_SPACESはlimitとskipパラメータを使用します。スペースが多い場合は、結果が返されなくなるまでskipをインクリメントして繰り返し取得し、スペースを見逃さないようにしてください。 - スコープの制限: これらのツールはスペースレベルのメタデータ（名前）のみを管理します。スペース内のエントリ、コンテンツタイプ、アセットの作成や変更はできません。
- 認証/権限の不一致:
CONTENTFUL_GET_SPACEによる読み取りが成功しても、トークンにスペース管理スコープがない場合、CONTENTFUL_UPDATE_SPACEによる更新は失敗します。トークンに書き込み権限があることを確認してください。 - スペースIDの形式:
space_idはパターン^[a-zA-Z0-9-_.]{1,64}$に一致する必要があります。無効な文字は拒否されます。
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
CONTENTFUL_LIST_SPACES | アカウントでアクセス可能な全スペースを一覧表示 |
CONTENTFUL_GET_SPACE | 単一スペースの詳細メタデータを取得 |
CONTENTFUL_UPDATE_SPACE | スペース名を更新（バージョン必須） |
Powered by Composio