Contentful MCP Server

社区

用于 Contentful 管理 API 的 MCP 服务器，实现全面的内容管理功能。

分类: 云存储第 7 / 15
Stars: ★ 62 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 9 个月前 ⚠
工具数: 33

58FMRS · C

该 MCP 服务器是社区驱动的，功能全面，覆盖 Contentful 内容管理的各个方面。它支持批量操作和评论线程，但需要注意分页限制和潜在的数据风险。对于使用 Claude 管理 Contentful 的用户来说，这是一个便捷的工具，但推荐检查官方服务器以获取更权威的支持。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

12/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 源码中包含了工具定义和主要执行路径，但未提供可验证的测试或CI结果，无法确认实际运行稳定性。由于静态审阅的限制，未执行代码验证，因此可靠性得分低于满分。
安全与权限 10/20: README强调了对破坏性操作的警告，并支持通过空间和环境ID进行作用域限制，以限制操作范围。然而，未发现明确的二次确认机制，且部分操作（如删除和发布）具有较高的副作用，需要进一步加固。
维护活跃度 12/20: 仓库未归档，有开放问题，但近期提交和版本发布信息无法从静态源码中获取。MIT许可证存在，但未看到明确的维护者所有权或更新策略，因此维护得分中等。
文档质量 15/20: README提供了详细的安装、配置示例和工具列表，涵盖了环境变量和参数。但缺少故障排除和错误处理的具体文档，以及成本信息，因此文档质量较好但未达满分。
安装易用性 13/20: README提供了清晰的逐步安装指南，包括Claude Desktop配置示例和多种传输模式。但未看到针对常见问题的setup脚本或自动验证，且需要用户手动获取API令牌，安装步骤相对简单但仍有改进空间。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

使用 Claude Desktop 或其他 MCP 客户端管理 Contentful 内容的开发者。
需要自动化内容发布、批量更新或验证的团队。
希望在聊天界面中快速操作 Contentful 内容的非技术用户。

不适合谁

需要官方支持的用户（此服务器为社区驱动，非 Contentful 官方）。
需要处理大量列表数据超过 3 项每页的场景，但可通过分页支持。
需要在不提供管理 token 的情况下进行身份验证（除非使用 App Identity 配置）。

所需权限

Contentful Management API token，具有读取和写入内容、空间、环境、内容类型等权限。
能够创建、更新、删除、发布和取消发布条目和资产。
能够创建、更新、删除评论。
能够创建和删除环境。
能够修改内容类型定义。

风险与副作用

此 MCP 服务器允许 AI 代理更新、删除内容、空间和内容模型，可能导致意外数据丢失或修改。
管理 token 泄露可能导致未授权访问。
社区服务器可能不如官方服务器稳定或安全。

安装接入

准备工作

运行环境：Node.js

CONTENTFUL_MANAGEMENT_ACCESS_TOKEN 必填密钥 Contentful 内容管理 API (CMA) 令牌，在 Contentful 账户设置的 API 密钥页面生成，服务器必需。

其他可选配置项（7 个）

CONTENTFUL_HOST 可选 Contentful 管理 API 端点，默认 https://api.contentful.com。

ENABLE_HTTP_SERVER 可选设为 true 启用 HTTP/SSE 传输模式。

HTTP_PORT 可选 HTTP 服务器端口，默认 3000。

HTTP_HOST 可选 HTTP 服务器主机，默认 localhost。

DISABLE_AI_ACTIONS 可选设为 true 可在启动时禁用 AI Actions 获取（无该功能权限时使用）。

SPACE_ID 可选可选，限定操作只能在指定空间进行。

ENVIRONMENT_ID 可选可选，与 SPACE_ID 一起设置后工具将不再要求提供空间/环境 ID。

在 Contentful 官网创建账户。
从账户设置中生成 Content Management API token。
将以下配置添加到 Claude Desktop 的配置文件（如 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

重启 Claude Desktop。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "contentful": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/contentful-management-mcp-server"
      ],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add contentful -e 'CONTENTFUL_MANAGEMENT_ACCESS_TOKEN=<Your CMA token>' -- npx -y @ivotoby/contentful-management-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 配置好后重启客户端，工具列表中应出现 search_entries、list_spaces 等工具；也可直接问'列出我的 Contentful 空间'来验证连接是否成功。

常见排障

检查环境变量 CONTENTFUL_MANAGEMENT_ACCESS_TOKEN 是否正确设置，或通过 --management-token 参数传递。
确认网络连接正常，Contentful API 可访问。
如果使用 HTTP 模式，检查端口是否被占用，以及客户端是否正确配置了服务器 URL。
如果列表操作只返回 3 项，这是预期行为，可使用提供的分页参数获取更多。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索标题包含'新闻'的条目并列出前几条
为条目 entryId 123 创建一条评论，内容为'已审核'
把这几个条目和资源批量发布出去
列出当前空间里的所有环境

工具能力 33

search_entries 只读

使用查询参数搜索条目。

create_entry 写入

创建新的条目。

get_entry 只读

获取现有条目。

update_entry 写入

更新条目字段。

delete_entry 破坏性

删除条目。

publish_entry 写入

发布条目。

unpublish_entry 写入

取消发布条目。

get_comments 只读

获取条目评论，可按状态（active、resolved、all）过滤。

展开其余 25 个工具

create_comment 写入

创建新评论，支持纯文本和富文本格式，并支持通过父评论 ID 实现线程回复。

get_single_comment 只读

按 ID 获取特定评论。

delete_comment 破坏性

删除条目上的特定评论。

update_comment 写入

更新现有评论的内容或状态。

bulk_publish 写入

一次操作发布多个条目和资产。

bulk_unpublish 写入

一次操作取消发布多个条目和资产。

bulk_validate 只读

批量验证多个条目的内容一致性、引用和必填字段。

list_assets 只读

列出资产，分页显示（每页 3 项）。

upload_asset 写入

上传新资产及元数据。

get_asset 只读

获取资产详情和信息。

update_asset 写入

更新资产元数据和文件。

delete_asset 破坏性

从空间中删除资产。

publish_asset 写入

将资产发布到交付 API。

unpublish_asset 写入

从交付 API 取消发布资产。

list_spaces 只读

列出可用的空间。

get_space 只读

获取空间详情。

list_environments 只读

列出空间中的环境。

create_environment 写入

创建新环境。

delete_environment 破坏性

删除环境。

list_content_types 只读

列出可用的内容类型。

get_content_type 只读

获取内容类型详情。

create_content_type 写入

创建新内容类型。

update_content_type 写入

更新内容类型。

delete_content_type 破坏性

删除内容类型。

publish_content_type 写入

发布内容类型。

使用场景

通过自然语言管理 Contentful 空间中的内容，如创建、更新、发布条目。

批量操作大量条目或资产，例如批量发布或验证。

在内容编辑工作流中管理评论和线程讨论。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

这是一个社区驱动的 MCP 服务器，集成了 Contentful 的内容管理 API，提供完整的内容管理能力，包括条目、资产、评论、空间、环境、内容类型的管理，以及发布、批量操作、本地化支持等功能。它支持 stdio 和 StreamableHTTP 两种传输模式，并可与 Claude Desktop 等 MCP 客户端无缝集成。