DocTransform

Authentifizierung

Authentifiziere jede Anfrage mit einem API-Schlüssel im Authorization-Header.

Schlüssel erstellen

Erstelle Schlüssel auf deiner Kontoseite. Jeder Schlüssel beginnt mit dt_live_ und läuft nie von selbst ab. Du kannst bis zu 5 aktive Schlüssel haben.

Ein Schlüssel trägt einen oder mehrere von fünf Scopes: templates:read, runs:write, runs:read, reference_tables:read und reference_tables:write. Ein neuer Schlüssel erhält alle fünf.

reference_tables:read listet deine Referenztabellen auf, reference_tables:write ersetzt die Zeilen einer Tabelle. Schlüssel, die du vor diesen Scopes erstellt hast, haben beide erhalten, du musst also nichts neu erstellen.

Schlüssel senden

Sende den Schlüssel als Bearer-Token im Authorization-Header. Es gibt kein Cookie und keinen Testmodus:

curl "https://doctransform.xyz/api/v1/templates" \
  -H "Authorization: Bearer $DOCTRANSFORM_API_KEY"

Seit November 2026 meldet sich ein Assistent, den du selbst nutzt, mit Erlauben an: Füge DocTransform dort hinzu, klicke auf Erlauben, und es ist kein Schlüssel im Spiel, sodass nichts Geheimes in einem Chat steht. Ein Skript oder ein Assistent ohne Anmeldung nimmt weiterhin einen Schlüssel als Header. Der Schlüssel bleibt in einer Umgebungsvariablen:

Claude Code

claude mcp add --transport http doctransform https://doctransform.xyz/mcp --header 'Authorization: Bearer ${DOCTRANSFORM_API_KEY}'

Cursor

{
  "mcpServers": {
    "doctransform": {
      "url": "https://doctransform.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DOCTRANSFORM_API_KEY}"
      }
    }
  }
}

VS Code

{
  "servers": {
    "doctransform": {
      "type": "http",
      "url": "https://doctransform.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DOCTRANSFORM_API_KEY}"
      }
    }
  }
}

Der Assistent speichert den Schlüssel in seiner eigenen Konfigurationsdatei auf deinem Computer. Füge ihn nie mit --scope project hinzu: Dieser Bereich wird in einer Datei gespeichert, die dein Team in ein Repository einchecken kann, und der Schlüssel würde mitwandern.

Schlüssel rotieren oder widerrufen

Es gibt keine Rotation an Ort und Stelle: Erstelle den neuen Schlüssel, stelle dein Skript darauf um und widerrufe dann den alten auf derselben Kontoseite.

Halte den Schlüssel geheim

Achtung Nie einen Schlüssel in einem Browser oder einem Repository ablegen. Ein Schlüssel ist ein langlebiger Zugang mit vollem Kontozugriff: Bewahre ihn in einer Umgebungsvariable oder einem Secrets-Manager auf.

Eine Anfrage ohne gültigen Schlüssel scheitert mit API_KEY_MISSING, API_KEY_INVALID oder INSUFFICIENT_SCOPE.