# @kerabie/mcp 中文文档

规范地址：https://npmcn.com/package/%40kerabie/mcp/

版本：1\.1\.4
npm 元数据更新时间：2026-11-01T12:13:55.369Z
中文译文更新时间：2026-11-01T15:54:01.185Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40kerabie/mcp
原文对照：https://npmcn.com/package/%40kerabie/mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：647 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：3 个
- 首次发布：2026-10-09T07:37:14.870Z
- 最新版本发布：2026-11-01T12:13:55.190Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

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

## 安装

```sh
npm install @kerabie/mcp
```

也可以使用：`pnpm add @kerabie/mcp`、`yarn add @kerabie/mcp`、`bun add @kerabie/mcp`

## README

# @kerabie / mcp

一个 [MCP](https://modelcontextprotocol.io/) 服务器 [Kerabie](https://kerabie.com/)． 连接克劳德，光标或任何MCP客户端建立与Kerabie和工作与您的帐户。

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

## 托管（无需安装）

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

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

**克劳德代码**

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

**光标** （`.cursor/mcp.json`）

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

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

## 在本地运行

将服务器添加到您的MCP客户端（克劳德桌面，光标，克劳德代码）：

```json
{
  "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_ONLY` | `true` (或通过 `--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](https://kerabie.com/docs/sdks/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（2 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/10/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。