Claude Desktop verbinden
footage.one in Claude Desktop einbinden — Server-URL eintragen, per OAuth2 einloggen.
Voraussetzungen
- Claude Desktop installiert
- footage.one-Account mit aktiver Anmeldung möglich
Server hinzufügen
Claude Desktop unterstützt das Hinzufügen von MCP-Servern direkt über eine URL — keine Config-Datei nötig.
- Claude Desktop öffnen.
- Settings → Connectors (bzw. Custom connectors) öffnen.
- Add custom connector klicken.
- URL eintragen:
https://mcp.footage.one/mcp - Bestätigen.
Login per OAuth
Beim ersten Aufruf eines Tools öffnet Claude Desktop einen Browser-Tab mit dem footage.one-Login. Dort meldest du dich mit deinem regulären Account an. Nach erfolgreichem Login schließt sich der Tab automatisch — Claude Desktop hat den Zugang.
OAuth-Tokens werden von Claude Desktop sicher verwaltet und bei Bedarf erneuert.
Erster Test
Frage Claude:
Liste mir die ersten fünf Alben aus footage.one und nenne pro Album die Anzahl der Assets.
Claude ruft list_albums auf, holt sich pro Album zusätzliche Daten und antwortet strukturiert.
Häufige Fehler
| Symptom | Ursache |
|---|---|
| "Server not found" | URL-Tippfehler oder Netzwerkproblem |
| Browser-Tab öffnet nicht | Default-Browser-Setting prüfen, Popup-Blocker prüfen |
| "Unauthorized" nach Login | Account hat keinen Zugriff — anderen User testen |
| Keine Tools sichtbar | Claude Desktop neu starten |
API-Token statt OAuth?
Aktuell ist der OAuth-Flow der einzige unterstützte Weg in Claude Desktop. API-Tokens (aus deinem Account) sind primär für headless Clients gedacht — direkte REST-Aufrufe, eigene Python-Skripte, n8n. Token-basierte Auth in Claude Desktop ist in Arbeit, aber noch nicht verfügbar.