Skip to content

API Keys

Personal access tokens (PATs) let you authenticate with the Pipe2.ai API and MCP server from external tools and code.

Creating a token

  1. Go to pipe2.ai/api-keys
  2. Click Create Token
  3. Give it a descriptive name (e.g. “Claude Desktop”, “CI Pipeline”)
  4. Copy the token — it’s only shown once

Using your token

With SDKs:

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

With MCP clients (Claude Desktop, Cursor, etc.):

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

With raw GraphQL:

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

Revoking a token

Click the revoke button next to any token. Revocation takes effect within 30 seconds. The token will stop working for all clients using it.

Limits

  • Maximum 5 active tokens per account
  • Tokens expire after 1 year
  • Each token has full access to your account (scoped tokens coming soon)