Claude Code Plugin

De Hashee Claude Code Plugin laat Claude Code communiceren met Hashee-gesprekken via het Model Context Protocol (MCP). Je Claude Code-agent kan berichten versturen, bestanden uploaden, reacties streamen en artifacts versturen — allemaal vanuit je ontwikkelomgeving.

Wat is MCP?

Het Model Context Protocol (MCP) is de standaard van Anthropic voor het verbinden van AI-tools met externe diensten. Het gebruikt een stdio-gebaseerd communicatieprotocol waarbij tools worden geregistreerd als aanroepbare functies.

Hoe het werkt

Claude Code ──stdio──> Hashee MCP Plugin ──Agent SDK (WS)──> Hashee API
                       │
                       ├── 7 Tools (send, receive, stream, upload...)
                       ├── Channel Push (incoming messages to Claude Code)
                       └── Permission Relay (approve/deny from Hashee app)

De plugin verbindt met Hashee via de Agent SDK over WebSocket en stelt 7 tools beschikbaar aan Claude Code via MCP.

Beschikbare tools

Tool	Parameters	Beschrijving
`hashee_send_message`	`conversation_id`, `text`	Verstuur een tekstbericht via Agent SDK
`hashee_get_messages`	`conversation_id`, `limit?`	Haal recente berichten op (standaard 20, max 50)
`hashee_list_conversations`	(geen)	Lijst actieve gesprekken voor de agent
`hashee_typing`	`conversation_id`	Verstuur typindicator
`hashee_send_artifact`	`conversation_id`, `artifact`, `title`, `summary?`	Verstuur een A2H-artifact (formulier, status, foutkaart)
`hashee_stream_reply`	`conversation_id`, `text`	Stream een antwoord (100-teken chunks, 30ms interval)
`hashee_send_file`	`conversation_id`, `file_path`, `content_type?`	Upload een lokaal bestand (max 100MB, automatische MIME-detectie)

Configuratie

1. Configureer `.mcp.json`

Voeg de Hashee-server toe aan de MCP-configuratie van je project:

{
  "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. Omgevingsvariabelen

Variabele	Vereist	Standaard	Beschrijving
`HASHEE_AGENT_ID`	Ja	—	Agent UUID
`HASHEE_AGENT_TOKEN`	Ja	—	Agent-authenticatietoken
`HASHEE_ALLOWED_USERS`	Ja	—	Door komma’s gescheiden lijst van toegestane gebruikers-ID’s
`HASHEE_SERVER_URL`	Nee	`https://api.hashee.ai`	API-basis-URL
`HASHEE_CONNECTION_MODE`	Nee	`websocket`	`websocket` of `longpoll`

3. Start Claude Code

Claude Code detecteert automatisch de MCP-server en maakt de Hashee-tools beschikbaar.

Channel Push

Inkomende Hashee-berichten worden als kanaalmeldingen naar Claude Code gestuurd. Alleen berichten van gebruikers in de HASHEE_ALLOWED_USERS-lijst worden doorgestuurd.

De plugin sanitiseert inhoud (XML-escaping om kanaalinjectie te voorkomen) en beperkt tot 10.000 tekens.

Permission Relay

De plugin ondersteunt bidirectionele toestemmingsrelay tussen Claude Code en de Hashee-app:

Claude Code vraagt een toestemming aan (bijv. om een commando uit te voeren)
De plugin stuurt een Artifact naar de Hashee-app met goedkeur-/weigerknopen
De gebruiker reageert in de Hashee-app
De beslissing wordt teruggestuurd naar Claude Code

Verzoeken worden na 60 seconden automatisch geweigerd.

Beveiliging

Laag	Mechanisme
Afzender-allowlist	Alleen `HASHEE_ALLOWED_USERS` kunnen naar het kanaal pushen
XML-sanitisatie	Voorkomt kanaalinjectie-aanvallen
Inhoudsbeperking	Limiet van 10.000 tekens
Bestandspadbeperking	`send_file` staat alleen bestanden toe binnen de werkdirectory
Toestemming-timeout	Automatisch weigeren na 60 seconden
Agent-auth	Bearer-token op alle REST-aanroepen

Volgende stappen

Codex Plugin — OpenAI Codex-integratie
OpenClaw Plugin — OpenClaw-integratie
SDK aan de slag — Bouw een zelfstandige agent