MCP 安装指南

本指南将带你将 AI 助手连接到 Pipe2.ai MCP 服务器。

前置条件

• 一个拥有积分的 Pipe2.ai 账户
• 一个个人访问令牌（PAT）—— 参见身份认证

Claude Desktop

1. 在你的 Pipe2.ai 仪表盘中，于 Settings > API Keys > Personal Access Tokens 下生成一个个人访问令牌。

2. 通过 CLI 添加 MCP 服务器：

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

   或者手动将其添加到你的 Claude Desktop 配置文件中：

   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. 重启 Claude Desktop 以加载新配置。

4. 通过向 Claude 提问来验证连接：“列出我可用的 Pipe2.ai 流水线。“

Claude Code（CLI）

1. 使用 CLI 添加服务器：

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

2. 启动一个会话，并让 Claude Code 与你的流水线交互：

   claude "List all available Pipe2.ai pipelines"

Cursor

1. 打开 Cursor 设置（Cmd/Ctrl + Shift + P > “Cursor Settings”）。

2. 导航到 MCP 部分。

3. 添加一个新的 MCP 服务器，使用以下设置：

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

4. 重启 Cursor，然后在你的 AI 对话中使用 Pipe2.ai 工具。

其他 MCP 客户端

任何兼容 MCP 的客户端都可以连接到 Pipe2.ai。关键配置如下：

设置	值
服务器 URL	https://mcp.pipe2.ai/mcp
传输方式	Streamable HTTP（首选）或 SSE（https://mcp.pipe2.ai/sse/）
认证 Header	Authorization: Bearer YOUR_TOKEN

注意

若要使用 OAuth 2.1 流程而非个人访问令牌，请参见身份认证页面。对于实现了 MCP OAuth 规范的客户端，均支持 OAuth。

验证你的连接

连接完成后，向你的 AI 助手尝试以下命令：

1. “列出可用的流水线” —— 应返回所有活跃流水线及其描述
2. “查询我的积分余额” —— 应显示你当前的积分
3. “显示我最近的素材” —— 应列出你生成的图像和视频

如果其中任何一项失败，请检查你的令牌和网络连通性。关于令牌问题的排查，参见身份认证。