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에게 “List my available Pipe2.ai pipelines.”라고 요청하여 연결을 확인합니다.

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. “List available pipelines” — 설명과 함께 모든 활성 파이프라인을 반환해야 합니다
2. “Check my credit balance” — 현재 크레딧을 표시해야 합니다
3. “Show my recent assets” — 생성된 이미지와 동영상을 나열해야 합니다

이 중 어느 것이라도 실패하면 토큰과 네트워크 연결을 확인하세요. 토큰 문제 해결은 인증을 참조하세요.