内容ack MCP 服务器

一个用于Contactack的模型上下文协议(MCP)服务器. 它揭露了内容管理,内容提供,分析,发布,自动化,BrandKit,个性化,开发者Hub,和Lytics的工具.

特征

• 内容管理:条目,资产,内容类型,分类学,术语,分支,发布,出版,变体,环境,全球域,和条目引用.
• 内容管理扩展:审计日志,条目和资产版本历史,全域写作,资产文件夹管理,以及工作流程和发布规则检查.
• 内容交付:通过Mineltack的CDN发布条目和资产.
• 发射:项目,环境,部署钩子,部署,日志,上传,CDN缓存重新验证.
• 自动化:自动化枢纽项目,自动化检查,激活控制,和HTTP-触发工作流程运行.
• 分析:API,CDN,缓存,状态码,SDK,设备,以及URL的使用.
• BrandKit 大赦国际:语音简介,知识库内容,和AI生成.
• 个性化:属性,受众,体验,事件,分析,地理学帮助者.
• 开发者枢纽: 市场应用软件生命周期,OAuth设置,以及应用设备.
• 语言: 观众,简介,内容主题,分类,账户,字段,和表格.
• 灵活查询选项: PGination,过滤,排序,计数,元数据,发布细节,以及基础API支持的引用包含.

API 组

MCP服务器支持多个可以独立或一起使用的API组:

• 医学院 (常务管理API): 核心内容管理——条目,资产,内容类型,全球领域,分支,发布,出版,环境(78个工具)
• CMA 扩展: 审计、版本历史、资产文件夹管理、全局字段写作和工作流程检查——同时加载 cma 当代理商需要背景或行政能力时(22个工具)
• 土发委会 (连续交付API): 通过CDN发布内容
• 分析:使用分析、业绩监测和业务见解
• 布兰克基特:AI驱动品牌管理和内容生成
• 发射: 安装平台,以托管和管理有内幕功能的网站
• 自动化:自动化枢纽项目管理、自动化发现和HTTP-触发工作流程执行
• 开发者Hub: 采购网应用程序生命周期管理和装置
• 语言: 高级分析和观众见解
• 个性化: 高级个性化和A/B测试能力
• 全体: 启用所有 API 组

上下文提示 : 正在装入 cma 仅给代理商提供日常内容操作所需的工具. 添加 cma-extended 仅当会议需要审计线索、版本检查或工作流程上下文时。 保持两者的相隔会减少每个回合发送到LLM的工具定义上下文.

配置

先决条件

1. 在 目录

OAuth 设置( CMA、 CMA 扩展、 分析、 自动化、 BrandKit、 启动、 开发者Hub 和个人化 )

重要:在使用内容管理API(CMA或CMA扩展),分析,自动化,BrandKit,启动,开发者Hub,或个性化工具之前,必须使用OAuth认证:

npx @contentstack/mcp --auth

此命令打开 OAuth 流量, 并在当地存储生成的符号 。 选定的数据中心(区域)与会话一起保存,并用于所有请求.

管理令牌而非 OAuth( CMA / CMA 扩展 / 仅 CDA)

如果您不能使用 OAuth 并且只需要内容工具, 您可以认证 医学院 财务报告和审定财务报表 CMA 扩展 带有 管理符号 换句话说 提供符号加您所居住的区域( 没有保存 OAuth 会话来推断它):

npx @contentstack/mcp --groups cma \
  --stack-api-key <STACK_API_KEY> \
  --management-token <MANAGEMENT_TOKEN> \
  --region NA

CDA同样不需要OAuth——它使用送货符. 管理标志 无法 认证分析、自动化、 BrandKit、 启动、 开发者Hub 或个性化; 需要的 --auth。 。 。 .

所需额外经费

1. 对于 CDA 访问,生成 发送符 目标环境.
2. 为了BrandKit 提供你的Brand Kit身份证.
3. 对于发射,请提供您的发射项目ID和组织UID.
4. 对Lytics来说,生成Lytics 访问令牌。 。 。 .
5. 为了个性化,请提供个人化项目ID.

环境变量

这些变量也可以作为CLI参数提供.

• CONTENTSTACK_API_KEY 编号 : --stack-api-key: 您的 Stack API 密钥
• CONTENTSTACK_DELIVERY_TOKEN 编号 : --delivery-token: 您的 Stack 交付令牌( 仅需使用 CDN/ 交付 API 工具)
• CONTENTSTACK_MANAGEMENT_TOKEN 编号 : --management-token: Stack 管理符. CMA / CMA 扩展的 OAuth 替代品(见上文)
• CONTENTSTACK_REGION 编号 : --region: 数据中心改为目标 - NA, (中文(简体) ), EU, (中文(简体) ), AU, (中文(简体) ), AZURE_NA, (中文(简体) ), AZURE_EU, (中文(简体) ), GCP_NA, (中文(简体) ), GCP_EU (文件上的别名,例如: us, (中文(简体) ), aws-eu 也参与工作。 默认 : NA。与 OAuth 一起,区域从保存的会话中取出,除非在此覆盖
• CONTENTSTACK_BRAND_KIT_ID 编号 : --brand-kit-id: 您的 Brand Kit ID( BrandKit 工具必需)
• CONTENTSTACK_LAUNCH_PROJECT_ID 编号 : --launch-project-id: 您的发射项目 ID( 发射工具需要)
• CONTENTSTACK_ORGANIZATION_UID 编号 : --organization-uid: Your Contack Organization UID (发射工具需要)
• LYTICS_ACCESS_TOKEN 编号 : --lytics-access-token: 您的Lytics访问符 (Lytics工具需要)
• CONTENTSTACK_PERSONALIZE_PROJECT_ID 编号 : --personalize-project-id: 您的个性化项目 ID( 个人化工具需要)
• GROUPS 编号 : --groups: 以逗号分隔的 API 组列表以启用(选项 : cma, (中文(简体) ), cma-extended, (中文(简体) ), cda, (中文(简体) ), analytics, (中文(简体) ), automations, (中文(简体) ), brandkit, (中文(简体) ), launch, (中文(简体) ), developerhub, (中文(简体) ), lytics, (中文(简体) ), personalize, (中文(简体) ), all默认 : cma(中文(简体) )
• CONTENTSTACK_ENVIRONMENT: 可选默认环境名称, 用于堆栈感知 CDA/ CMA 工具浓缩
• CONTENTSTACK_BRANCH: 用于浓缩的可选默认分支(默认为 main(中文(简体) )
• CONTENTSTACK_LOCALE: 用于浓缩的可选默认地块代码
• CONTENTSTACK_MCP_ENRICH_TOOLS: 设定为 false 以禁用堆栈感知工具浓缩。 在默认情况下进行浓缩

专用基础设施(海关终点)

专用或私人基础设施的客户可以超越单个服务基地URL. 设定时, 覆盖将完全取代该服务的区域生成的 URL( 包含服务所期望的任何路径后缀, 例如 Launch's /manage:

• CONTENTSTACK_CMA_BASE_URL - 医学院和医学院扩展
• CONTENTSTACK_CDA_BASE_URL - 发协
• CONTENTSTACK_DEVELOPERHUB_BASE_URL ——开发者枢纽
• CONTENTSTACK_PERSONALIZE_BASE_URL - 个性化
• CONTENTSTACK_ANALYTICS_BASE_URL - 分析
• CONTENTSTACK_AUTOMATIONS_BASE_URL - 自动化
• CONTENTSTACK_LAUNCH_BASE_URL 发射
• CONTENTSTACK_BRANDKIT_AI_BASE_URL 编号 : CONTENTSTACK_BRANDKIT_API_BASE_URL - BrandKit(AI和品牌Kits-api主机)
• CONTENTSTACK_LYTICS_BASE_URL - 语言

区域终点来源于Contack官方 regions.json,这样服务器就可以与Contack支持的数据中心保持一致.

组群需求汇总表

堆叠感知工具浓缩

开始于 0.9.0,服务器将丰富 tools/list 默认使用活堆栈上下文的响应。 浓缩帮助代理通过添加堆栈特定描述,enum值,以及支持的工具计划默认值来选择有效的ID.

支助的浓缩集团 cda, (中文(简体) ), cma, (中文(简体) ), cma-extended, (中文(简体) ), launch, (中文(简体) ), brandkit, (中文(简体) ), personalize,以及 developerhub。 。 。 .

• CDA 使用送出符来装入内容类型, 加上可选内容 CONTENTSTACK_ENVIRONMENT, (中文(简体) ), CONTENTSTACK_BRANCH,以及 CONTENTSTACK_LOCALE 默认值.
• CMA和CMA扩展使用OAuth或管理符来加载内容类型,环境,地块和分支.
• OAuth + 发射用途 CONTENTSTACK_LAUNCH_PROJECT_ID 财务报告和审定财务报表 CONTENTSTACK_ORGANIZATION_UID 以装入项目环境.
• BrandKit 使用 OAuth 附加软件 CONTENTSTACK_BRAND_KIT_ID 以装入语音配置和“知识断层”内容.
• 个性化使用 OAuth 附加 CONTENTSTACK_PERSONALIZE_PROJECT_ID 以载入属性、受众、经验和事件.
• 开发者枢纽使用 OAuth + CONTENTSTACK_API_KEY 装入市场应用.

设定 CONTENTSTACK_MCP_ENRICH_TOOLS=false 关闭浓缩。 Stack 上下文被缓存到每次连接5分钟.

使用 Claude 桌面

您可以使用此 MCP 服务器而不克隆寄存器 。 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加服务器条目 :

{
  "mcpServers": {
    "contentstack": {
      "command": "npx",
      "args": ["-y", "@contentstack/mcp"],
      "env": {
        "CONTENTSTACK_API_KEY": "<YOUR_STACK_API_KEY>",
        "CONTENTSTACK_DELIVERY_TOKEN": "<YOUR_DELIVERY_TOKEN>",
        "CONTENTSTACK_BRAND_KIT_ID": "<YOUR_BRAND_KIT_ID>",
        "CONTENTSTACK_LAUNCH_PROJECT_ID": "<YOUR_LAUNCH_PROJECT_ID>",
        "CONTENTSTACK_ORGANIZATION_UID": "<YOUR_ORGANIZATION_UID>",
        "CONTENTSTACK_PERSONALIZE_PROJECT_ID": "<YOUR_PERSONALIZE_PROJECT_ID>",
        "LYTICS_ACCESS_TOKEN": "<YOUR_LYTICS_TOKEN>",
        "GROUPS": "<COMMA_SEPARATED_GROUPS>"
      }
    }
  }
}

注释:

• 这个 CONTENTSTACK_DELIVERY_TOKEN 是可选的,只有在计划使用内容交付 API (CDA) 工具时才需要.
• 这个 CONTENTSTACK_BRAND_KIT_ID 只需要BrandKit工具.
• 这个 CONTENTSTACK_LAUNCH_PROJECT_ID 财务报告和审定财务报表 CONTENTSTACK_ORGANIZATION_UID 仅要求用于发射工具.
• 这个 CONTENTSTACK_PERSONALIZE_PROJECT_ID 仅用于个性化工具.
• 这个 LYTICS_ACCESS_TOKEN 仅需要Lytics工具.
• 在使用 CMA, CMA扩展, 分析, 自动化, BrandKit, 启动, 开发者Hub, 或个性化组之前, 您必须先运行 OAuth 认证 : npx @contentstack/mcp --auth

如果您的 MCP 客户端不支持环境变量, 传递与命令行参数相同的值 :

{
  "mcpServers": {
    "contentstack": {
      "command": "npx",
      "args": [
        "-y",
        "@contentstack/mcp",
        "--stack-api-key",
        "<YOUR_STACK_API_KEY>",
        "--delivery-token",
        "<YOUR_DELIVERY_TOKEN>",
        "--brand-kit-id",
        "<YOUR_BRAND_KIT_ID>",
        "--launch-project-id",
        "<YOUR_LAUNCH_PROJECT_ID>",
        "--organization-uid",
        "<YOUR_ORGANIZATION_UID>",
        "--lytics-access-token",
        "<YOUR_LYTICS_TOKEN>",
        "--personalize-project-id",
        "<YOUR_PERSONALIZE_PROJECT_ID>",
        "--groups",
        "<COMMA_SEPARATED_GROUPS>"
      ]
    }
  }
}

构建自己的 MCP( 工具定义 API)

内容tack发布此服务器在公开,未经认证的HTTPS端点中使用的相同工具定义. 如果您正在构建自己的 MCP 服务器,代理框架,或 API 客户端, 您可以直接获取这些定义, 并将一个工具调用翻译为 Contentack REST/ GraphQL 请求您自己 —— 无需销售此软件包 .

这些终点服务 仅限工具元数据 (名称、说明、输入图和请求绘图)。 他们没有全权证书。 当您执行相应的请求时, 您会带上您自己的签名 .

工具定义终点

每个API组发布于 https://mcp.contentstack.com/<group>/tools数字 :

curl -s https://mcp.contentstack.com/cda/tools | jq 'keys'

每个端点返回由工具名键入的JSON对象.

工具定义格式

{
  "<tool_name>": {
    "name": "get_all_assets_cdn",
    "description": "Human/LLM-facing description of what the tool does.",
    "group": "cda",
    "subGroup": "ai", // optional; only some groups (e.g. brandkit) use it
    "mapper": {/* how to build the HTTP request — see below */},
    "inputSchema": {/* JSON Schema for the tool's arguments */},
  },
}

• inputSchema 是标准的 JSON Schema —— 直接将其曝光到您的 LLM / 工具跑取器中作为工具的参数.
• mapper 告诉您如何将有效的参数转换成 HTTP 请求 :

图表QL 工具 (type: "graphql"额外携带 query (查询字符串)和 variables (图解每个图形QL变量 ) { "type": ..., "x-mapFrom": "<argName>" }) (中文(简体) ).

建立请求

考虑到工具定义和经验证的地图 args数字 :

1. URL / 路径参数 从 mapper.apiUrl; 用于每个 mapper.params 条目(placeholder → argName),替换 placeholder 与 encodeURIComponent(args[argName])。 。 。 .
2. 查询参数 ——每个 mapper.queryParams 条目,如果 args[argName] 定义,添加。 结束于 [] 序列化为重复的数组参数( e)key[]=a&key[]=b); 对象值为 JSON-字符串.
3. 页眉 ——每个 mapper.headers 条目,从 args[argName],然后添加组合的认证头(下方).
4. 体质 —— 说
   • 简单 (单位:千美元)body 是字符串 : 如果 args[body] 存在是正文的逐字;否则,所有论据都不为 params编号 :queryParams 被包裹在 body 键.
   • 复杂 (单位:千美元)type: "complex":行走计划;每片叶子用 x-mapFrom 从 args[x-mapFrom]。 。 。 .
   • 图QL (单位:千美元)type: "graphql"后点: { query, variables },从 args[variables[var]["x-mapFrom"]]。 。 。 .
5. 组合 —— 说 <base URL for group + region> + 键 <resolved apiUrl> + 键 ?<query>,用方法,头,和身体以上.

基础 URL

基础 URL 是 <region endpoint for the service> + <optional path suffix>区域终点来自区域正式文件: https://artifacts.contentstack.com/regions.json。 。 。 .

例如,针对区域 NA, (中文(简体) ), cma 决定: https://api.contentstack.io 财务报告和审定财务报表 cda 改为 https://cdn.contentstack.io语言不是区域性的: https://api.lytics.io。 。 。 .

认证信头

您提供符号值; 定义中从未包含它们 .

特定群体的额外费用: 布兰克基特 brand_kit_uid· ; 个性化 x-project-uid· ; 发射 x-project-uid, (中文(简体) ), x-organization-uid (+ 阿波罗客户端头; 分析 a 一个 orgUid 查询 OAuth 中的参数。 自动化使用 OAuth 无记名符号加 organization_uid; 自动化工程UID是路径参数.

示例——CDA:列表资产

{
  "name": "get_all_assets_cdn",
  "group": "cda",
  "mapper": {
    "apiUrl": "/v3/assets",
    "method": "GET",
    "queryParams": { "limit": "limit", "include_count": "include_count" },
    "headers": { "branch": "branch" },
  },
}

与 args = { limit: 10, include_count: true, branch: "main" }区域 EU数字 :

GET https://eu-cdn.contentstack.com/v3/assets?limit=10&include_count=true
api_key: <stack api key>
access_token: <delivery token>
branch: main

该寄存器本身是一种参考执行;见 来源于 GitHub。 。 。 .

工具目录

内容管理 API( CMA)

条目,资产,内容类型,分类,术语,分支,发布,环境,出版,变体,全域,以及条目引用.

内容管理 API 扩展( CMA 扩展)

审计日志,条目和资产版本历史,全域写作,资产文件夹管理,以及工作流程和发布规则检查. 装入 --groups cma,cma-extended。需要与 OAuth 认证相同 cma。 。 。 .

内容交付 API( CDA)

公布的条目和资产通过Contack的CDN服务.

分析 API

用法,状态代码,缓存,URL,设备,以及SDK分析.

自动化 API

自动化枢纽项目管理,自动化发现,激活控制,以及确定HTTP-触发工作流程执行.