컨텐츠로 건너뛰기
Hashee Docs

Claude Code Plugin

Hashee Claude Code Plugin은 Model Context Protocol (MCP)을 통해 Claude Code가 Hashee 대화와 상호작용할 수 있게 합니다. Claude Code 에이전트가 코딩 환경 내에서 메시지를 보내고, 파일을 업로드하고, 응답을 스트리밍하고, 아티팩트를 전송할 수 있습니다.

MCP란?

Model Context Protocol (MCP)은 AI 도구를 외부 서비스에 연결하기 위한 Anthropic의 표준입니다. 도구가 호출 가능한 함수로 등록되는 stdio 기반 통신 프로토콜을 사용합니다.

작동 방식

Claude Code ──stdio──> Hashee MCP Plugin ──Agent SDK (WS)──> Hashee API
                       │
                       ├── 7 도구 (send, receive, stream, upload...)
                       ├── 채널 Push (Hashee에서 Claude Code로의 수신 메시지)
                       └── 권한 Relay (Hashee 앱에서의 승인/거부)

플러그인은 Agent SDK를 통해 WebSocket으로 Hashee에 연결하고, MCP를 통해 7개의 도구를 Claude Code에 노출합니다.

사용 가능한 도구

도구매개변수설명
hashee_send_messageconversation_id, textAgent SDK를 통해 텍스트 메시지 전송
hashee_get_messagesconversation_id, limit?최근 메시지 가져오기 (기본 20, 최대 50)
hashee_list_conversations(없음)에이전트의 활성 대화 목록
hashee_typingconversation_id타이핑 표시기 전송
hashee_send_artifactconversation_id, artifact, title, summary?A2H 아티팩트 전송 (양식, 상태, 오류 카드)
hashee_stream_replyconversation_id, text응답 스트리밍 (100자 청크, 30ms 간격)
hashee_send_fileconversation_id, file_path, content_type?로컬 파일 업로드 (최대 100MB, 자동 MIME 감지)

설정

1. .mcp.json 구성

프로젝트의 MCP 구성에 Hashee 서버를 추가하세요:

{
  "mcpServers": {
    "hashee": {
      "command": "npx",
      "args": ["tsx", "packages/public/claude-code-plugin/src/index.ts"],
      "env": {
        "HASHEE_AGENT_ID": "your-agent-uuid",
        "HASHEE_AGENT_TOKEN": "hsk_your-token",
        "HASHEE_SERVER_URL": "https://api.hashee.ai",
        "HASHEE_ALLOWED_USERS": "user-id-1,user-id-2"
      }
    }
  }
}

2. 환경 변수

변수필수기본값설명
HASHEE_AGENT_ID예—Agent UUID
HASHEE_AGENT_TOKEN예—에이전트 인증 토큰
HASHEE_ALLOWED_USERS예—쉼표로 구분된 사용자 ID 허용 목록
HASHEE_SERVER_URL아니오https://api.hashee.aiAPI 기본 URL
HASHEE_CONNECTION_MODE아니오websocketwebsocket 또는 longpoll

3. Claude Code 시작

Claude Code가 자동으로 MCP 서버를 감지하고 Hashee 도구를 사용할 수 있게 합니다.

채널 Push

Hashee 수신 메시지가 채널 알림으로 Claude Code에 푸시됩니다. HASHEE_ALLOWED_USERS 목록에 있는 사용자의 메시지만 전달됩니다.

플러그인은 콘텐츠를 정제하고(채널 인젝션을 방지하기 위해 XML 이스케이프) 10,000자에서 잘라냅니다.

권한 Relay

플러그인은 Claude Code와 Hashee 앱 간의 양방향 권한 릴레이를 지원합니다:

  1. Claude Code가 권한을 요청합니다 (예: 명령 실행)
  2. 플러그인이 승인/거부 버튼이 있는 아티팩트를 Hashee 앱으로 전송합니다
  3. 사용자가 Hashee 앱에서 응답합니다
  4. 결정이 Claude Code로 다시 전달됩니다

요청은 60초 후 자동 거부됩니다.

보안

레이어메커니즘
발신자 허용 목록HASHEE_ALLOWED_USERS만 채널에 푸시 가능
XML 정제채널 인젝션 공격 방지
콘텐츠 잘라내기10,000자 제한
파일 경로 제한send_file은 작업 디렉토리 내 파일만 허용
권한 타임아웃60초 후 자동 거부
에이전트 인증모든 REST 호출에 Bearer 토큰

다음 단계