@runehand/mcp-server

将 Runehand 公共 API v1 封装为工具的 MCP 服务器，使 MCP 客户端（Claude Desktop、Claude Code 等）能够直接操作 Runehand 机器人：列出机器人和流程、阅读和回复对话、管理潜在客户以及查看分析数据。

设置

1. 在 https://app.runehand.co/settings/api-keys 生成 API 密钥（需要 Pro 或 Enterprise 套餐，以及工作区中的 owner 或 admin 角色）。明文密钥只显示一次——请复制它。

2. 将此添加到您的 MCP 客户端配置中（示例：Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "runehand": {
      "command": "npx",
      "args": ["-y", "@runehand/mcp-server"],
      "env": { "RUNEHAND_API_KEY": "rh_live_..." }
    }
  }
}

3. 重启您的 MCP 客户端。它现在应该会列出 9 个 Runehand 工具。

Related MCP server: eduframe-mcp

配置

工具

Runehand API 的错误以 "{code}: {message}" 的形式作为工具错误呈现（例如 not_found: Not found.）——请参阅 API 文档中的错误代码表。

开发

npm install
npm run dev      # run directly with tsx, no build step
npm test         # vitest, mocks all HTTP via msw
npm run lint
npm run typecheck
npm run build     # compiles to dist/

许可证

MIT