回天的MCP服务器——通过模型上下文协议，让AI代理访问棋盘、卡片和属性。

它是建立在回天SDK之上的。

安装

MISE（推荐）

MISE 为你的平台安装了最新版本的二进制文件：

GitHub 发布

从发布页面下载你平台的二进制文件。

来自源头

从源代码构建需要Swift 6.3或更新版本。

用途

1.获取回天API令牌

在https:// .kaiten.ru/profile/api-key获取您的API令牌。

2.配置凭证

凭据存储在~/.config/kaiten/config.json中（与CLI共享）：

或者连接后通过MCP设置凭证：

• 用url和token呼号kaiten_login。
• 服务器即使没有凭据也能启动;API 工具会懒惰地验证配置，并在缺少凭证时返回错误，提示运行 kaiten_login。
• 调用 kaiten_read_logs 获取 MCP 日志文件路径和内容（可选 [tail_lines）。

3.连接您的AI工具

请参阅集成指南，了解以下步骤：

• Claude桌面
• Claude 代码（CLI）
• GitHub Copilot（VS Code）
• GitHub Copilot CLI
• 光标
• OpenAI Codex CLI
• 风帆冲浪

API 参考

kaiten-mcp

MCP server for Kaiten — gives AI agents access to boards, cards, and properties via Model Context Protocol.

Built on top of kaiten-sdk.

Installation

mise (recommended)

mise installs the latest release binary for your platform:

mise use github:alldmeat/kaiten-mcp

GitHub Release

Download the binary for your platform from the releases page.

From Source

Building from source requires Swift 6.3 or newer.

swift build -c release
# Binary: .build/release/kaiten-mcp

Usage

1. Get a Kaiten API Token

Get your API token at https://.kaiten.ru/profile/api-key.

2. Configure Credentials

Credentials are stored in ~/.config/kaiten/config.json (shared with the CLI):

{
  "url": "https://.kaiten.ru/api/latest",
  "token": ""
}

Or set credentials through MCP after connecting:

• Call kaiten_login with url and token.
• The server starts even without credentials; API tools validate config lazily and return an error telling you to run kaiten_login when credentials are missing.
• Call kaiten_read_logs to get MCP log file path and contents (optionally tail_lines).

3. Connect to Your AI Tool

See the Integration Guide for step-by-step instructions for:

• Claude Desktop
• Claude Code (CLI)
• GitHub Copilot (VS Code)
• GitHub Copilot CLI
• Cursor
• OpenAI Codex CLI
• Windsurf

API Reference

Cards

Spaces