Contentful MCP

🚀 内容豊富なMCPサーバー

強力なMCP（機械学習制御プレーン）サーバーで、Claudeやその他の類似したAIエージェントがコンテンツ管理システムContentfulとやり取りできるようにします。このサーバーは、スペース、環境、コンテンツモデル、コンテンツ自体の包括的な管理機能を提供します。

✨ 主な機能

• コンテンツモデル管理：コンテンツモデルの作成、更新、削除
• コンテンツ操作：指定された環境でコンテンツの効率的な追加、削除、更新、検索
• 環境分離：特定のContentfulスペースと環境での実行をサポートし、誤操作を防止
• セキュリティ機構：包括的な認証と権限管理を統合し、データの安全性を確保
• 拡張性：プラグインやカスタムツールによる機能拡張をサポート

📚 ドキュメント

コンテンツモデル管理

• 新しいコンテンツモデルを作成し、フィールドタイプや検証ルールなどの設定を行う
• 既存のモデルの構造と属性を更新する
• 不要になったコンテンツモデルを削除する

コンテンツ操作

• 指定された環境でコンテンツの効率的な追加、削除、更新、検索
• バッチ操作をサポートし、処理効率を向上させる
• 詳細な履歴記録を提供し、変更の追跡を容易にする

環境分離

• 特定のスペースIDと環境IDを設定でき、すべての操作が指定された範囲内で行われることを確保する
• 誤操作によるデータ損失やセキュリティリスクを防止する

セキュリティ機構

• 認証：Contentfulの管理APIトークンとアプリケーションID（App Identity）の二重認証方式をサポート
• 権限管理：許可された操作範囲を設定することで、AIエージェントの機能を制限し、不正アクセスを防止する
• 監査ログ：すべての操作の履歴を記録し、後のレビューや追跡を容易にする

拡張性

• プラグインシステムによる機能拡張をサポートし、ユーザーは必要に応じてカスタムツールを追加できる
• 柔軟な設定オプションを提供し、さまざまなワークフローや使用シーンに対応する

📦 インストール

Smitheryを使用した自動インストール

すぐに始めたいユーザーは、Smitheryを通じてワンクリックでインストールできます：

npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude

手動インストールと設定

1. リポジトリをクローンする

   git clone https://github.com/yourusername/contentful-mcp.git
   cd contentful-mcp
   

2. 依存関係をインストールする

   npm install
   

3. 環境変数を設定する

   claude_desktop_config.jsonファイルを更新し、以下の内容を追加します：

   {
     "mcpServers": {
       "contentful": {
         "command": "node",
         "args": ["bin/mcp-server.js"],
         "env": {
           "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<あなたの管理APIトークン>"
         }
       }
     }
   }
   

4. サーバーを起動する

   npm run dev
   

💻 使用例

Claude Desktopを使用する

リポジトリをクローンする必要はなく、claude_desktop_config.jsonに以下の設定を追加するだけです：

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["-y", "@ivotoby/contentful-management-mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<あなたの管理APIトークン>"
      }
    }
  }
}

App Identityを使用した認証

ContentfulのアプリケーションID（App Identity）を使用して認証する場合は、以下の手順を実行します：

• Contentfulアプリを登録して作成する
• 以下の環境変数またはコマンドライン引数を設定する：

--app-id <あなたのアプリケーションID>
--private-key <あなたの秘密鍵>
--space-id <ターゲットスペースID>
--environment-id <ターゲット環境ID>

エラー処理

このサーバーは包括的なエラー処理機構を統合しており、以下の一般的な問題に対応できます：

• 認証失敗：提供されたトークンまたはIDが無効な場合
• レート制限：Contentful APIの呼び出し制限を超えた場合
• 無効なリクエスト：リクエストパラメータが規格に合致しない場合
• ネットワーク問題：一時的な接続障害
• APIエラー：Contentful APIが返す特定のエラー

📄 ライセンス

MIT License

⚠️ 重要提示

このMCPサーバーはClaudeや他のAIエージェントにコンテンツモデル、スペース、環境の管理権限を与えます。したがって、これらの権限を付与する際には、各操作の具体的な影響を理解し、慎重に行ってください。本番環境にデプロイする前に、テスト環境で十分なテストと検証を行うことをお勧めします。