API-Schlüssel

Wofür API-Schlüssel gedacht sind

API-Schlüssel sind für langfristige Verbindungen deiner eigenen Agenten und Skripte gedacht, wenn die OAuth-Anmeldung im Browser unpraktisch ist. Für KI-Apps wie Claude oder ChatGPT ist die Anmeldung weiterhin der normale Weg. Die Anleitung findest du unter MCP-Konfiguration.

Schlüssel nutzen dasselbe Konto und dieselbe Meta-Verbindung wie die Web-App und setzen MCP-, CLI- und API-Zugriff für dein Konto voraus. Sie funktionieren aus verschiedenen Netzwerken.

Schlüssel erstellen

Öffne Account > MCP, CLI & API und wähle unter API Keys die Option Create API Key.
Gib dem Schlüssel einen Namen, damit du erkennst, wofür du ihn nutzt.
Bestätige per Kontrollkästchen, dass der Schlüssel für eine Person bestimmt ist und nicht geteilt werden darf. Erstelle ihn dann.
Kopiere den geheimen adk_-Schlüssel und bewahre ihn sicher auf. Er wird nur einmal angezeigt.

Schlüssel mit MCP verwenden

Sende Authorization: Bearer adk_... an https://adsuploader.com/api/mcp. Bei einem MCP-Client, der eigene Header unterstützt, kann die Konfiguration so aussehen:

{
  "mcpServers": {
    "ads-uploader": {
      "url": "https://adsuploader.com/api/mcp",
      "headers": { "Authorization": "Bearer adk_..." }
    }
  }
}

Ersetze adk_... durch deinen Schlüssel und halte die Konfiguration geheim.

Schlüssel mit dem CLI verwenden

Setze ADS_API_KEY über die Secret-Einstellungen deines Servers oder CI-Systems. Die Variable hat Vorrang vor den Anmeldedaten in ~/.config/adsuploader/credentials.json. Um einen Schlüssel stattdessen lokal zu speichern, führe Folgendes aus:

ads login --api-key

Füge den Schlüssel bei der verdeckten Eingabeaufforderung ein oder übergib ihn über stdin. Das CLI prüft ihn vor dem Speichern. Schreibe den geheimen Schlüssel nicht in den Befehl, da er sonst im Shell-Verlauf erscheinen kann.

Mit ads whoami prüfst du die Anmeldemethode. ads config zeigt sie ebenfalls an; vom Schlüssel wird nur das Präfix angezeigt.

Ein Schlüssel pro Person

Jedes Konto kann standardmäßig einen aktiven Schlüssel für eine Person haben. Kontaktiere den Support, wenn du mehr Schlüssel brauchst; Admins können das Limit auf 10 erhöhen. Füge für jemand anderen einen Teamplatz hinzu. Teile niemals einen Schlüssel: Ads Uploader kann einen Schlüssel widerrufen, der von mehr als einer Person genutzt wird.

Schlüssel laufen nicht ab

Schlüssel bleiben gültig, bis sie widerrufen werden. Ungenutzte Schlüssel werden nach 90 Tagen widerrufen. Wir informieren dich darüber per E-Mail. Zeit, in der dein Plan pausiert ist, zählt nicht zu diesen 90 Tagen.

Schlüssel widerrufen

Öffne Account > MCP, CLI & API, suche den Schlüssel unter API Keys und wähle Revoke. Anfragen mit diesem Schlüssel funktionieren dann nicht mehr.

ads logout entfernt den gespeicherten Schlüssel nur von diesem Rechner und widerruft ihn nicht. Der Befehl kann ADS_API_KEY nicht aufheben. Entferne diese Variable deshalb auch aus deiner Umgebung oder deinen Secret-Einstellungen.

Browser-Anmeldungen stehen separat unter MCP and CLI-Connected AI Apps. Wähle dort Revoke, um eine CLI- oder KI-App-Verbindung zu widerrufen.

Dokumentation