MCP | Usetix

Usetix enthält jetzt einen gehosteten Model Context Protocol (MCP)-Server. Damit können externe KI-Clients mit Deinem Usetix-Konto arbeiten und dabei dieselben Veranstalter-Tools nutzen wie der eingebaute Assistent.

Nutze MCP, wenn ChatGPT, Claude oder ein anderer MCP-kompatibler Client Eventdaten nachschlagen, Events erstellen und aktualisieren, veröffentlichen oder zurückziehen, in öffentlichen Shop-Übersichten ein- oder ausblenden, Checkout-Gebühren auf Account- und Eventebene verwalten, die öffentliche Anzeige der Endzeit steuern, bezahlte Preise auf Ticket-PDFs ein- oder ausblenden, beim Ticket-Setup helfen, kostenlose Gästelisten führen, datenschutzbewussten Shop-Traffic und Conversion analysieren, Umsätze zusammenfassen oder typische Admin-Änderungen außerhalb des Usetix-Dashboards ausführen soll.

Einrichtung

MCP-Verbindungen verwaltest Du im Usetix-Dashboard unter Einstellungen → KI-Konnektoren.

Öffne Einstellungen → KI-Konnektoren.
Kopiere die MCP-Server-URL. Für Produktivkonten ist der gehostete Endpunkt:
```
https://app.usetix.io/mcp
```
Lege in ChatGPT, Claude oder einem anderen MCP-Client einen eigenen MCP-Connector an.
Füge die MCP-Server-URL ein.
Melde Dich bei Usetix an, wähle den Account aus und gib den Zugriff frei.

Aktive Verbindungen erscheinen unter Einstellungen → KI-Konnektoren und können dort jederzeit widerrufen werden.

Authentifizierung

MCP-Verbindungen laufen über OAuth. Externe Clients brauchen keinen manuell angelegten API-Token.

URL	Zweck
`https://app.usetix.io/mcp`	JSON-RPC-Endpunkt des MCP-Servers.
`https://app.usetix.io/.well-known/oauth-protected-resource`	Protected-Resource-Metadaten für MCP-Clients.
`https://app.usetix.io/.well-known/oauth-authorization-server`	OAuth-Authorization-Server-Metadaten.

Der OAuth-Flow nutzt Authorization-Code-Grants mit PKCE. Der Zugriff ist accountgebunden: Eine Verbindung, die Du für einen Usetix-Account freigibst, sieht nur diesen Account.

Berechtigungen

Usetix stellt zwei MCP-Scopes bereit:

Scope	Zugriff
`usetix:read`	Accountdaten lesen, Events listen, datenschutzbewusste Analytics prüfen, Bestellungen und Kunden nachschlagen, Umsätze zusammenfassen und den Einrichtungsstatus prüfen.
`usetix:write`	Änderungen über Veranstalter-Tools ausführen, zum Beispiel Events erstellen, aktualisieren, veröffentlichen, ein- oder ausblenden sowie Tickets, Gästelisten, Venues, Künstler, Rabattcodes, Shop-FAQs, Rechtstexte und Account-Einstellungen verwalten.

Reine Leseaktionen funktionieren mit usetix:read. Aktionen, die Daten ändern, benötigen usetix:write.

Verfügbare Tools

Der MCP-Server stellt dieselben aufgabenorientierten Tools bereit wie der Usetix-Assistent, unter anderem für:

Events erstellen, aktualisieren, duplizieren, veröffentlichen oder zurückziehen, in öffentlichen Shop-Übersichten ein- oder ausblenden sowie ihre Checkout-Gebühren und die öffentliche Endzeit verwalten
Tickettypen, benutzerdefinierte Checkout-Fragen, Event-FAQs und private Event-Downloads verwalten
Kostenlose Gästelisten verwalten (GA, Stehplätze und nummerierte Sitze)
Venues, Künstler, Lineups, Rabattcodes und Shop-FAQs verwalten
Account-Einstellungen und Rechtstexte aktualisieren, einschließlich der Preisanzeige auf Ticket-PDFs
Einrichtungsstatus prüfen
Bestellungen, Gästegruppen und Kunden nachschlagen
Datenschutzbewusste historische und Live-View-Analytics, Verkaufszusammenfassungen und Umsatzberichte erstellen
Erstattungen vorbereiten

Checkout-Gebühren

Der eingebaute Assistent und MCP-Clients nutzen dieselben Tools für Account- und Eventgebühren:

account_settings liest mit der Aktion show die Account-Standards. update akzeptiert platform_fee_payer (organizer oder buyer), custom_fee_fixed_amount und custom_fee_percentage. Fixbetrag und Prozentsatz lassen sich kombinieren.
create_event akzeptiert diese Felder zusammen mit checkout_fee_policy. Lässt Du sie weg, übernimmt das Event die Account-Standards. Eine Gebühr ohne explizite Policy setzt automatisch custom.
update_event setzt mit checkout_fee_policy: custom eine Event-Ausnahme oder stellt mit account_default die Vererbung wieder her.
list_events liefert mit include_checkout_fees: true die tatsächlich geltenden Gebühren jedes Events, egal ob geerbt oder individuell.

Änderungen gelten nur für künftige Bestellungen. Bestehende Bestellungen behalten ihre gespeicherten Gebühren- und Steuerbeträge. Die passenden JSON-Endpunkte und Antwortformate findest Du in der Checkout-Gebühren-API.

Preis auf Ticket-PDFs

Der eingebaute KI-Assistent und MCP-Clients nutzen dasselbe Tool account_settings. Der Boolean show_price_on_ticket steuert accountweit, ob erzeugte Ticket-PDFs den bezahlten Preis enthalten.

Um den Preis auszublenden, rufe Folgendes auf:

{"action":"update","show_price_on_ticket":false}

Mit true blendest Du ihn wieder ein. Im eingebauten Assistenten kannst Du zum Beispiel sagen: „Blende den Preis auf Ticket-PDFs aus” oder „Zeige die Ticketpreise wieder an.” Die Einstellung ändert weder Checkout-Preise noch Bestellsummen oder Rechnungen.

Einlasszeit

Die Tools zum Erstellen und Aktualisieren von Events akzeptieren optional doors_open_at im ISO-8601-Format. Nutze den Wert für die Uhrzeit, ab der Gäste eingelassen werden. starts_at bleibt davon getrennt und bezeichnet den Beginn des Events. Die Einlasszeit muss vor oder genau auf der Startzeit liegen.

Lass doors_open_at beim Erstellen weg, wenn keine separate Einlasszeit angegeben wurde. Um eine vorhandene Einlasszeit mit dem Tool zur Event-Aktualisierung zu entfernen, übergib einen leeren String. Eventlisten zeigen die Einlasszeit an, sobald sie gesetzt ist.

Gästeliste

Der eingebaute Assistent und MCP teilen sich manage_guest_list. Gästelisten-Admissions sind kostenlos, verbrauchen echtes Inventar und umgehen den Checkout. Sie sind keine Kunden und lassen sich nicht mit prepare_refund erstatten.

Aktion	Verwendung
`list`	Gruppen eines Events. Optional `query` und `filter` (`all`, `expected`, `arrived`).
`tickets`	Zulässige Standard-Tickets und ob sie `ga`, `standing` oder `places` sind.
`places`	Freie nummerierte Sitze. Liefert stabile `place_keys`.
`add`	Gruppe anlegen. GA nutzt `party_size`. Stehplatz nimmt den einzigen Bereich, wenn es nur einen gibt. Nummerierte Sitze brauchen `place_keys` aus `places`. Niemals automatisch vergeben.
`update`	Name, Zustell-E-Mail, Staff-Hinweis, Begleitungen. `deliver: true` schickt Tickets.
`cancel`	Gruppe entfernen, wenn noch niemand eingecheckt hat.
`cancel_admission`	Eine nicht eingecheckte Begleitung freigeben.
`move_seat`	Eine nummerierte Admission umsetzen. Ziel kommt aus `places`.

Gruppentickets, ganze Tische und nummerierte Walk-ins sind nicht vorgesehen. Verbundene Rollstuhl- und Begleitplätze lassen sich nicht einzeln verschieben. Vor cancel und cancel_admission nachfragen.

Produkt: Gästeliste. JSON-Vertrag: Guest list API EN.

Dateianhänge aus externen KI-Clients sind über MCP noch nicht verfügbar. Private Event-Downloads können aktuell gelistet oder entfernt werden.

Sicherheit

Verbindungen kannst Du unter Einstellungen → KI-Konnektoren widerrufen. Danach muss sich der externe KI-Client erneut anmelden, bevor er Usetix-Tools nutzen kann.

Der MCP-Server gibt Clients außerdem Account-Hinweise mit, damit sie vor destruktiven oder weitreichenden Aktionen nachfragen, zum Beispiel vor Veröffentlichen, Zurückziehen, Archivieren, Löschen, Erstattungsvorbereitungen, dem Entfernen von Gästelisten-Gruppen oder -Admissions oder größeren Änderungen an Account-Einstellungen.

Brauchst Du Hilfe beim Verbinden eines Clients? Schreib uns.