API 키

개인 액세스 토큰(PAT)을 사용하면 외부 도구와 코드에서 Pipe2.ai API 및 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 권한이 있는 키는 모든 파이프라인을 실행하거나 여러 슬러그를 지정할 수 있습니다. 지정한 목록은 새로운 실행을 제한합니다. 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 }
}