Entwickler-Docs
Widget einbinden, Cursor oder Claude verbinden, Script-Optionen nachlesen.
Entwicklerreferenz
Embed-Snippets, Optionen und Hosting-Hinweise. Öffnen Sie einen Abschnitt für Details.
Servieren Sie /ticketing-standalone.js von Ihrem ausgerollten Hub (bündelt public/ticketing-standalone.bundle.js via pnpm build oder pnpm exec tsup).
Basis-Embed
<script src="https://tkt.coteries.com/ticketing-standalone.js?apiKey=YOUR_API_KEY&lang=en" referrerpolicy="origin"></script>Bedingtes Laden
Script nur laden, wenn Ihre Regel passt (Aufräumen beim Unload nicht nötig — das Hub-Script initialisiert einmal).
<script>
(function () {
if (window.location.hostname !== 'staging.example.com') return
var s = document.createElement('script')
s.src = 'https://tkt.coteries.com/ticketing-standalone.js?apiKey=YOUR_API_KEY&lang=en'
s.referrerPolicy = 'origin'
document.head.appendChild(s)
})()
</script>Standard-Embed: Query-Parameter auf /ticketing-standalone.js. Der Hub prüft den Host der einbettenden Seite gegen Ihre erlaubten Domains, liefert das Widget und ruft initTicketing mit assistantUrl, Projektkürzeln und Locale aus lang auf. Optional onlyOpenOn (Glob auf die Seiten-URL, * als Platzhalter) schränkt diese Tastenkürzel ein; window.Tktries.open* bleibt unverändert. Sie können den Dialog auch aus Ihrer UI mit window.Tktries?.openTicket(), window.Tktries?.openChat() und window.Tktries?.openTktries() öffnen (jeweils Promise).
apiKey (Query)
ErforderlichProjekt-API-Schlüssel. Wird auch als X-Api-Key vom Widget gesendet. Erscheint in URLs und Logs — verwenden Sie referrerpolicy="origin" am script-Tag wenn möglich.
lang (Query)
Optionalen, fr oder de (Standard en).
Selbst gehostetes Bundle
ErweitertLaden Sie ticketing-standalone.bundle.js und rufen Sie window.initTicketing mit assistantUrl, apiKey, locale und shortcuts selbst auf.
Shadow DOM
Isolierte Styles, damit das Widget nicht mit Ihrer Seite kollidiert.
Nachrichten und Events
Dialog per postMessage oder benutzerdefinierten DOM-Events öffnen.
Tastenkürzel
Standard Cmd/Ctrl + M; pro Projekt im Dashboard überschreibbar.
Für die Live-Demo oben: NEXT_PUBLIC_APP_URL setzen (oder localhost in dev), NEXT_PUBLIC_TKT_API_KEY aus dem Dashboard, und aktuellen Host (z. B. localhost) für diesen Schlüssel erlauben.
Cursor- & Claude-MCP-Integration
Verbinden Sie Tktries mit Cursor, Claude Code und Claude Desktop über einen gehosteten MCP-Endpunkt. MCP in den Embed-Einstellungen des Projekts aktivieren — ein API-Schlüssel = ein Projekt.
Verfügbare Tools
get_project — Bestätigen, auf welches Projekt Ihr API-Schlüssel beschränkt ist.
list_tickets — Tickets mit optionalen Status- und Workflow-Filtern auflisten.
get_ticket — Vollständige Ticket-Details inkl. Beschreibung, Seiten-URL und Konsolenkontext abrufen.
update_ticket — Titel, Beschreibung, Zuständigen oder Workflow-Status patchen.
complete_ticket — Ticket als erledigt markieren und optional eine Fix-Notiz anhängen.
Cursor-Konfiguration
In ~/.cursor/mcp.json (oder .cursor/mcp.json im Repo) einfügen. YOUR_PROJECT_API_KEY durch den Projekt-API-Schlüssel ersetzen, dann Cursor neu starten. Gleiches gehostetes URL-Modell wie Sentry — kein Extra-Paket.
{
"mcpServers": {
"tktries": {
"url": "https://tkt.coteries.com/api/mcp?api_key=YOUR_PROJECT_API_KEY"
}
}
}Claude Code
In .mcp.json im Projektroot einfügen (oder unter mcpServers in ~/.claude.json für alle Projekte). type http mit der gehosteten URL unten, YOUR_PROJECT_API_KEY ersetzen, dann Claude Code neu starten.
{
"mcpServers": {
"tktries": {
"type": "http",
"url": "https://tkt.coteries.com/api/mcp?api_key=YOUR_PROJECT_API_KEY"
}
}
}Claude Desktop
In ~/Library/Application Support/Claude/claude_desktop_config.json auf macOS einfügen (oder den entsprechenden Pfad unter Windows/Linux). Claude Desktop nutzt lokal stdio — mcp-remote verbindet mit dem gehosteten Tktries-Endpunkt. YOUR_PROJECT_API_KEY ersetzen, dann Claude Desktop vollständig beenden und neu öffnen.
{
"mcpServers": {
"tktries": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://tkt.coteries.com/api/mcp?api_key=YOUR_PROJECT_API_KEY"
]
}
}
}API-Schlüssel nicht committen. Bevorzugen Sie lokale, gitignored Konfigurationsdateien. Schlüssel in den Embed-Einstellungen rotieren, falls offengelegt.