MCP für KI-Agenten

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:

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:

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:

claude mcp login platform

Codex

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

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

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

codex mcp login platform

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

OpenCode

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

{
  "$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:

opencode mcp auth platform

OpenClaw

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

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

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

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:

openclaw mcp login platform --code <code>

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

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

Hermes

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

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:

/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. MCP ist genau für KI-Agenten gedacht, für die Tools, Resources, Prompts, OAuth und einzelne Scopes wichtig sind.