Contentful MCP

🚀 Feature-rich MCP Server

A powerful MCP (Machine Learning Control Plane) server that allows Claude or other similar AI agents to interact with the content management system Contentful. This server offers comprehensive management capabilities for spaces, environments, content models, and the content itself.

🚀 Quick Start

A powerful MCP (Machine Learning Control Plane) server enables Claude or other similar AI agents to interact with the Contentful content management system. It provides comprehensive management capabilities for spaces, environments, content models, and content.

✨ Features

• Content Model Management: Create, update, and delete content models.
• Content Operations: Efficiently perform CRUD operations on content within specified environments.
• Environment Isolation: Support running in specific Contentful spaces and environments to prevent accidental operations.
• Security Mechanisms: Integrate comprehensive authentication and permission control to ensure data security.
• Scalability: Support function expansion through plugins or custom tools.

📚 Documentation

Content Model Management

• Create new content models, including configurations such as field types and validation rules.
• Update the structure and attributes of existing models.
• Delete content models that are no longer needed.

Content Operations

• Efficiently perform CRUD operations on content within specified environments.
• Support batch operations to improve processing efficiency.
• Provide detailed historical records for easy tracking of changes.

Environment Isolation

• Configure specific space IDs and environment IDs to ensure that all operations are performed within the specified scope.
• Prevent data loss or security risks caused by accidental operations.

Security Mechanisms

• Authentication: Support dual authentication methods using Contentful's management API tokens and App Identity.
• Permission Control: Limit the capabilities of AI agents by setting allowed operation ranges to prevent unauthorized access.
• Audit Logs: Record the history of all operations for subsequent review and traceability.

Scalability

• Support function expansion through the plugin system, allowing users to add custom tools as needed.
• Provide flexible configuration options to adapt to different workflows and usage scenarios.

📦 Installation

Automatic Installation with Smithery

For users who want to get started quickly, you can install it with one click through Smithery:

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

Manual Installation and Configuration

1. Clone the Repository

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

2. Install Dependencies

   npm install
   

3. Configure Environment Variables

   Update the claude_desktop_config.json file and add the following content:

   {
     "mcpServers": {
       "contentful": {
         "command": "node",
         "args": ["bin/mcp-server.js"],
         "env": {
           "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your Management API Token>"
         }
       }
     }
   }
   

4. Start the Server

   npm run dev
   

💻 Usage Examples

Using via Claude Desktop

You don't need to clone the repository. Simply add the following configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["-y", "@ivotoby/contentful-management-mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your Management API Token>"
      }
    }
  }
}

Authenticating with App Identity

If you prefer to use Contentful's App Identity for authentication, you can follow these steps:

• Register and create a Contentful app.
• Configure the following environment variables or command-line parameters:

--app-id <Your App ID>
--private-key <Your Private Key>
--space-id <Target Space ID>
--environment-id <Target Environment ID>

Error Handling

This server integrates a comprehensive error handling mechanism to handle the following common issues:

• Authentication Failure: When the provided token or identity is invalid.
• Rate Limiting: When the Contentful API call limit is exceeded.
• Invalid Request: When the request parameters do not meet the specifications.
• Network Issues: Temporary connection failures.
• API Errors: Specific errors returned by the Contentful API.

📄 License

MIT License

⚠️ Important Note

This MCP server empowers Claude or other AI agents to manage content models, spaces, and environments. Therefore, please exercise extreme caution when granting these permissions and ensure you understand the specific impact of each operation. It is recommended to conduct comprehensive testing and validation in a test environment before deploying in a production environment.