@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