跳到內容
Hashee Docs

Claude Code Plugin

Hashee Claude Code Plugin 讓 Claude Code 透過 Model Context Protocol（MCP）與 Hashee 對話互動。你的 Claude Code Agent 可以傳送訊息、上傳檔案、串流回覆和傳送 Artifact——全部在你的編碼環境中完成。

什麼是 MCP？

Model Context Protocol（MCP）是 Anthropic 用於將 AI 工具連接到外部服務的標準。它使用基於 stdio 的通訊協議，其中工具被註冊為可呼叫的函式。

運作方式

Claude Code ──stdio──> Hashee MCP Plugin ──Agent SDK (WS)──> Hashee API
                       │
                       ├── 7 個工具（send、receive、stream、upload...）
                       ├── 頻道推送（將傳入訊息推送到 Claude Code）
                       └── 權限中繼（從 Hashee App 批准/拒絕）

此外掛透過 Agent SDK 以 WebSocket 連接到 Hashee，並透過 MCP 向 Claude Code 公開 7 個工具。

可用工具

工具參數說明
hashee_send_messageconversation_id, text透過 Agent SDK 傳送文字訊息
hashee_get_messagesconversation_id, limit?取得最近的訊息（預設 20，最多 50）
hashee_list_conversations（無）列出 Agent 的活躍對話
hashee_typingconversation_id傳送輸入中指示器
hashee_send_artifactconversation_id, artifact, title, summary?傳送 A2H Artifact（表單、狀態、錯誤卡片）
hashee_stream_replyconversation_id, text串流回覆（100 字元區塊，30ms 間隔）
hashee_send_fileconversation_id, file_path, content_type?上傳本機檔案（最大 100MB，自動 MIME 偵測）

設定

1. 配置 .mcp.json

將 Hashee 伺服器加入你的專案 MCP 配置：

{
  "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是—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 工具可用。

頻道推送

傳入的 Hashee 訊息會以頻道通知的形式推送到 Claude Code。僅轉發來自 HASHEE_ALLOWED_USERS 白名單中使用者的訊息。

此外掛會對內容進行清理（XML 跳脫以防止頻道注入）並在 10,000 個字元處截斷。

權限中繼

此外掛支援 Claude Code 和 Hashee App 之間的雙向權限中繼：

  1. Claude Code 請求權限（例如執行命令）
  2. 外掛向 Hashee App 傳送帶有批准/拒絕按鈕的 Artifact
  3. 使用者在 Hashee App 中回應
  4. 決定被中繼回 Claude Code

請求在 60 秒後自動拒絕。

安全性

層級機制
發送者白名單僅 HASHEE_ALLOWED_USERS 可推送到頻道
XML 清理防止頻道注入攻擊
內容截斷10,000 字元限制
檔案路徑限制send_file 僅允許工作目錄內的檔案
權限逾時60 秒後自動拒絕
Agent 驗證所有 REST 呼叫使用 Bearer Token

下一步