Skip to main content
Glama
@runehand/mcp-server

@runehand/mcp-server

@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_..." }
    }
  }
}
  1. MCP 클라이언트를 다시 시작하세요. 이제 9개의 Runehand 도구가 나열될 것입니다.

Related MCP server: eduframe-mcp

구성

환경 변수

필수

기본값

용도

RUNEHAND_API_KEY

예

—

/settings/api-keys에서 발급된 Bearer 토큰.

RUNEHAND_API_BASE_URL

아니요

https://app.runehand.co/api/v1

로컬/스테이징 테스트 전용 재정의.

도구

도구

설명

list_bots

API 키를 소유한 워크스페이스에 속한 봇을 나열합니다.

list_flows

봇의 UUID를 기준으로 해당 봇에 속한 플로우를 나열합니다.

get_flow

실행 가능한 형식의 노드를 포함한 단일 플로우를 가져옵니다.

list_conversations

대화를 나열하며, 선택적으로 bot_id 및/또는 status로 필터링할 수 있습니다.

get_conversation

메시지를 포함한 단일 대화를 가져옵니다.

send_message

기존 대화에서 에이전트로 메시지를 보냅니다.

list_leads

리드를 나열하며, 선택적으로 bot_id 및/또는 status로 필터링할 수 있습니다.

create_lead

연결된 대화 없이 리드를 직접 생성합니다.

get_analytics

날짜 범위에 대한 워크스페이스 KPI 및 빠른 통계를 가져옵니다.

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

Available Tools

9 tools
create_leadCreate leadB

Create a lead directly, without an associated conversation. Does not trigger the LeadCaptured event.

Inputs: bot_id (required), name, tags, email, +4 more.

get_analyticsGet analytics dashboardA

Get workspace KPIs and quick stats for a date range, same data as the in-app dashboard.

Inputs: to, from.

get_conversationGet conversation detailA

Get a single conversation, including its messages in chronological order.

Inputs: conversation_id (required).

get_flowGet flow detailB

Get a single flow, including its nodes in executable format.

Inputs: flow_id (required).

list_botsList botsB

List the bots that belong to the workspace that owns the API key.

Inputs: page, per_page.

list_conversationsList conversationsA

List conversations for the workspace, optionally filtered by bot_id and/or status.

Inputs: page, bot_id, status, per_page.

list_flowsList flowsC

List the flows that belong to a bot, given the bot's UUID.

Inputs: bot_id (required), page, per_page.

list_leadsList leadsB

List leads for the workspace, optionally filtered by bot_id and/or status.

Inputs: page, bot_id, status, per_page.

send_messageSend messageA

Send a message as the agent in an existing conversation. Delivers to the external channel (WhatsApp, Telegram, etc.) when the conversation is not on the web channel.

Inputs: content (required), conversation_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: bots, flows, conversations, analytics, messaging, and leads. The list/get pairs follow a clear resource-detail distinction, so an agent can reliably select the intended tool.

    Naming Consistency5/5

    All tools use lowercase snake_case verb_noun naming: list_*, get_*, send_message, create_lead. The pattern is consistent and predictable across the entire surface.

    Tool Count5/5

    Nine tools is well-scoped for a workspace/bot/conversation/lead management server. Each tool corresponds to a meaningful operation, and there is no redundant bloat.

    Completeness4/5

    Read/query coverage is strong across bots, flows, conversations, leads, and analytics, with messaging and lead creation included. Minor gaps exist—no lead status update, conversation creation/closure, or flow editing—but these are likely handled outside this server's read-and-engage scope.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers