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 Settings を開きます（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/）
認証ヘッダー	Authorization: Bearer YOUR_TOKEN

ノート

パーソナルアクセストークンの代わりに OAuth 2.1 フローを使う場合は、認証ページを参照してください。OAuth は、MCP の OAuth 仕様を実装するクライアントでサポートされています。

接続の確認

接続できたら、AI アシスタントで次のコマンドを試してみてください:

1. 「利用可能なパイプラインを一覧表示して」 — 説明付きですべてのアクティブなパイプラインが返されるはずです
2. 「クレジット残高を確認して」 — 現在のクレジットが表示されるはずです
3. 「最近のアセットを見せて」 — 生成した画像や動画が一覧表示されるはずです

いずれかが失敗する場合は、トークンとネットワーク接続を確認してください。トークンに関する問題のトラブルシューティングは認証を参照してください。