@contentful/mcp-server Skill 技能

技能简介

Contentful MCP Server 是 Contentful 官方推出的 Model Context Protocol (MCP) 服务器，为 Claude Desktop、Cursor、VS Code Copilot 等 AI 编程助手提供对 Contentful 内容管理 API 的完整访问能力。通过自然语言即可创建、编辑、发布、管理 Contentful Space 中的内容条目、资产、编辑器界面、版本、AI Action 等资源，让 AI 真正成为内容运营团队的生产力倍增器。

核心能力

1. 内容条目管理：搜索、获取、创建、更新、发布、批量发布（单次最多 100 条）、多语言 locale 支持与引用解析
2. 内容类型建模：列表、获取、创建、修改、发布、删除内容类型，灵活定义字段结构
3. 资产（Assets）管理：上传、列表、获取、更新、发布、删除资产，按活动组织营销素材
4. 编辑器接口配置：调整字段控件、侧边栏与布局
5. Spaces 与多环境管理：列表、创建、删除 Space 与多环境（master/staging 等）
6. Locales 多语言支持：创建、修改多语言环境，适配全球化内容运营
7. Releases 版本管理：列表、创建、修改、发布、定时发布与取消预定发布
8. AI Actions 工作流：创建、调用自定义 AI 驱动工作流（如自动翻译、内容摘要）
9. Taxonomy 分类法：管理 Concepts 与 Concept Schemes
10. Space Migration 迁移：Space 间内容导出与导入

安装配置

1. 前置依赖：Node.js、npm、Contentful Space ID、Management API personal access token
2. Cursor 一键安装：点击 README 中的 Install MCP Server 链接自动配置
3. Claude Desktop：从 GitHub Releases 下载 .dxt 配置文件导入
4. 手动配置 MCP 客户端 settings.json，添加 npx 命令与 CONTENTFUL_MANAGEMENT_ACCESS_TOKEN、SPACE_ID、ENVIRONMENT_ID、CONTENTFUL_HOST 环境变量
5. 高级选项：MAX_BULK_SIZE（1-100）限制批量操作；ENABLE_EXO_TOOLS 启用 Experience Orchestration

使用步骤

1. 在 Contentful 后台生成 Management API personal access token 与 Space ID
2. 在 Claude Desktop / Cursor / VS Code 中配置 contentful-mcp 服务器
3. 重启客户端确认 MCP 已连接
4. 用自然语言提出需求，例如「为秋季产品发布创建一篇博客文章」「把所有产品条目的价格字段更新为新结构」「按 Campaign 归类上传营销图片」
5. AI 助手调用 70+ 工具完成任务
6. 在 Contentful 后台或客户端结果中验证修改

适用场景

• 内容营销团队批量更新产品定价、文章发布、营销文案
• 全球化运营多语言内容同步与本地化
• 内容建模与字段结构调整
• 营销活动按 Campaign 组织资产、定时发布 Release
• 内容审核与批量操作
• master ↔ staging ↔ dev 跨环境迁移
• 构建自定义 AI Action（自动翻译、内容摘要、标签生成等）

适用人群

内容运营 / 内容营销人员、CMS 管理员与开发者、使用 Cursor / Claude / VS Code 的 AI 重度用户、跨国品牌本地化团队。

工作原理

基于 Model Context Protocol 标准的 stdio 服务器，通过 npx 启动并连接到 Contentful Management API。AI 助手在对话中识别意图后发起 tool call 请求，MCP 客户端通过 stdio 调用 Contentful MCP Server，后者将请求路由到 Contentful REST API 并返回结构化结果。70+ 个工具按 Content Types、Entries、Assets、Spaces、Locales、Tags、Releases、AI Actions、Taxonomy、Migration 等类别组织，每个工具对应一个 Contentful API endpoint。

官方链接

• npm 包：https://www.npmjs.com/package/@contentful/mcp-server
• GitHub 仓库：https://github.com/contentful/contentful-mcp-server
• Contentful 文档：https://www.contentful.com/developers/docs/references/content-management-api/