Deinen Agent über MCP verbinden

Wählen Sie Ihre Verbindungsmethode

FreeLipSync macht einen Remote-Endpunkt MCP unter https://freelipsync.com/mcp verfügbar. Es bietet einem Agenten die gleichen Videogenerierungsfunktionen und Kontoguthaben wie der REST API. Sie müssen über ein registriertes FreeLipSync-Konto verfügen. Anonymer Zugriff wird nicht unterstützt. Verwenden Sie stattdessen Ihren staging-Ursprung, wenn Sie auf staging testen.

Es werden sowohl die API Key-Konfiguration als auch die OAuth-Konfiguration unterstützt. Wählen Sie eine Anmeldeinformationsquelle pro Servereintrag. Eine vorhandene Konfigurationsdatei bleibt eine gültige Verbindungsmöglichkeit; Sie müssen OAuth nicht verwenden.

Erstelle einen Schlüssel und kopiere ihn vollständig aus dem Erstellungsdialog. Für OAuth musst du keinen Schlüssel kopieren. Pro Konto sind bis zu 5 API Keys und 5 unabhängige OAuth-Verbindungen möglich. API-Key-Zugriffe belegen einen Schlüsselplatz, keinen OAuth-Verbindungsplatz. Beide Methoden teilen Guthaben, Modelle und Limits des Kontos.

OAuth Autorisierungsablauf

1. Fügen Sie den Remote-HTTPS URL in Ihrem Client hinzu, ohne einen Authorization-Header oder eine API Key-Einstellung.
2. Wählen Sie entsprechend dem Client Connect / Authenticate / Sign in aus.
3. Melden Sie sich im Browser bei Ihrem FreeLipSync-Konto an und überprüfen Sie den anfordernden Client und die Berechtigungen.
4. Erstellen Sie eine neue Verbindung (Standard) oder wählen Sie explizit eine vorhandene Verbindung zum Ersetzen aus. Eine erfolgreiche Autorisierung auf einem anderen Gerät zählt normalerweise separat.
5. Erlauben Sie dem Agenten, Ihre erworbenen API-Credits auszugeben, und autorisieren Sie ihn dann. Kehren Sie zum Kunden zurück und überprüfen Sie die unten aufgeführten Tools.

Sie können den Antrag ablehnen. Wenn alle 5-Verbindungssteckplätze verwendet werden, ersetzen oder widerrufen Sie explizit eine alte Verbindung in Agent-Konsole; Durch eine neue Autorisierung wird eine Verbindung nicht stillschweigend entfernt. Durch die Token-Aktualisierung und das erneute Verbinden einer vorhandenen Autorisierung wird kein Slot hinzugefügt. Eine OAuth-Verbindung kann das Guthaben Ihres Kontos verbrauchen, wenn die Generierung übermittelt wird.

Client-OAuth-Kompatibilität ist wichtig: FreeLipSync unterstützt veröffentlichte Client-Identitätsmetadaten (CIMD) und vorregistrierte Clients anstelle eines offenen Endpunkts mit dynamischer Registrierung. Verwenden Sie eine kompatible Client-Version oder eine zugewiesene Client-ID, sofern dies unterstützt wird. Wenn ein Client nur die dynamische Registrierung unterstützt und die Anmeldung fehlschlägt, verwenden Sie die Methode API Key oder wenden Sie sich an den Support, um die Client-Registrierung zu überprüfen.

Client-Kompatibilität und OAuth-Unterschiede

OAuth-Registrierung und Token-Authentifizierung sind getrennt. FreeLipSync unterstützt CIMD oder eine vorregistrierte Client-ID mit none + PKCE oder private_key_jwt. Es versteht das neuere CIMD-Array unterstützter Methoden sowie das ältere Einzelmethodenfeld. Signierte Clients verwenden ihre veröffentlichten öffentlichen Schlüssel automatisch; Benutzer laden keinen privaten Schlüssel hoch.

FreeLipSync bietet keine offene dynamische Registrierung (DCR), keine Client-Secret-Authentifizierung oder die client_credentials-Gewährung. Wenn ein Client DCR benötigt, verwenden Sie die vorregistrierte öffentliche Client-Option, sofern verfügbar, oder verwenden Sie die API Key-Konfiguration in einem Client, der benutzerdefinierte Bearer-Header unterstützt. Besorgen Sie sich eine zugewiesene ID und registrieren Sie den tatsächlichen Rückruf, bevor Sie ihn konfigurieren. Eine API Key- und eine OAuth-Client-ID sind unterschiedliche Anmeldeinformationen.

Codex: Konfigurationsdatei oder OAuth

Fügen Sie einen Remote-HTTP-Server unter Plugins → MCPs in Codex hinzu oder bearbeiten Sie ihn. Einige Versionen verwenden Settings → MCP-Server. Dieser lokale MCP-Eintrag unterstützt die API Key-Konfiguration und ist vom oben beschriebenen OAuth-Eintrag für das gehostete Plugin getrennt.

Wählen Sie eine Anmeldeinformationsquelle. In den Beispielen wird https://freelipsync.com/mcp verwendet. Ersetzen Sie staging durch https://staging.freelipsync.com/mcp und erstellen Sie den Schlüssel in Ihrem staging-Konto. Produktionsschlüssel und staging-Schlüssel sind nicht austauschbar.

Option A: Fügen Sie ein API Key in die Desktop-Einstellungen ein

Verwenden Sie diese Option, wenn Sie keine Umgebungsvariablen konfigurieren möchten. Erstellen Sie einen Schlüssel in der Agent-Konsole, kopieren Sie das vollständige Geheimnis und geben Sie dann Folgendes ein:

Verwenden Sie ein Leerzeichen nach Bearer; Der Schlüssel selbst hat kein Bearer-Präfix. Benennen Sie den Header nicht FLS_API_KEY und fügen Sie das Geheimnis nicht in Bearer token env var ein. Speichern und erneut verbinden; Wenn der Client noch eine alte Konfiguration verwendet, starten Sie ihn neu oder öffnen Sie eine neue Sitzung.

Der entsprechende persönliche ~/.codex/config.toml-Eintrag lautet:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
http_headers = { Authorization = "Bearer YOUR_API_KEY" }

Option B: Stellen Sie API Key über eine Umgebungsvariable bereit

Bearer token env var nimmt einen Variablennamen an, kein Geheimnis. Setzen Sie ihn auf FLS_API_KEY. Diese Variable muss in der Umgebung des Prozesses vorhanden sein, der Codex ausführt. Sein Wert ist der vollständige Schlüssel ohne Bearer ; Codex fügt das Präfix hinzu.

Die entsprechende persönliche Konfigurationsdatei lautet:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
bearer_token_env_var = "FLS_API_KEY"

Für Codex CLI, das von einem Terminal aus gestartet wird:

export FLS_API_KEY='YOUR_API_KEY'
codex mcp list
codex
# Inspect /mcp in the new session.

Durch das Exportieren einer Variablen in ein anderes Terminal wird eine bereits laufende Desktop-App nicht aktualisiert. Eine über das Dock oder das Startmenü gestartete App erbt möglicherweise auch keine Terminalvariablen. Wenn Sie nicht sicher sind, wie Sie die Desktop-Prozessumgebung bereitstellen sollen, verwenden Sie Option A.

Headers erstellt HTTP-Anforderungsheader. Headers from environment variables liest Header-Werte aus vorhandenen Umgebungsvariablen. Keines der Felder erstellt eine Systemumgebungsvariable. Ein Header namens FLS_API_KEY füllt die Einstellung Bearer nicht aus und ein grauer Platzhalter wie MCP_BEARER_TOKEN bedeutet nicht, dass die Variable konfiguriert wurde.

Option C: Autorisieren Sie im Browser mit OAuth

Geben Sie nur URL ein. Lassen Sie Bearer token env var, Headers und Headers from environment variables leer, einschließlich des Entfernens aller vorherigen Authorization-Zeilen. Speichern Sie, wählen Sie Authenticate / Sign in, wo angeboten, melden Sie sich bei FreeLipSync an und genehmigen Sie die Verbindung. Es muss kein API Key erstellt oder eingefügt werden.

Behalten Sie für eine Konfigurationsdatei nur Folgendes bei:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"

CLI-Befehle:

# Run the next line only if this server name does not exist; otherwise edit it.
codex mcp add freelipsync --url https://freelipsync.com/mcp
codex mcp login freelipsync
codex mcp list

Ersetzen Sie freelipsync in den Befehlen durch Ihren gespeicherten Servernamen. Die drei oben genannten TOML-Blöcke sind Alternativen; Behalten Sie einen Eintrag für den Server. Entfernen Sie die verschlüsselte Konfiguration, bevor Sie zu OAuth wechseln: Durch die Anmeldung wird ein falscher Authorization-Header, der noch konfiguriert ist, nicht repariert.

Überprüfen Sie nach dem Speichern die Verbindung

Stellen Sie in einer neuen Sitzung Folgendes: „Rufen Sie FreeLipSync get_capabilities und get_usage an, um meine Modelle und Credits zu überprüfen. Generieren Sie kein Video.“ Eine erfolgreiche Kontoantwort bestätigt die Verbindung; Ein Servername, der allein in der Liste erscheint, ist nicht der Fall.

Überprüfen Sie für HTTP 401, dass URL und Schlüssel zur gleichen Umgebung gehören, der Schlüssel vollständig ist, der statische Header Authorization: Bearer YOUR_API_KEY lautet und keine alte Bearer-Variable oder doppelte Authorization-Einstellung übrig bleibt. Überprüfen Sie bei Option B auch die Umgebung des Prozesses, der den Client tatsächlich startet.

Felddefinitionen finden Sie im offiziellen OpenAI MCP-Leitfaden und in der Konfigurationsreferenz.

Claude Code: Konfigurationsdatei oder OAuth

Für den API Key-Zugriff fügen Sie diesen Eintrag in eine persönliche/lokale MCP-Konfiguration ein oder führen Sie ihn in .mcp.json für das Projekt zusammen. Die Umgebungsvariable wird um Claude Code erweitert. Halten Sie den eigentlichen Schlüssel aus der gemeinsamen Konfiguration fern und starten Sie Claude Code mit dem Variablensatz.

{
  "mcpServers": {
    "freelipsync": {
      "type": "http",
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer ${FLS_API_KEY}"}
    }
  }
}

export FLS_API_KEY='YOUR_API_KEY'
claude mcp list

Entfernen Sie für OAuth zuerst den verschlüsselten Eintrag oder seinen Authorization-Header, fügen Sie einen Nur-URL-Server HTTP hinzu und authentifizieren Sie sich über /mcp in einer interaktiven Claude Code-Sitzung:

claude mcp add --transport http --scope user freelipsync https://freelipsync.com/mcp
claude
# In Claude Code, run /mcp and choose Authenticate for freelipsync.

Verwenden Sie jeweils eine Methode. Ein konfigurierter ungültiger Bearer-Header wird nicht durch die Anmeldung über einen anderen Ablauf behoben. Siehe Claude Codes offizielle MCP-Anleitung.

Claude Desktop und Claude web

Öffnen Sie für OAuth Claudes Verwaltungsseite Connectors, fügen Sie einen benutzerdefinierten Web-/Remote-Connector mit dem Namen FreeLipSync hinzu und geben Sie https://freelipsync.com/mcp ein. Wählen Sie „Anmelden“ und verwenden Sie Claudes veröffentlichte Kundenidentität, sofern verfügbar. Vervollständigen Sie die Autorisierungsseite FreeLipSync. Eine Organisation kann von ihrem Besitzer verlangen, dass er den Connector zuerst aktiviert. Remote-Connectoren müssen einen öffentlichen HTTPS-Endpunkt erreichen; localhost ist von Claudes Cloud aus nicht erreichbar. Siehe Claudes Remote-Connector-Anleitung.

Für die ältere Route Claude Desktop-Konfigurationsdatei benötigt ein Nur-stdio-Client eine lokale Brücke zum Remote-Endpunkt; Das Einfügen eines Remote-url in eine stdio-Konfiguration reicht nicht aus. Wenn Node.js/npx installiert ist, führen Sie diesen Eintrag mit claude_desktop_config.json zusammen (öffnen Sie ihn über die Entwicklereinstellungen von Desktop) und starten Sie Desktop neu. Ersetzen Sie den Platzhalter lokal und halten Sie diese persönliche Datei privat.

{
  "mcpServers": {
    "freelipsync": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://freelipsync.com/mcp",
        "--header", "Authorization:${FLS_AUTH_HEADER}"
      ],
      "env": {"FLS_AUTH_HEADER": "Bearer YOUR_API_KEY"}
    }
  }
}

mcp-remote ist eine Kompatibilitätsbrücke eines Drittanbieters, kein FreeLipSync-Paket. Lesen Sie die Betreueranweisungen und Ihre installierte Version. Sein Header-Argument unterstützt die Umgebungserweiterung; Das obige Format vermeidet außerdem Leerzeichen innerhalb des Arguments. Bevorzugen Sie die native HTTP-Unterstützung eines Kunden, sofern verfügbar. Diese Desktop-Datei ist nicht der Konfigurationsmechanismus für Claude web.

Cursor: Konfigurationsdatei oder OAuth

Für den API Key-Zugriff verwenden Sie Ihr persönliches ~/.cursor/mcp.json (oder ein Projekt .cursor/mcp.json, das außerhalb der Quellcodeverwaltung bleibt, wenn es einen Schlüssel enthält). Ersetzen Sie den Platzhalter lokal. Gehen Sie nicht davon aus, dass die Umgebungserweiterung aus dem Format eines anderen Clients in Ihrer installierten Cursor-Version funktioniert.

{
  "mcpServers": {
    "freelipsync": {
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer YOUR_API_KEY"}
    }
  }
}

Verwenden Sie für OAuth denselben Eintrag nur mit url und entfernen Sie das Header-Objekt. Stellen Sie in den MCP-Einstellungen von Cursor eine Verbindung/Authentifizierung her und schließen Sie die Browser-Autorisierung ab, sofern angeboten. Laden Sie den Client neu oder starten Sie ihn neu, nachdem Sie seine Konfiguration geändert haben, und überprüfen Sie dann die Tools im Agent-Modus. Wenn der Registrierungsablauf dieser Version nicht kompatibel ist, verwenden Sie die obige Schlüsselkonfiguration. Siehe Cursors offizielle MCP-Anweisungen.

VS Code und GitHub Copilot

Erstellen Sie für eine native VS Code MCP-Konfiguration .vscode/mcp.json mit einer Passworteingabe anstelle eines echten Schlüssels in der Datei:

{
  "inputs": [
    {"type":"promptString","id":"fls-key","description":"FreeLipSync API Key","password":true}
  ],
  "servers": {
    "freelipsync": {
      "type":"http",
      "url":"https://freelipsync.com/mcp",
      "headers":{"Authorization":"Bearer ${input:fls-key}"}
    }
  }
}

Entfernen Sie für OAuth inputs und headers und behalten Sie dabei den Servertyp und URL bei. Starten/verbinden Sie den Server und befolgen Sie die Authentifizierungsaufforderung. Die Client-Registrierung muss wie oben beschrieben kompatibel sein. Wählen Sie die entsprechenden Tools im Agent-Modus von Copilot aus und probieren Sie die Bestätigungsaufforderung unten aus. Das VS Code-Format verwendet servers, nicht das mcpServers eines anderen Clients. Interaktive Eingänge werden nicht von jedem Copilot-Kabelbaum oder jeder tragbaren Konfiguration unterstützt. Siehe die VS Code MCP-Referenz.

Überprüfen Sie die Tools und versuchen Sie es mit einer Eingabeaufforderung

Fragen Sie zuerst Ihren Agenten: „Verwenden Sie FreeLipSync, um meine verfügbaren Modelle und mein Guthaben zu überprüfen. Erstellen Sie noch kein Video.“ Es sollte get_capabilities und get_usage aufrufen, ohne Credits auszugeben. Ein in einer Konfigurationsdatei aufgeführter Server ist kein ausreichender Beweis dafür, dass die Authentifizierung funktioniert hat.

Versuchen Sie es dann: „Machen Sie aus meinem Bild und Ton ein kurzes sprechendes Image Fast-Foto. Holen Sie sich zuerst ein Angebot ein und teilen Sie mir die Credits mit. Warten Sie auf meine Bestätigung, bevor Sie es absenden. Wenn Sie meine lokalen Dateien nicht hochladen können, geben Sie mir Browser-Upload-Links.“ Lassen Sie die Genehmigung des Kunden für Ausgabentools aktiviert.

Hochladen lokaler Dateien von einem Agenten

Es gibt zwei lokale Dateipfade sowie den HTTPS-Import. Übergeben Sie einen lokalen Pfad nicht als import_asset URL.

• Ein Client mit Dateizugriff und HTTP PUT ruft create_asset_upload mit kind, filename, content_type, size_bytes und idempotency_key auf. Er lädt die Dateibytes mit den angegebenen Headern an die zurückgegebene URL hoch und ruft confirm_asset_upload auf. Sende deinen API Key niemals an signierte Speicher-URLs.
• Ein Client ohne lokalen Datei-/HTTP-Zugriff ruft create_asset_upload_session für jedes Bild/Video/Audio auf. Sie öffnen browser_upload_url, melden sich bei demselben FreeLipSync-Konto an und laden im Browser hoch. Der Agent behält asset_id und fragt get_asset ab; Sie müssen den Ausweis nicht zurückkopieren. Teilen Sie das Upload-Ticket nicht öffentlich.
• Für eine vorhandene öffentliche HTTPS-Datei startet import_asset mit kind, url, idempotency_key den Import. Warten Sie, bis Sie fertig sind, bevor Sie ein Angebot abgeben.

Ein reiner URL-/Cloud-Connector erhält nicht einfach durch die Verwendung von MCP Zugriff auf Ihre Desktop-Dateien. Beispielsweise werden die Remote-Konnektoren von Claude über die Cloud ausgeführt. Verwenden Sie daher Browser-Upload-Links, wenn der Client Ihren Anhang nicht an das signierte URL übertragen kann.

Credits, Wiederholungsversuche und Verbindungsverwaltung

API und MCP haben dieselben Raten: Video Lip Sync / Image Fast 1 Credit/s, Image Max 2, Image Super / Music Video 3. Die geprüfte Audiodauer wird auf volle Sekunden aufgerundet, mindestens 5 Sekunden. estimate_generation liefert total_points und eine Angebots-ID; create_generation erhält diese quote_id und einen idempotency_key. Uploads, Nutzungsabfragen und Angebote verbrauchen keine Credits. Angenommene Generierungen lassen sich nicht abbrechen; nur ein Verarbeitungsfehler gibt den ursprünglichen reservierten Betrag zurück. Siehe API-Abrechnung und Wiederherstellung.

Behalten Sie nach einer unsicheren Einreichung das gleiche Anführungszeichen und den gleichen Idempotenzschlüssel bei. Speichern Sie die zurückgegebene Job-ID und fragen Sie sie ab. Bitten Sie den Agenten nicht, es noch einmal zu versuchen, indem Sie eine andere Aufgabe ausführen. Abfragen Sie mit poll_after_seconds, ziehen Sie Retry-After zurück und verwenden Sie list_generations, um mehrere aktive Jobs gemeinsam abzufragen. API und MCP teilen sich den Account-Lese-Bucket, während sich alle drei Website-/API/MCP-Einstiegspunkte die Übermittlungshäufigkeit und die Videoausführungskapazität teilen. Die Website und API/MCP verfügen über separate Zuteilungen für nicht erledigte Aufgaben: Free 1, Starter 3, Pro 10 in jedem Pool. Alle REST/MCP-Anmeldeinformationen teilen sich den API/MCP-Pool. Beispiele finden Sie unter Warum API/MCP verwenden.

Widerrufen Sie eine Schlüssel- oder OAuth-Verbindung von der Agent-Konsole. Durch das Widerrufen eines Schlüssels wird dessen zukünftige Nutzung in jedem Client, der ihn teilt, einschließlich REST, gestoppt. Das Widerrufen einer OAuth-Verbindung wirkt sich nur auf diese Verbindung aus. Keiner der Vorgänge bricht bereits akzeptierte Aufgaben ab. Durch das alleinige Löschen eines lokalen Client-Eintrags werden keine Anmeldeinformationen für FreeLipSync widerrufen. Verwenden Sie separate Schlüssel oder unabhängige Autorisierungen, wenn Sie einen separaten Widerruf benötigen, nicht um die Parallelität zu erhöhen.

Fehlerbehebung

Die Clienteinstellungen können sich zwischen den Versionen ändern. Die aktuellen Anweisungen finden Sie in der verlinkten offiziellen Dokumentation jedes Kunden. Benötigen Sie eine direkte HTTP-Integration? Lesen Sie die API-Dokumentation.