Einen AI-Assistenten mit einem API-Schlüssel verbinden

Nicht jeder AI-Assistent kann sich für Sie bei FitnessSyncer MCP Server anmelden. Viele bieten lediglich eine Serveradresse und ein Feld zur Eingabe eines Tokens an, und einige lesen ihre gesamte Konfiguration aus einer Datei auf der Festplatte aus. Für diese stellt FitnessSyncer einen API-Schlüssel aus, bei dem es sich um ein einziges, langfristig gültiges Token handelt, das die gesamte Anmeldung ersetzt.

So stellt Mistral Vibe eine Verbindung her, und dies ist auch die Lösung für einen selbst gehosteten Assistenten, einen Befehlszeilen-Client, ein Agent-Framework oder ein ChatGPT, das Ihnen anstelle eines OAuth-Bildschirms eine Kopfzeile anzeigt. Claude, ChatGPT, Perplexity und Home Assistant verfügen jeweils über einen eigenen Anmeldevorgang; befolgen Sie daher bitte die jeweiligen Anweisungen, sofern diese zutreffen.

Bevor Sie beginnen

• Ein FitnessSyncer-Konto, bei dem Ihre Quellen verknüpft sind. Das MCP Server ist in jedem Konto enthalten, sodass Sie nichts zusätzlich erwerben müssen; lesen Sie bitte den Abschnitt „Erste Schritte“, falls Sie neu hier sind. Ein kostenloses Konto bietet hier einen kürzeren Rückblick auf den Verlauf, genau wie überall sonst auf der Website.
• Ein Assistent, der einen „Authorization“-Header senden kann oder der dies als „Bearer-Token“ oder „API-Token“ bezeichnet. Sollte Ihr Assistent stattdessen die Anmeldung mit OAuth ermöglichen, ist dies die bessere Vorgehensweise, da Sie die Berechtigungen jedes Mal selbst auswählen können, anstatt dies nur einmal zu tun.

Schritt 1: Erstellen Sie Ihren API-Schlüssel auf FitnessSyncer

1. Rufen Sie die Seite „Entwicklerkonten“ auf.
2. Wählen Sie unten auf der Seite „MCP: API-Schlüssel“ aus der Liste aus und klicken Sie auf „Erstellen“.
3. FitnessSyncer fragt ab, welche Berechtigungen dieser Schlüssel enthalten soll. Wählen Sie nur die Optionen aus, die der Assistent ausführen soll; zum Beantworten von Fragen reichen die Leseberechtigungen aus, und alles, was Sie nicht ankreuzen, kann später nicht verwendet werden, ohne dass ein neuer Schlüssel erstellt wird.
4. Wählen Sie „API-Schlüssel erstellen“ aus und notieren Sie sich den API-Schlüssel auf der nächsten Seite. Er wird nur dieses eine Mal angezeigt; sollten Sie ihn verlieren, können Sie ihn zwar neu generieren, müssen ihn dann aber erneut in Ihrem Assistenten eingeben.

  Step 2: Mistral Vibe

Sobald Sie Ihren API-Schlüssel zur Hand haben:

1. Wählen Sie im Menü auf der linken Seite „Kontext“ und anschließend „Konnektoren“ aus.
2. Wählen Sie oben rechts auf dem Bildschirm die Option „Konnektor hinzufügen“ aus.
3. Wählen Sie den benutzerdefinierten MCP-Stecker aus.
4. Geben Sie als Namen „FitnessSyncer“ ein
5. Geben Sie „https://www.fitnesssyncer.com/services/mcp“ als Server ein
6. Wählen Sie „API-Token-Authentifizierung“ aus und fügen Sie Ihren API-Schlüssel in das Feld „Bearer-Token“ ein.

Schritt 2: Jeder andere Assistent mit einem Einstellungsbildschirm

Die Felder haben je nach Assistent unterschiedliche Bezeichnungen, es gibt jedoch stets nur drei:

1. Geben Sie als Namen „FitnessSyncer“ ein
2. Geben Sie „https://www.fitnesssyncer.com/services/mcp“ als Server ein, den manche Assistenten als URL des Remote-MCP-Servers bezeichnen.
3. Geben Sie Ihren API-Schlüssel in das Feld „Bearer-Token“ ein. Falls der Assistent stattdessen nach einem Header fragt, lautet der Name des Headers „Authorization“ und sein Wert besteht aus dem Wort „Bearer“, einem Leerzeichen und Ihrem API-Schlüssel.

Sollte der Assistent Sie zudem auffordern, einen Transport auszuwählen, wählen Sie bitte „Streamable HTTP“ aus. FitnessSyncer bietet den älteren SSE-Transport nicht an.

Schritt 2: Ein aus einer Datei konfigurierter Assistent

Viele Befehlszeilen- und Desktop-Clients lesen die Daten ihrer Server aus einer JSON-Datei aus. Das Format variiert; orientieren Sie sich daher bitte an der Dokumentation Ihres jeweiligen Assistenten, doch in der Regel sieht es wie folgt aus:

{
 "mcpServers": {
   "FitnessSyncer": {
     "transport": "http",
     "url": "https://www.fitnesssyncer.com/services/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_TOKEN_HERE"
     }
   }
 }
}

Ersetzen Sie „YOUR_TOKEN_HERE“ durch Ihren API-Schlüssel, wobei Sie das Wort „Bearer“ und das Leerzeichen davor beibehalten müssen.

Probieren Sie es aus

Eröffnen Sie einen neuen Chat und fügen Sie einen der folgenden Texte ein, um zu überprüfen, ob alles funktioniert:

• Listen Sie alle Apps und Geräte auf, mit denen FitnessSyncer derzeit für mein Konto verbunden ist, und zeigen Sie an, wann die letzte Synchronisierung stattgefunden hat.
• Wie habe ich diese Woche im Vergleich zur letzten Woche geschlafen?
• Wie hat sich meine Ruheherzfrequenz im letzten Monat entwickelt?

Auf der Seite MCP Server finden Sie noch viele weitere Ideen.