Claude Code Plugin

O Hashee Claude Code Plugin permite que o Claude Code interaja com conversas do Hashee atraves do Model Context Protocol (MCP). Seu agente Claude Code pode enviar mensagens, fazer upload de arquivos, transmitir respostas e enviar artifacts — tudo de dentro do seu ambiente de codificacao.

O Que e MCP?

O Model Context Protocol (MCP) e o padrao da Anthropic para conectar ferramentas de IA a servicos externos. Usa um protocolo de comunicacao baseado em stdio onde ferramentas sao registradas como funcoes chamaveis.

Como Funciona

Claude Code ──stdio──> Hashee MCP Plugin ──Agent SDK (WS)──> Hashee API
                       │
                       ├── 7 Tools (send, receive, stream, upload...)
                       ├── Channel Push (mensagens recebidas para Claude Code)
                       └── Permission Relay (aprovar/negar do app Hashee)

O plugin se conecta ao Hashee via Agent SDK por WebSocket e expoe 7 ferramentas ao Claude Code atraves do MCP.

Ferramentas Disponiveis

Ferramenta	Parametros	Descricao
`hashee_send_message`	`conversation_id`, `text`	Enviar mensagem de texto via Agent SDK
`hashee_get_messages`	`conversation_id`, `limit?`	Buscar mensagens recentes (padrao 20, max 50)
`hashee_list_conversations`	(nenhum)	Listar conversas ativas do agente
`hashee_typing`	`conversation_id`	Enviar indicador de digitacao
`hashee_send_artifact`	`conversation_id`, `artifact`, `title`, `summary?`	Enviar um artifact A2H (formulario, status, cartao de erro)
`hashee_stream_reply`	`conversation_id`, `text`	Transmitir uma resposta (fragmentos de 100 caracteres, intervalo de 30ms)
`hashee_send_file`	`conversation_id`, `file_path`, `content_type?`	Fazer upload de arquivo local (max 100MB, deteccao automatica de MIME)

Configuracao

1. Configure `.mcp.json`

Adicione o servidor Hashee a configuracao MCP do seu projeto:

{
  "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. Variaveis de Ambiente

Variavel	Obrigatorio	Padrao	Descricao
`HASHEE_AGENT_ID`	Sim	—	UUID do agente
`HASHEE_AGENT_TOKEN`	Sim	—	Token de autenticacao do agente
`HASHEE_ALLOWED_USERS`	Sim	—	Lista de IDs de usuarios permitidos separados por virgula
`HASHEE_SERVER_URL`	Nao	`https://api.hashee.ai`	URL base da API
`HASHEE_CONNECTION_MODE`	Nao	`websocket`	`websocket` ou `longpoll`

3. Inicie o Claude Code

O Claude Code detectara automaticamente o servidor MCP e disponibilizara as ferramentas Hashee.

Channel Push

Mensagens recebidas do Hashee sao enviadas ao Claude Code como notificacoes de canal. Apenas mensagens de usuarios na lista HASHEE_ALLOWED_USERS sao encaminhadas.

O plugin sanitiza conteudo (escape XML para prevenir injecao de canal) e trunca em 10.000 caracteres.

Permission Relay

O plugin suporta relay de permissao bidirecional entre Claude Code e o aplicativo Hashee:

Claude Code solicita uma permissao (ex.: executar um comando)
O plugin envia um Artifact ao aplicativo Hashee com botoes de aprovar/negar
O usuario responde no aplicativo Hashee
A decisao e retransmitida de volta ao Claude Code

Solicitacoes sao negadas automaticamente apos 60 segundos.

Seguranca

Camada	Mecanismo
Lista de remetentes permitidos	Apenas `HASHEE_ALLOWED_USERS` podem enviar para o canal
Sanitizacao XML	Previne ataques de injecao de canal
Truncamento de conteudo	Limite de 10.000 caracteres
Restricao de caminho de arquivo	`send_file` permite apenas arquivos dentro do diretorio de trabalho
Timeout de permissao	Negacao automatica apos 60 segundos
Auth do agente	Bearer token em todas as chamadas REST

Proximos Passos

Codex Plugin — Integracao com OpenAI Codex
OpenClaw Plugin — Integracao com OpenClaw
SDK - Primeiros Passos — Construa um agente standalone