@kerabie/mcp

中文文档
1.1.4发布于 2026/11/01MITTypeScriptES Module

用于Kerabie的MCP服务器:让Claude, Cursor和其他MCP客户端与您的对话,门票,联系人,活动,知识库,分析和AI工具一起工作

中文使用文档
文档目录5 节
  1. 托管(无需安装)
  2. 在本地运行
  3. 安全
  4. 文档
  5. 许可证

@kerabie / mcp

一个 MCP 服务器 Kerabie. 连接克劳德,光标或任何MCP客户端建立与Kerabie和工作与您的帐户。

  • 使用Kerabie构建,不需要API密钥: 搜索文档,列出REST端点,阅读TypeScript、React Native和Flutter SDK类型,并获得集成指南(typescript, react-native, flutter, wordpress, web-widget, rest-api). 答案来自包中捆绑的文档,因此它们与您安装的版本相匹配。
  • 使用您的帐户,使用API密钥: 对话、门票、联系人、活动、知识库、分析、人工智能工具和你的聊天机器人使用的MCP服务器。它是薄薄的一层 @kerabie/sdk 和 /v1 API,所以它能做你的键能做的事,仅此而已。

托管(无需安装)

将您的客户端指向托管服务器,并将您的API密钥作为承载令牌发送。

https://mcp.kerabie.com/mcp
Authorization: Bearer ker_live_...

克劳德代码

claude mcp add --transport http kerabie https://mcp.kerabie.com/mcp --header "Authorization: Bearer ker_live_..."

光标 (.cursor/mcp.json)

{
  "mcpServers": {
    "kerabie": {
      "url": "https://mcp.kerabie.com/mcp",
      "headers": { "Authorization": "Bearer ker_live_..." }
    }
  }
}

添加 ?readOnly=true 到URL,以省略所有更改数据的工具。没有密钥,只提供开发人员工具。您的密钥用于每次调用,并且永远不会存储。

在本地运行

将服务器添加到您的MCP客户端(克劳德桌面,光标,克劳德代码):

{
  "mcpServers": {
    "kerabie": {
      "command": "npx",
      "args": ["-y", "@kerabie/mcp"],
      "env": { "KERABIE_API_KEY": "ker_live_..." }
    }
  }
}

或者加到克劳德代码里 claude mcp add kerabie --env KERABIE_API_KEY=ker_live_... -- npx -y @kerabie/mcp.

变量
KERABIE_API_KEY可选的。API密钥来自Settings > Integrations > API密钥。没有它,只提供开发人员工具。
KERABIE_ORG_ID可选的。只有当密钥覆盖多个组织时。
KERABIE_BASE_URL可选的。默认为 https://api.kerabie.com.
KERABIE_MCP_READ_ONLYtrue (或通过 --read-only)只提供可阅读的工具。

要通过HTTP自己提供服务,请运行 kerabie-mcp-http (设置 PORT,可选 KERABIE_BASE_URL)。端点是 POST /mcp, GET /health 用于健康检查。

安全

MCP客户端可以使用您的密钥允许的所有工具,包括回复客户或删除内容的工具。改变数据的工具携带MCP readOnlyHint: false 注释,以及删除注释 destructiveHint: true,因此客户可以在运行它们之前询问。启动只读,并保持客户端的审批提示打开。

API访问是在Pro计划及以上。

文档

完整的工具列表和指南: https://kerabie.com/docs/sdks/mcp

许可证

麻省理工学院

版本与发布记录

@kerabie/mcp 共发布 9 个版本,首次发布于 2026/10/09;过去 12 个月发布了 9 个版本。

版本发布日期距今
1.1.4latest2026/11/011 天前
1.1.32026/11/011 天前
1.1.22026/11/012 天前
1.1.12026/11/012 天前
1.1.02026/11/012 天前
1.0.22026/10/304 天前

关于 @kerabie/mcp 的常见问题

@kerabie/mcp 是什么?

用于Kerabie的MCP服务器:让Claude, Cursor和其他MCP客户端与您的对话,门票,联系人,活动,知识库,分析和AI工具一起工作

如何安装 @kerabie/mcp?

在项目目录运行 npm install @kerabie/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 kerabie-mcp、kerabie-mcp-http,可以用 npx kerabie-mcp 直接运行。

@kerabie/mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@kerabie/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@kerabie/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@kerabie/mcp 可以商用吗?

@kerabie/mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@kerabie/mcp 还在维护吗?

最新版本 1.1.4 发布于 2026/11/01(1 天前);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/10/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。