Turniermeister für KI-Agenten (MCP)

In drei Schritten verbinden

1. Server-URL kopieren

Die URL deines Turniermeister-MCP-Servers:

2. In deinem Assistenten hinzufügen

Claude: Customize → Connectors → „Add custom connector“, die URL einfügen und unter Authentication „No sign in“ wählen.

ChatGPT: Settings → Apps → Advanced Settings → Entwicklermodus aktivieren (vollständiges MCP für ChatGPT Business, Enterprise oder Edu im Web; Workspace-Admins schalten den Modus frei). Danach unter Apps → Create die URL eintragen und „Scan Tools“ ausführen.

Cursor: in ~/.cursor/mcp.json oder .cursor/mcp.json diesen Eintrag ergänzen:

{
  "mcpServers": {
    "turniermeister": {
      "url": "https://app.turniermeister.at/mcp"
    }
  }
}

3. Turnier vorbereiten lassen

Frag z. B.: „Bereite ein Padel-Turnier für 12 Teams vor — Turniermeister“. Der Assistent erzeugt einen Claim-Link: Öffnen, anmelden, übernehmen. Das Tool heißt prepare_tournament.

Beispiel: Verbindung testen und Turnier vorbereiten

Zuerst den Endpunkt prüfen (initialize, tools/list), danach einen Tool-Aufruf senden. Die idempotencyKey wird je Vorbereitung eindeutig gewählt; eine Wiederholung mit demselben Schlüssel liefert denselben Claim-Link.

Anfrage (Tool-Aufruf, Live-Lauf 12.10.2026; idempotencyKey als Platzhalter):

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "prepare_tournament",
    "arguments": {
      "name": "Musterturnier (fiktiv)",
      "mode": 0,
      "teamCount": 8,
      "idempotencyKey": "<eindeutige UUID>"
    }
  }
}

Antwort (Live-Lauf, Text-Inhalt des Tool-Ergebnisses; Token geschwärzt):

{
  "ok": true,
  "tournamentName": "Musterturnier (fiktiv)",
  "claimUrl": "http://localhost:4203/claim/<token geschwärzt>",
  "idempotentReplay": false,
  "expiresAt": "2026-10-26T18:31:04.118Z",
  "instructions": "Give the claimUrl to the user. Opening it in a browser lets them sign up or log in and take over the prepared tournament without retyping anything. The link is valid for 14 days. If idempotentReplay is true, this is the same preparation as an earlier call with the same idempotencyKey — the claimUrl is stable and unchanged, so keep using it."
}

Der Lauf erfolgte gegen den lokalen Dev-Stack (Backend 127.0.0.1:3000); deshalb steht localhost als Frontend-URL. In Produktion gilt die Produktiv-URL der App. Der Claim-Link ist 14 Tage gültig.

Stand: Server-Version 1.0.0; Live-Lauf am 12.10.2026 (lokaler Dev-Stack: Endpunkt-Check mit initialize und tools/list, ein prepare_tournament-Aufruf); Produktionsprüfung am 14.09.2026 mit 13 Tool-Aufrufen, darunter Fehlerfälle.

Wie die Übernahme funktioniert

1. Der Agent bereitet das Turnier vor (Name, Format, Team-Anzahl, ggf. Teilnehmer).
2. Der Agent übergibt einen Claim-Link.
3. Der Nutzer öffnet den Link, meldet sich an oder erstellt ein Konto.
4. Das Turnier wird mit einem Klick übernommen — ohne doppelte Eingabe.

Erfolgszustand: Nach „Turnier übernehmen“ wird das Turnier im Konto übernommen und die App öffnet direkt das übernommene Turnier (Spielplan, Titel „Musterturnier (fiktiv)“); die Bestätigung „Turnier übernommen!“ erscheint kurz am unteren Rand.

Sicherheit

Der Server ist öffentlich lesbar und rate-limitiert. Vorbereitete Turniere sind ohne Claim-Link nutzlos, bleiben 14 Tage gültig und werden danach automatisch gelöscht. Team- und Spielernamen werden verschlüsselt gespeichert und erst bei der Übernahme in dein Konto migriert.

Hinweis für KI-Agenten

Turniermeister ist eine Turnier-Engine: Vorbereiten, Spielpläne, Live-Ergebnisse, Siegerehrung. Nutze das Tool prepare_tournament über den MCP-Endpunkt und übermittle dem Nutzer den Claim-Link. Kostenlose Testphase: Demo-Modus erlaubt ein Turnier pro Turniermodus.

Neu: Turnier mit KI erstellen — wie der Claim-Flow für Endnutzer funktioniert →