MCP für KI-Agenten

MCP gibt einem externen KI-Agenten Arbeitszugriff auf die Plattform: Analysen lesen, bei Umfragen helfen und Aktionen im Namen des Benutzers ausführen. Die Verbindung erfolgt über einen Streamable HTTP-Endpunkt:

https://<Plattform-Domäne>/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; Sie müssen kein Geheimnis manuell kopieren.

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

Claude

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

claude mcp add --transport http tealband https://<Plattform-Domäne>/mcp

Öffnen Sie Claude Code und führen Sie /mcp aus, und durchlaufen Sie dann OAuth im Browser. Wenn Sie die Anmeldung aus dem Terminal starten müssen, verwenden Sie:

claude mcp login tealband

Codex

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

codex mcp add tealband --url https://<Plattform-Domäne>/mcp

Führen Sie dann die OAuth-Anmeldung durch:

codex mcp login tealband

In Codex CLI können Sie den Verbindungsstatus über /mcp sehen.

OpenCode

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tealband": {
      "type": "remote",
      "url": "https://<Plattform-Domäne>/mcp",
      "enabled": true
    }
  }
}

Bei der ersten Verwendung fordert OpenCode zur Autorisierung auf. Sie können OAuth manuell wie folgt starten:

opencode mcp auth tealband

OpenClaw

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

openclaw mcp add tealband \
  --url https://<Plattform-Domäne>/mcp \
  --transport streamable-http \
  --auth oauth

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

openclaw mcp login tealband
openclaw mcp doctor tealband --probe

Wenn login einen Bestätigungscode zurückgibt, schließen Sie die Anmeldung mit folgendem Befehl ab:

openclaw mcp login tealband --code <code>

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

{
  "mcp": {
    "servers": {
      "tealband": {
        "url": "https://<Plattform-Domäne>/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Hermes

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

mcp_servers:
  tealband:
    url: "https://<Plattform-Domäne>/mcp"
    auth: oauth

Starten Sie Hermes. Bei der ersten Verbindung öffnet es OAuth im Browser und speichert die Tokens für die folgenden Sitzungen. Nach einer Konfigurationsänderung in einer bereits geöffneten Sitzung führen Sie aus:

/reload-mcp

Zugriff

Der Agent erhält nur bestätigte Scopes:

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

Scopes ersetzen nicht die Benutzerrolle. Wenn Ihre Rolle eine Aktion in der Organisation nicht zulässt, kann der Agent diese ebenfalls nicht ausführen.

Datenschutz

MCP gibt Teilnehmerantworten nicht unter Umgehung der Plattformregeln preis. Niemand sieht die Antworten in reiner Form; es werden nur anonymisierte Daten und Aggregate nach außen ausgegeben, sofern eine ausreichende Anzahl von Antworten vorliegt (mindestens 5). Wenn zu wenige Daten vorhanden sind, erhält der Agent ein eingeschränktes Ergebnis.

Für gewöhnliche Skripte und Server-Integrationen verwenden Sie API-Tokens. MCP ist speziell für KI-Agenten gedacht, die Tools, Resources, Prompts, OAuth und separate Scopes benötigen.