Chaves de API

Os tokens de acesso pessoal (PATs) permitem que você se autentique na API e no servidor MCP do Pipe2.ai a partir de ferramentas e código externos.

Criando um token

Acesse pipe2.ai/api-keys
Clique em Criar token Com clientes MCP:
Copie o token — ele é exibido apenas uma vez

Usando seu token

Com SDKs:

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

Com clientes MCP:

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

Com GraphQL puro:

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

Revogando um token

Clique no botão de revogação ao lado de qualquer token. A revogação entra em vigor em até 30 segundos. O token deixará de funcionar para todos os clientes que o utilizam.

Controles das chaves

Você pode ter até 25 chaves ativas por conta. Chaves revogadas ou expiradas liberam uma vaga. Defina um nome, opcionalmente várias pipelines permitidas, um limite de créditos, um período de reinício (nenhum, diário, semanal, mensal ou anual) e uma validade (1, 7, 30, 90 ou 365 dias). Os períodos seguem o calendário UTC; a semana começa na segunda-feira. Sem limite, a chave pode usar os créditos disponíveis na conta.

Use pipelines:run para executar qualquer pipeline ou adicione um âmbito pipeline:run:SLUG por pipeline permitido. Uma chave pode ter vários âmbitos específicos. Os pedidos à API e ao MCP usam apenas as permissões escolhidas. As permissões e a seleção são definidas ao criar a chave; revogue-a e crie outra para as alterar. Guarde as chaves de aplicações externas no seu servidor.

As execuções são bloqueadas quando a reserva ultrapassa o limite restante da chave. Os créditos cobrados aparecem após a liquidação e os reembolsos libertam a 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 }
}