Claves de API

Los tokens de acceso personal (PAT) te permiten autenticarte con la API de Pipe2.ai y el servidor MCP desde herramientas y código externos.

Crear un token

Ve a pipe2.ai/api-keys
Haz clic en Create Token Con clientes MCP:
Copia el token — solo se muestra una vez

Usar tu token

Con los SDKs:

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

Con clientes MCP:

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

Con GraphQL directo:

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

Revocar un token

Haz clic en el botón de revocar junto a cualquier token. La revocación surte efecto en un plazo de 30 segundos. El token dejará de funcionar para todos los clientes que lo utilicen.

Controles de claves

Puedes tener hasta 25 claves activas por cuenta. Las claves revocadas o caducadas liberan un espacio. Define un nombre, pipelines permitidos opcionales, un límite de créditos, un período de reinicio (ninguno, diario, semanal, mensual o anual) y una caducidad (1, 7, 30, 90 o 365 días). Los períodos siguen el calendario UTC; la semana comienza el lunes. Sin límite, la clave puede usar los créditos disponibles de la cuenta.

Usa pipelines:run para ejecutar cualquier pipeline, o añade un permiso pipeline:run:SLUG por cada pipeline permitido. Una clave puede tener varios permisos específicos. Las solicitudes a la API y MCP usan solo los permisos elegidos. Los permisos y la selección quedan fijados al crear la clave; revócala y crea otra para cambiarlos. Guarda las claves de aplicaciones externas en tu servidor.

Las ejecuciones se bloquean cuando su reserva supera el límite restante de la clave. Los créditos cobrados aparecen después de la liquidación y los reembolsos liberan la reserva.

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