API-ключи

Персональные токены доступа (PAT) позволяют аутентифицироваться в API Pipe2.ai и на MCP-сервере из внешних инструментов и кода.

Создание токена

Перейдите на pipe2.ai/api-keys
Нажмите Create Token Через MCP-клиенты:
Скопируйте токен — он показывается только один раз

Использование токена

Через SDK:

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

Через MCP-клиенты:

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

Через чистый GraphQL:

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

Отзыв токена

Нажмите кнопку отзыва рядом с любым токеном. Отзыв вступает в силу в течение 30 секунд. Токен перестанет работать для всех клиентов, использующих его.

Настройки ключей

На одном аккаунте может быть до 25 активных ключей. Отозванные и истёкшие ключи освобождают место. Укажите имя, при необходимости несколько разрешённых пайплайнов, лимит кредитов, период сброса (без сброса, ежедневно, еженедельно, ежемесячно или ежегодно) и срок действия (1, 7, 30, 90 или 365 дней). Периоды считаются по календарю UTC; неделя начинается в понедельник. Без лимита ключ может расходовать доступные кредиты аккаунта.

Право pipelines:run позволяет запускать любой пайплайн. Для выбранных пайплайнов добавьте по одному праву pipeline:run:SLUG на каждый; одному ключу можно дать несколько таких прав. Запросы API и MCP используют только выбранные права. Права и список задаются при создании; чтобы изменить их, отзовите ключ и создайте новый. Ключи внешних приложений храните на своём сервере.

Запуск блокируется, если резервирование превышает остаток лимита ключа. Списанные кредиты отображаются после расчёта; возврат освобождает резерв.

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