> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Magicline

> Fitnessstudio mit Assistenten und Automationen verbinden

Öffnen Sie **Agent Tools → Marktplatz → Magicline**. Geben Sie Studio-ID und API-Schlüssel ein. Vor dem Speichern wird der Studiozugriff geprüft. Weisen Sie die Verbindung einem Assistenten zu.

Wählen Sie unter **Installiert → Bearbeiten → Tools** einzelne Aktionen an oder ab. Anfangs sind sechs geprüfte Lese-Tools für Studio- und Kursdaten aktiv. Der Katalog umfasst 169 dokumentierte Operationen. Die Auswahl erteilt keine zusätzlichen Zugriffsrechte. Weitere Lesezugriffe benötigen eine Freigabe des Anbieters. Schreibaktionen lassen sich konfigurieren, aber über den aktuellen Lese-Proxy nicht ausführen.

Verbinden Sie Magicline unter **Automationen → Verbindungen** oder wählen Sie **Aus Agent Tools importieren**. Die Tool-Auswahl bleibt beim Import erhalten. Fügen Sie eine **Magicline**-Aktion hinzu und befüllen Sie ihre Felder mit Ergebnissen vorheriger Schritte. Die Antwort steht als Aktionsergebnis bereit.

Starten Sie den Ablauf per Zeitplan, manuell, Gesprächsereignis oder eingehendem Webhook. Diese Verbindung abonniert keine Magicline-Ereignisse. Verwenden Sie Aktionsergebnisse in nachfolgenden Schritten mit anderen verbundenen Apps.

Kursseiten enthalten bis zu zehn Einträge und einen Fortsetzungscursor. Prüfen Sie weitere Seiten. Ein buchbarer Kurs kann voll sein oder eine Warteliste haben; Berechtigung und bestätigte Buchung sind getrennt zu prüfen. Studioöffnungszeiten können von der öffentlichen Website abweichen. Klären Sie widersprüchliche Quellen vor verbindlichen Zusagen.

## Verfügbarkeit von Buchungen

Die aktuelle Verbindung unterstützt das Lesen von Studio- und Kursinformationen, kann aber keine Buchungen erstellen. Dafür sind sowohl Schreibzugriff als auch die Unterstützung der gewünschten Buchungsaktion erforderlich.

Bestätigen Sie eine Buchung erst, wenn die Aktion eine erfolgreiche Reservierung zurückgibt. Ist das Ergebnis unklar, prüfen Sie vor einem erneuten Versuch den Status, um doppelte Buchungen zu vermeiden.

## API, MCP, CLI & SDK

`POST /api/v1/tools/magicline` · MCP `connect_magicline` · CLI `famulor connect-magicline`.

`POST /api/v1/automations/connections/import` · MCP `import_automation_connection` · CLI `famulor import-automation-connection`.

```bash theme={null}
famulor connect-magicline --studio-id "$STUDIO_ID" --api-key "$MAGICLINE_KEY" --name magicline_studio
famulor import-automation-connection --user-tool-id "$TOOL_ID"
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectMagicline({ body: {
  studio_id: process.env.MAGICLINE_STUDIO_ID!,
  api_key: process.env.MAGICLINE_KEY!,
  name: 'magicline_studio',
} });
const { data: connection } = await client.api.importAutomationConnection({
  body: { user_tool_id: tool.id },
});
console.log({ toolId: tool.id, connectionId: connection.id });
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.