MCP

Model Context Protocol 服务器是 AI 助手的 Management API。每个操作都是一个工具，工具名称即为 Management API 参考文档 中的 operationId，例如 posts_create 或 site_publish。权限、错误、速率限制和草稿的运作方式与 REST 完全相同。

具备连接器的 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 访问 中创建令牌。选择工具后，Kanorio 会显示已自动填入您令牌的配置信息。

Cursor (.cursor/mcp.json):

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

Claude Code:

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

VS Code (.vscode/mcp.json):

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

Codex (~/.codex/config.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 或其他发布工具为止。
• 结构化结果。 每个工具都会返回符合该操作响应结构描述的结构化内容。列表使用 分页封装。
• 错误。 失败的调用会返回 isError 和 错误封装。FORBIDDEN、计划和模式错误属于限制而非程序错误；details 字段会说明用户需要调整的内容。
• 幂等性。 支持幂等性的创建操作工具会接收 idempotencyKey 参数。请参阅 幂等性。
• 弃用。 已弃用工具的说明开头会标示 [Deprecated, removed after …; use …]。

服务器版本

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