Chiavi API

I token di accesso personali (PAT) ti permettono di autenticarti con l’API e il server MCP di Pipe2.ai da strumenti e codice esterni.

Creare un token

Vai su pipe2.ai/api-keys
Clicca su Create Token Con i client MCP:
Copia il token — viene mostrato una sola volta

Usare il tuo token

Con gli SDK:

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

Con i client MCP:

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

Con GraphQL grezzo:

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

Revocare un token

Clicca sul pulsante di revoca accanto a qualsiasi token. La revoca ha effetto entro 30 secondi. Il token smetterà di funzionare per tutti i client che lo utilizzano.

Controlli delle chiavi

Puoi avere fino a 25 chiavi attive per account. Le chiavi revocate o scadute liberano un posto. Imposta un nome, facoltativamente più pipeline consentite, un limite di crediti, un periodo di azzeramento (nessuno, giornaliero, settimanale, mensile o annuale) e una durata (1, 7, 30, 90 o 365 giorni). I periodi seguono il calendario UTC e le settimane iniziano il lunedì. Senza limite, la chiave può usare i crediti disponibili sull’account.

Usa pipelines:run per eseguire qualsiasi pipeline, oppure aggiungi un permesso pipeline:run:SLUG per ogni pipeline consentita. Una chiave può avere più permessi specifici. Le richieste API e MCP usano solo le autorizzazioni scelte. Autorizzazioni e selezione sono definitive alla creazione; revoca la chiave e creane un’altra per cambiarle. Conserva le chiavi delle applicazioni esterne sul tuo server.

Le esecuzioni vengono bloccate quando la prenotazione supera il limite residuo della chiave. I crediti effettivamente addebitati compaiono dopo la liquidazione; i rimborsi liberano la prenotazione.

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