Lewati ke konten
Hashee Docs

Claude Code Plugin

Hashee Claude Code Plugin cho phép Claude Code tương tác với hội thoại Hashee qua Model Context Protocol (MCP). Agent Claude Code có thể gửi tin nhắn, tải tệp, truyền phản hồi và gửi artifact — tất cả từ môi trường code.

MCP Là Gì?

Model Context Protocol (MCP) là tiêu chuẩn của Anthropic để kết nối công cụ AI với dịch vụ bên ngoài. Nó sử dụng giao thức stdio nơi công cụ được đăng ký dưới dạng hàm gọi được.

Cách Hoạt Động

Claude Code ──stdio──> Hashee MCP Plugin ──Agent SDK (WS)──> Hashee API
                       │
                       ├── 7 Tools (send, receive, stream, upload...)
                       ├── Channel Push (tin nhắn đến cho Claude Code)
                       └── Permission Relay (phê duyệt/từ chối từ ứng dụng Hashee)

Plugin kết nối Hashee qua Agent SDK qua WebSocket và cung cấp 7 công cụ cho Claude Code qua MCP.

Công Cụ Có Sẵn

Công cụTham sốMô tả
hashee_send_messageconversation_id, textGửi tin nhắn văn bản qua Agent SDK
hashee_get_messagesconversation_id, limit?Lấy tin nhắn gần đây (mặc định 20, tối đa 50)
hashee_list_conversations(không)Liệt kê hội thoại đang hoạt động
hashee_typingconversation_idGửi chỉ báo đang gõ
hashee_send_artifactconversation_id, artifact, title, summary?Gửi artifact A2H (biểu mẫu, trạng thái, thẻ lỗi)
hashee_stream_replyconversation_id, textTruyền phản hồi (chunk 100 ký tự, interval 30ms)
hashee_send_fileconversation_id, file_path, content_type?Tải tệp cục bộ (tối đa 100MB, tự phát hiện MIME)

Cài Đặt

1. Cấu Hình .mcp.json

Thêm máy chủ Hashee vào cấu hình MCP dự án:

{
  "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. Biến Môi Trường

BiếnBắt buộcMặc địnhMô tả
HASHEE_AGENT_IDCó—UUID Agent
HASHEE_AGENT_TOKENCó—Token xác thực agent
HASHEE_ALLOWED_USERSCó—Danh sách ID người dùng cho phép, phân cách bằng dấu phẩy
HASHEE_SERVER_URLKhônghttps://api.hashee.aiURL gốc API
HASHEE_CONNECTION_MODEKhôngwebsocketwebsocket hoặc longpoll

3. Khởi Động Claude Code

Claude Code tự động phát hiện máy chủ MCP và cung cấp công cụ Hashee.

Channel Push

Tin nhắn Hashee đến được đẩy đến Claude Code dưới dạng thông báo kênh. Chỉ tin nhắn từ người dùng trong HASHEE_ALLOWED_USERS được chuyển tiếp.

Plugin làm sạch nội dung (escape XML để ngăn injection kênh) và cắt ngắn ở 10.000 ký tự.

Permission Relay

Plugin hỗ trợ chuyển tiếp quyền hai chiều giữa Claude Code và ứng dụng Hashee:

  1. Claude Code yêu cầu quyền (ví dụ: thực thi lệnh)
  2. Plugin gửi Artifact đến ứng dụng Hashee với nút phê duyệt/từ chối
  3. Người dùng phản hồi trong ứng dụng Hashee
  4. Quyết định được chuyển lại Claude Code

Yêu cầu tự động từ chối sau 60 giây.

Bảo Mật

LớpCơ chế
Danh sách cho phép người gửiChỉ HASHEE_ALLOWED_USERS có thể đẩy vào kênh
Làm sạch XMLNgăn tấn công injection kênh
Cắt ngắn nội dungGiới hạn 10.000 ký tự
Hạn chế đường dẫn tệpsend_file chỉ cho phép tệp trong thư mục làm việc
Timeout quyềnTự động từ chối sau 60 giây
Xác thực agentBearer token trên mọi cuộc gọi REST

Bước Tiếp Theo