MCP Setup Guide

This guide walks you through connecting your AI assistant to the Pipe2.ai MCP server.

Prerequisites

• A Pipe2.ai account with credits
• A personal access token (PAT) — see Authentication

Claude Desktop

1. Generate a personal access token in your Pipe2.ai dashboard under Settings > API Keys > Personal Access Tokens.

2. Add the MCP server via the CLI:

   claude mcp add pipe2ai -- \
     https://mcp.pipe2.ai/mcp \
     --header "Authorization: Bearer YOUR_TOKEN"

   Or add it manually to your Claude Desktop config file:

   macOS

   // ~/Library/Application Support/Claude/claude_desktop_config.json
   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   Windows

   %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   Linux

   ~/.config/claude/claude_desktop_config.json

   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

3. Restart Claude Desktop to pick up the new configuration.

4. Verify the connection by asking Claude: “List my available Pipe2.ai pipelines.”

Claude Code (CLI)

1. Add the server using the CLI:

   claude mcp add pipe2ai \
     --transport http \
     --url https://mcp.pipe2.ai/mcp \
     --header "Authorization: Bearer YOUR_TOKEN"

2. Start a session and ask Claude Code to interact with your pipelines:

   claude "List all available Pipe2.ai pipelines"

Cursor

1. Open Cursor Settings (Cmd/Ctrl + Shift + P > “Cursor Settings”).

2. Navigate to the MCP section.

3. Add a new MCP server with these settings:

   • Name: pipe2ai
   • URL: https://mcp.pipe2.ai/mcp
   • Headers: Authorization: Bearer YOUR_TOKEN

4. Restart Cursor and use the Pipe2.ai tools in your AI chat.

Other MCP Clients

Any MCP-compatible client can connect to Pipe2.ai. The key configuration:

Setting	Value
Server URL	https://mcp.pipe2.ai/mcp
Transport	Streamable HTTP (preferred) or SSE (https://mcp.pipe2.ai/sse/)
Auth Header	Authorization: Bearer YOUR_TOKEN

Note

For OAuth 2.1 flow instead of personal access tokens, see the Authentication page. OAuth is supported for clients that implement the MCP OAuth specification.

Verifying Your Connection

Once connected, try these commands with your AI assistant:

1. “List available pipelines” — should return all active pipelines with descriptions
2. “Check my credit balance” — should show your current credits
3. “Show my recent assets” — should list your generated images and videos

If any of these fail, check your token and network connectivity. See Authentication for troubleshooting token issues.