---
title: 'MCP für KI-Agenten'
description: 'So verbinden Sie Claude, Codex, OpenCode, OpenClaw oder Hermes über MCP mit der Plattform.'
type: doc
locale: de
canonical: 'https://yoseno.com/de/docs/integrations/mcp-agent'
updated: '2026-07-30'
---

# MCP für KI-Agenten

So verbinden Sie Claude, Codex, OpenCode, OpenClaw oder Hermes über MCP mit der Plattform.

MCP bietet einem externen KI-Agenten Zugriff auf die Plattform: er kann Analytik lesen, bei Umfragen helfen und Aktionen im Namen des Nutzers ausführen. Die Verbindung erfolgt über den Streamable-HTTP-Endpunkt:

```txt
https://<plattform-domain>/mcp
```

Beim ersten Zugriff öffnet der Agent die OAuth-Anmeldung im Browser. Sie sehen, welcher Client Zugriff anfordert und welche Scopes er verlangt. Nach der Bestätigung speichert der MCP-Client das Token selbst; Sie müssen das Secret nicht manuell kopieren.

Ein Endpunkt funktioniert für alle Ihre Organisationen. Die aktive Organisation wird aus der autorisierten Sitzung übernommen; wenn der Agent den Organisationswechsel unterstützt, kann er eine andere verfügbare Organisation auswählen.

## Claude

Für Claude Code fügen Sie einen HTTP-MCP-Server hinzu:

```bash
claude mcp add --transport http platform https://<plattform-domain>/mcp
```

Öffnen Sie Claude Code, führen Sie `/mcp` aus und schließen Sie anschließend die OAuth-Anmeldung im Browser ab. Falls Sie die Anmeldung im Terminal starten möchten, verwenden Sie:

```bash
claude mcp login platform
```

## Codex

Fügen Sie einen Streamable-HTTP-Server hinzu:

```bash
codex mcp add platform --url https://<plattform-domain>/mcp
```

Führen Sie anschließend die OAuth-Anmeldung aus:

```bash
codex mcp login platform
```

Im Codex CLI sehen Sie den Verbindungsstatus über `/mcp`.

## OpenCode

Fügen Sie den Server in `opencode.json` ein:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "platform": {
      "type": "remote",
      "url": "https://<plattform-domain>/mcp",
      "enabled": true
    }
  }
}
```

Bei der ersten Verwendung fordert OpenCode Sie zur Autorisierung auf. OAuth lässt sich manuell so starten:

```bash
opencode mcp auth platform
```

## OpenClaw

Speichern Sie den MCP-Server als Streamable HTTP und aktivieren Sie OAuth:

```bash
openclaw mcp add platform \
  --url https://<plattform-domain>/mcp \
  --transport streamable-http \
  --auth oauth
```

Starten Sie die Anmeldung und prüfen Sie die Verbindung:

```bash
openclaw mcp login platform
openclaw mcp doctor platform --probe
```

Falls `login` einen Bestätigungscode zurückgegeben hat, schließen Sie die Anmeldung mit folgendem Befehl ab:

```bash
openclaw mcp login platform --code <code>
```

Wenn Sie die Konfiguration manuell bearbeiten, sieht sie wie folgt aus:

```json
{
  "mcp": {
    "servers": {
      "platform": {
        "url": "https://<plattform-domain>/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}
```

## Hermes

Fügen Sie den Server in `~/.hermes/config.yaml` ein:

```yaml
mcp_servers:
  platform:
    url: "https://<plattform-domain>/mcp"
    auth: oauth
```

Starten Sie Hermes. Bei der ersten Verbindung öffnet er die OAuth-Anmeldung im Browser und speichert die Tokens für spätere Sitzungen. Nach einer Änderung der Konfiguration in einer bereits geöffneten Sitzung führen Sie folgenden Befehl aus:

```txt
/reload-mcp
```

## Zugriff

Der Agent erhält nur bestätigte Scopes:

– `analytics:read` – Umfragen, Ergebnisse, Analytik und Entwicklungspunkte lesen;
– `surveys:write` – Umfragen erstellen, bearbeiten und veröffentlichen;
– `org:manage` – Organisationen, Einstellungen und Teilnehmende verwalten.

Scopes ersetzen die Nutzerrolle nicht. Wenn Ihre Rolle die Ausführung einer Aktion in der Organisation nicht zulässt, kann der Agent sie ebenfalls nicht ausführen.

## Anfragelimits

Zugriffe auf MCP sind durch Ratenlimits geschützt:
– Der Produktionsendpunkt `/mcp`: 300 Anfragen pro Minute und Token bzw. IP.
– OAuth-Autorisierung: 20 Anfragen pro IP- und client_id-Paar in 5 Minuten (120 Anfragen pro IP).

Bei Überschreitung gibt der Server den Fehler `rate_limited` mit Angabe der Wartezeit (`retryAfter`) zurück.

## Datenschutz

MCP gibt Antworten von Teilnehmenden nicht unter Umgehung der Plattformregeln preis. Antworten in Rohform sieht niemand; nach außen gelangen nur anonymisierte Daten und Aggregate, wenn ausreichend viele Antworten vorliegen (mindestens 5). Liegen zu wenige Daten vor, erhält der Agent ein eingeschränktes Ergebnis.

Für normale Skripte und Serverintegrationen verwenden Sie [API-Tokens](https://yoseno.com/de/docs/integrations/api-tokens.md). MCP ist genau für KI-Agenten gedacht, für die Tools, Resources, Prompts, OAuth und einzelne Scopes wichtig sind.

## Verwandte Seiten

- [API-Token](https://yoseno.com/de/docs/integrations/api-tokens.md) — Persönliche Token und Bearer-Zugriff auf \`/api/v1\`.
- [Credits und Limits](https://yoseno.com/de/docs/account/billing-plans.md) — Credits, Käufe, Abonnement und das Verhalten der KI-Funktionen bei fehlendem Guthaben.
- [REST API](https://yoseno.com/de/docs/integrations/rest-api.md) — Tokens, Bearer-Zugriff, eine Beispielanfrage und Links zur OpenAPI-Referenz.

## Weiterlesen

- [REST API](https://yoseno.com/de/docs/integrations/rest-api.md) — Tokens, Bearer-Zugriff, eine Beispielanfrage und Links zur OpenAPI-Referenz.