# MCP-Konnektor einrichten

SweetHive stellt seine Agent Client API als **MCP-Server** bereit. Jeder MCP-fähige
Agent — Claude Desktop, Claude Code, Cowork, Agenten der OpenClaw-Klasse und andere —
verbindet sich mit einem **bereichsgebundenen Zugriffstoken**, das Sie in SweetHive
ausstellen. Ein Server, ein Token-Modell, jeder Client.

[Erstellen Sie zuerst ein Token](/de/connect-an-agent/) unter
**Meine Agenten → Agent verbinden** und laden Sie das Konfigurationspaket herunter
(es enthält Ihren `endpoint` und Ihr `token`).

## Was Ihr Agent erhält

| Tool | Funktion |
|---|---|
| `whoami` | der effektive Geltungsbereich, die Berechtigungsstufe und der Eigentümer des Tokens |
| `contexts` | der freigegebene Hive-/Kontextbaum |
| `items` | aktuelle Inhalte aus einem Kontext und seinem Teilbaum |
| `search` | Nachrichten, Notizen und Dateien in den freigegebenen Kontexten durchsuchen |
| `post_message` | in einen Kontext posten (nur *Lesen + Posten*-Tokens; der erste Beitrag fragt nach Ihrer Bestätigung) |
| `chat_pull` / `chat_reply` | der [Chat in SweetHive](/de/chat-with-your-agent/) mit Ihnen |

## Ihren Client konfigurieren

**Lokaler Konnektor (stdio)** — funktioniert heute mit Claude Desktop, Claude Code
und jedem stdio-MCP-Client. Installieren Sie den paketierten SweetHive-Konnektor und
fügen Sie dann hinzu:

```json
{
  "mcpServers": {
    "sweethive": {
      "command": "node",
      "args": ["/absolute/path/to/sweethive-connector/dist/index.js"],
      "env": {
        "SWEETHIVE_ENDPOINT": "https://sweethive.com/server/web",
        "SWEETHIVE_TOKEN": "shv_..."
      }
    }
  }
}
```

**Remote (streamable HTTP)** — wo der gehostete MCP-Endpunkt aktiviert ist, richten
Sie Ihren Client mit dem Token als Bearer-Anmeldedaten darauf:

```json
{
  "mcpServers": {
    "sweethive": {
      "url": "https://sweethive.com/mcp",
      "headers": { "Authorization": "Bearer shv_..." }
    }
  }
}
```

Ihr Agent kann jetzt Fragen beantworten wie *„Was hat sich diese Woche in Projekt A
geändert?“* oder *„Entwirf ein Status-Update für die DevGroup.“*

## Hinweise

- Die **Berechtigungsstufe** (Lesen / Lesen + Entwerfen / Lesen + Posten) ist auf
  dem Token festgelegt; Nur-Lesen ist der Standard.
- **Widerruf und Gruppenänderungen wirken sofort** — es gibt keinen
  zwischengespeicherten Geltungsbereich. Eine geleakte Konfiguration legt einen
  begrenzten, jederzeit widerrufbaren Geltungsbereich offen, niemals Ihre
  Konto-Anmeldedaten.
- Inhalte, die von einem externen Agenten hereinkommen, werden als nicht
  vertrauenswürdig behandelt: Sie können keine privilegierten Erwähnungen tragen,
  keine internen SweetHive-Agenten aufrufen und sind pro Token ratenbegrenzt.