Clés d'API

Les jetons d’accès personnels (PAT) vous permettent de vous authentifier auprès de l’API Pipe2.ai et du serveur MCP depuis des outils et du code externes.

Créer un jeton

Rendez-vous sur pipe2.ai/api-keys
Cliquez sur Create Token Avec les clients MCP :
Copiez le jeton — il n’est affiché qu’une seule fois

Utiliser votre jeton

Avec les SDK :

import { createClient } from '@pipe2-ai/sdk';
const client = createClient('YOUR_TOKEN');

Avec les clients MCP :

{
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}

Avec du GraphQL brut :

curl -X POST https://api.pipe2.ai/v1/graphql \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ pipelines { name } }"}'

Révoquer un jeton

Cliquez sur le bouton de révocation à côté de n’importe quel jeton. La révocation prend effet en moins de 30 secondes. Le jeton cessera de fonctionner pour tous les clients qui l’utilisent.

Contrôles des clés

Vous pouvez avoir jusqu’à 25 clés actives par compte. Les clés révoquées ou expirées libèrent une place. Définissez un nom, éventuellement plusieurs pipelines autorisés, une limite de crédits, une période de remise à zéro (aucune, quotidienne, hebdomadaire, mensuelle ou annuelle) et une durée (1, 7, 30, 90 ou 365 jours). Les périodes suivent le calendrier UTC et les semaines commencent le lundi. Sans limite, la clé peut utiliser les crédits disponibles du compte.

Utilisez pipelines:run pour exécuter toutes les pipelines, ou ajoutez un droit pipeline:run:SLUG par pipeline autorisée. Une clé peut avoir plusieurs droits spécifiques. Les requêtes API et MCP utilisent uniquement les autorisations choisies. Les autorisations et la sélection sont fixées à la création ; révoquez la clé et créez-en une autre pour les modifier. Conservez les clés des applications externes sur votre serveur.

Une exécution est bloquée si sa réservation dépasse la limite restante de la clé. Les crédits réellement facturés s’affichent après le règlement ; un remboursement libère la réservation.

mutation {
  create_personal_access_token(
    name: "My application"
    scopes: ["pipeline:run:YOUR_PIPELINE_SLUG", "pipeline:run:ANOTHER_PIPELINE_SLUG"]
    credit_limit: 100
    reset_period: "daily"
    expires_in_days: 90
  ) { token expires_at }
}