Claude Code Plugin

Hashee Claude Code Plugin дозволяє Claude Code взаємодіяти з розмовами Hashee через Model Context Protocol (MCP). Ваш агент Claude Code може надсилати повідомлення, завантажувати файли, транслювати відповіді та надсилати Artifacts — все з вашого середовища розробки.

Що таке MCP?

Model Context Protocol (MCP) — це стандарт Anthropic для підключення AI-інструментів до зовнішніх сервісів. Він використовує протокол комунікації через stdio, де інструменти реєструються як функції, що викликаються.

Як це працює

Claude Code ──stdio──> Hashee MCP Plugin ──Agent SDK (WS)──> Hashee API
                       │
                       ├── 7 інструментів (send, receive, stream, upload...)
                       ├── Channel Push (вхідні повідомлення до Claude Code)
                       └── Permission Relay (approve/deny з додатку Hashee)

Plugin підключається до Hashee через Agent SDK по WebSocket та надає 7 інструментів Claude Code через MCP.

Доступні інструменти

Інструмент	Параметри	Опис
`hashee_send_message`	`conversation_id`, `text`	Надіслати текстове повідомлення через Agent SDK
`hashee_get_messages`	`conversation_id`, `limit?`	Отримати останні повідомлення (за замовч. 20, макс. 50)
`hashee_list_conversations`	(немає)	Список активних розмов агента
`hashee_typing`	`conversation_id`	Надіслати індикатор друку
`hashee_send_artifact`	`conversation_id`, `artifact`, `title`, `summary?`	Надіслати A2H Artifact (форма, статус, картка помилки)
`hashee_stream_reply`	`conversation_id`, `text`	Потокова відповідь (фрагменти по 100 символів, інтервал 30мс)
`hashee_send_file`	`conversation_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`	Так	—	UUID агента
`HASHEE_AGENT_TOKEN`	Так	—	Токен автентифікації агента
`HASHEE_ALLOWED_USERS`	Так	—	Список дозволених ID користувачів через кому
`HASHEE_SERVER_URL`	Ні	`https://api.hashee.ai`	Базовий URL API
`HASHEE_CONNECTION_MODE`	Ні	`websocket`	`websocket` або `longpoll`

3. Запустіть Claude Code

Claude Code автоматично виявить MCP-сервер та зробить інструменти Hashee доступними.

Channel Push

Вхідні повідомлення Hashee передаються до Claude Code як канальні сповіщення. Пересилаються лише повідомлення від користувачів зі списку HASHEE_ALLOWED_USERS.

Plugin санітизує контент (XML-екранування для запобігання ін’єкції каналу) та обрізає до 10 000 символів.

Permission Relay

Plugin підтримує двонаправлену ретрансляцію дозволів між Claude Code та додатком Hashee:

Claude Code запитує дозвіл (наприклад, на виконання команди)
Plugin надсилає Artifact до додатку Hashee з кнопками approve/deny
Користувач відповідає в додатку Hashee
Рішення ретранслюється назад до Claude Code

Запити автоматично відхиляються після 60 секунд.

Безпека

Рівень	Механізм
Список дозволених відправників	Лише `HASHEE_ALLOWED_USERS` можуть передавати в канал
XML-санітизація	Запобігає атакам ін’єкції каналу
Обрізання контенту	Ліміт 10 000 символів
Обмеження шляхів файлів	`send_file` дозволяє лише файли в робочій директорії
Тайм-аут дозволів	Автовідхилення після 60 секунд
Автентифікація агента	Bearer token на всіх REST викликах

Наступні кроки

Codex Plugin — Інтеграція OpenAI Codex
OpenClaw Plugin — Інтеграція OpenClaw
Початок роботи з SDK — Створення автономного агента