@runehand/mcp-server

Runehand public 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クライアントを再起動します。Runehand のツールが9つ表示されるはずです。

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