适合谁
- 使用 Claude Desktop 或其他 MCP 客户端管理 Contentful 内容的开发者。
- 需要自动化内容发布、批量更新或验证的团队。
- 希望在聊天界面中快速操作 Contentful 内容的非技术用户。
C
58FMRS · C
该 MCP 服务器是社区驱动的，功能全面，覆盖 Contentful 内容管理的各个方面。它支持批量操作和评论线程，但需要注意分页限制和潜在的数据风险。对于使用 Claude 管理 Contentful 的用户来说，这是一个便捷的工具，但推荐检查官方服务器以获取更权威的支持。
这是一个社区驱动的 MCP 服务器，集成了 Contentful 的内容管理 API，提供完整的内容管理能力，包括条目、资产、评论、空间、环境、内容类型的管理，以及发布、批量操作、本地化支持等功能。它支持 stdio 和 StreamableHTTP 两种传输模式，并可与 Claude Desktop 等 MCP 客户端无缝集成。
工具能力
search_entries
使用查询参数搜索条目。
create_entry
创建新的条目。
get_entry
获取现有条目。
update_entry
更新条目字段。
delete_entry
删除条目。
publish_entry
发布条目。
unpublish_entry
取消发布条目。
get_comments
获取条目评论，可按状态（active、resolved、all）过滤。
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 官网创建账户。
- 从账户设置中生成 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>"
}
}
}
}
选型与风险
不适合谁
- 需要官方支持的用户（此服务器为社区驱动，非 Contentful 官方）。
- 需要处理大量列表数据超过 3 项每页的场景，但可通过分页支持。
- 需要在不提供管理 token 的情况下进行身份验证（除非使用 App Identity 配置）。
所需权限
- Contentful Management API token，具有读取和写入内容、空间、环境、内容类型等权限。
- 能够创建、更新、删除、发布和取消发布条目和资产。
- 能够创建、更新、删除评论。
- 能够创建和删除环境。
- 能够修改内容类型定义。
风险与副作用
- 此 MCP 服务器允许 AI 代理更新、删除内容、空间和内容模型，可能导致意外数据丢失或修改。
- 管理 token 泄露可能导致未授权访问。
- 社区服务器可能不如官方服务器稳定或安全。
常见排障
- 检查环境变量 CONTENTFUL_MANAGEMENT_ACCESS_TOKEN 是否正确设置，或通过 --management-token 参数传递。
- 确认网络连接正常，Contentful API 可访问。
- 如果使用 HTTP 模式，检查端口是否被占用，以及客户端是否正确配置了服务器 URL。
- 如果列表操作只返回 3 项，这是预期行为，可使用提供的分页参数获取更多。
使用场景
通过自然语言管理 Contentful 空间中的内容，如创建、更新、发布条目。
批量操作大量条目或资产，例如批量发布或验证。
在内容编辑工作流中管理评论和线程讨论。
支持客户端
Claude Desktop完整支持