Guía de configuración de MCP

Esta guía te explica cómo conectar tu asistente de IA al servidor MCP de Pipe2.ai.

Requisitos previos

• Una cuenta de Pipe2.ai con créditos
• Un token de acceso personal (PAT) — consulta Autenticación

Claude Desktop

1. Genera un token de acceso personal en tu panel de Pipe2.ai, en Settings > API Keys > Personal Access Tokens.

2. Añade el servidor MCP mediante la CLI:

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

   O añádelo manualmente a tu archivo de configuración de 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. Reinicia Claude Desktop para que aplique la nueva configuración.

4. Verifica la conexión pidiéndole a Claude: “Lista mis pipelines de Pipe2.ai disponibles.”

Claude Code (CLI)

1. Añade el servidor usando la CLI:

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

2. Inicia una sesión y pídele a Claude Code que interactúe con tus pipelines:

   claude "List all available Pipe2.ai pipelines"

Cursor

1. Abre los ajustes de Cursor (Cmd/Ctrl + Shift + P > “Cursor Settings”).

2. Ve a la sección MCP.

3. Añade un nuevo servidor MCP con estos ajustes:

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

4. Reinicia Cursor y usa las herramientas de Pipe2.ai en tu chat de IA.

Otros clientes MCP

Cualquier cliente compatible con MCP puede conectarse a Pipe2.ai. La configuración clave:

Ajuste	Valor
URL del servidor	https://mcp.pipe2.ai/mcp
Transporte	Streamable HTTP (preferido) o SSE (https://mcp.pipe2.ai/sse/)
Cabecera de autenticación	Authorization: Bearer YOUR_TOKEN

Nota

Para el flujo OAuth 2.1 en lugar de los tokens de acceso personal, consulta la página de Autenticación. OAuth es compatible con los clientes que implementan la especificación OAuth de MCP.

Verificar tu conexión

Una vez conectado, prueba estos comandos con tu asistente de IA:

1. “List available pipelines” — debería devolver todos los pipelines activos con sus descripciones
2. “Check my credit balance” — debería mostrar tus créditos actuales
3. “Show my recent assets” — debería listar tus imágenes y vídeos generados

Si alguno falla, comprueba tu token y la conectividad de red. Consulta Autenticación para solucionar problemas con los tokens.