# MCP

> 通过 Kanorio 的远程 MCP 服务器，将 Claude、ChatGPT、Cursor 和其他 AI 助手连接至 Management API。

> Markdown version of https://kanorio.com/zh-CN/developers/mcp. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/mcp.md

Model Context Protocol 服务器是 AI 助手的 Management API。每个操作都是一个工具，工具名称即为 [Management API 参考文档](https://kanorio.com/en/developers/management-api) 中的 `operationId`，例如 `posts_create` 或 `site_publish`。权限、错误、速率限制和草稿的运作方式与 REST 完全相同。

|  |  |
|---|---|
| 服务器网址 | `https://app.kanorio.com/api/mcp` |
| 传输方式 | 流式 HTTP |
| 验证方式 | OAuth 2.1，或 Bearer 个人访问令牌或服务账号令牌 |
| 注册表名称 | `com.kanorio/kanorio` |

## 具备连接器的 AI 助手

Claude、ChatGPT 和其他具备内置连接器的 AI 助手使用 OAuth，因此无需手动处理令牌。

1. 在 AI 助手的连接器设置中，添加一个自定义连接器，并将服务器 URL 设置为 `https://app.kanorio.com/api/mcp`。请勿将此 URL 粘贴到聊天窗口中。
2. 当 AI 助手打开授权页面时，登录 Kanorio，选择网站和权限，并进行批准。

AI 助手会从 `https://app.kanorio.com/.well-known/oauth-protected-resource` 自动发现其余信息。Kanorio 支持动态客户端注册和客户端 ID 元数据文档。您可以随时在账号设置中查看并撤销已批准的应用程序。

## 使用令牌的编程 AI 助手

Cursor、Claude Code、Codex、Gemini CLI、Windsurf 和 VS Code 使用个人访问令牌。请在 [账号设置 › API 访问](https://app.kanorio.com/account/api-access) 中创建令牌。选择工具后，Kanorio 会显示已自动填入您令牌的配置信息。

**Cursor** (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "kanorio": {
      "url": "https://app.kanorio.com/api/mcp",
      "headers": { "Authorization": "Bearer knr_pat_..." }
    }
  }
}
```

**Claude Code:**

```bash
claude mcp add --transport http kanorio https://app.kanorio.com/api/mcp --header "Authorization: Bearer knr_pat_..."
```

**VS Code** (`.vscode/mcp.json`):

```json
{
  "servers": {
    "kanorio": {
      "type": "http",
      "url": "https://app.kanorio.com/api/mcp",
      "headers": { "Authorization": "Bearer knr_pat_..." }
    }
  }
}
```

**Codex** (`~/.codex/config.toml`):

```toml
[mcp_servers.kanorio]
url = "https://app.kanorio.com/api/mcp"
http_headers = { "Authorization" = "Bearer knr_pat_..." }
```

请勿将包含令牌的文件纳入版本控制。

## 工具运作方式

- **仅限令牌允许的操作。** `tools/list` 会隐藏令牌权限范围外的工具。调用 `auth_whoami` 可查看令牌权限和任何隐藏的功能。
- **发布前均为草稿。** 内容写入操作会保留为草稿，直到执行 `site_publish`、`posts_publish` 或其他发布工具为止。
- **结构化结果。** 每个工具都会返回符合该操作响应结构描述的结构化内容。列表使用 [分页封装](https://kanorio.com/zh-CN/developers/basics/pagination)。
- **错误。** 失败的调用会返回 `isError` 和 [错误封装](https://kanorio.com/zh-CN/developers/basics/errors)。`FORBIDDEN`、计划和模式错误属于限制而非程序错误；`details` 字段会说明用户需要调整的内容。
- **幂等性。** 支持幂等性的创建操作工具会接收 `idempotencyKey` 参数。请参阅 [幂等性](https://kanorio.com/zh-CN/developers/basics/idempotency)。
- **弃用。** 已弃用工具的说明开头会标示 `[Deprecated, removed after …; use …]`。

## 服务器版本

本服务器遵循语义化版本控制，信息记录于 `serverInfo.version` 及 `https://app.kanorio.com/.well-known/mcp/server.json` 中。[变更日志](https://kanorio.com/en/developers/changelog) 记录了每个版本的变更。主版本号更新代表现有工具的运作方式可能有所变动，因此缓存工具结构描述的客户端应进行刷新。