cluuub Platform API Referenz
Erkunde alle Schnittstellen: Von der mandantenfähigen Vereins-REST-API über öffentliche Sportstätten-Buchungen bis hin zu Model Context Protocol (MCP) Tools für Claude Desktop und ChatGPT.
Einheitliche, maschinenlesbare Fehlerformate mit Typ und Erklärungslink.
60 Requests Burst + 1 Req/s Refill. Status per Response-Header einsehbar.
Sensible Abmelde- und Gesundheitsdaten laufen über rollengeschützte MCP-Tokens.
Gruppen auflisten
Liefert aktive Trainingsgruppen mit Alter, Leistungsstufe und Sportart.
Query Parameter
| Parameter | Typ | Status | Beschreibung |
|---|---|---|---|
| limit | integer | Optional | Anzahl Einträge (Standard 20, max. 100) |
| offset | integer | Optional | Offset für Pagination |
| sport | string | Optional | Filter nach Sportart (z. B. 'Gerätturnen') |
Codebeispiel
const response = await fetch("https://turnen.sv-halle.de/api/v1/groups?limit=10", {
headers: {
Authorization: "Bearer " + process.env.CLUB_API_KEY,
Accept: "application/json",
},
});
const { data, meta } = await response.json();
console.info("Gruppen:", data);{
"data": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Nachwuchs LK3",
"sport": "Gerätturnen",
"age_min": 7,
"age_max": 11,
"level": "Leistungsklasse 3",
"description": "Wettkampfgruppe weiblich"
}
],
"meta": {
"limit": 20,
"offset": 0,
"total": 1
}
}KI-Assistent sicher verbinden
Dieser Explorer stellt keine Sandbox und erzeugt keine Tokens. Erstelle einen persönlichen Zugang in der Tokenverwaltung und wähle nur die nötigen Rechte. MCP-Schreibaktionen wirken direkt auf Vereinsdaten; eine zweite Bestätigung durch den Server gibt es derzeit nicht.
Claude Desktop MCP Konfiguration
Füge den SSE-Endpunkt in deine claude_desktop_config.json ein:
{
"mcpServers": {
"sv-halle-eltern": {
"url": "https://turnen.sv-halle.de/api/mcp/sse",
"headers": {
"Authorization": "Bearer YOUR_PARENT_ACCESS_TOKEN"
}
}
}
}💡 Claude kann anschließend direkt Befehle wie „Zeige mir den Trainingsplan meiner Kinder“ ausführen.
ChatGPT Custom GPT / Action
Erstelle ein Custom GPT mit Actions unter Angabe der OpenAPI 3.1 URL: