DocTransform

Authentification

Authentifiez chaque requête avec une clé API dans l'en-tête Authorization.

Créer une clé

Créez les clés depuis votre page Compte. Toute clé commence par dt_live_ et n’expire jamais d’elle-même. Vous pouvez avoir jusqu’à 5 clés actives.

Une clé porte un ou plusieurs de cinq droits : templates:read, runs:write, runs:read, reference_tables:read et reference_tables:write. Une nouvelle clé reçoit les cinq.

reference_tables:read liste vos tables de référence et reference_tables:write remplace les lignes d’une table. Les clés créées avant l’existence de ces droits ont reçu les deux, il n’y a donc rien à recréer.

Envoyer la clé

Envoyez la clé comme jeton Bearer dans l’en-tête Authorization. Il n’y a ni cookie, ni mode test :

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

Depuis novembre 2026, un assistant que vous utilisez vous-même se connecte avec Autoriser : ajoutez-y DocTransform, cliquez sur Autoriser, et aucune clé n’est en jeu, donc rien de secret ne reste dans une conversation. Un script, ou un assistant sans connexion, prend toujours une clé comme en-tête. La clé reste dans une variable d’environnement :

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}"
      }
    }
  }
}

L’assistant enregistre la clé dans son propre fichier de configuration, sur votre ordinateur. Ne l’ajoutez jamais avec --scope project : cette portée est enregistrée dans un fichier que votre équipe versionne dans un dépôt, et la clé partirait avec lui.

Renouveler ou révoquer une clé

Il n’y a pas de renouvellement sur place : créez la nouvelle clé, basculez votre script dessus, puis révoquez l’ancienne depuis la même carte de la page Compte.

Gardez la clé secrète

Attention Ne mettez jamais une clé dans un navigateur ni un dépôt. Une clé est un identifiant durable avec un accès complet au compte : gardez-la dans une variable d’environnement ou un gestionnaire de secrets.

Une requête sans clé valide échoue avec API_KEY_MISSING, API_KEY_INVALID ou INSUFFICIENT_SCOPE.