Guida alla configurazione di MCP

Questa guida ti accompagna nella connessione del tuo assistente AI al server MCP di Pipe2.ai.

Prerequisiti

• Un account Pipe2.ai con crediti
• Un token di accesso personale (PAT) — vedi Autenticazione

Claude Desktop

1. Genera un token di accesso personale nella tua dashboard di Pipe2.ai in Impostazioni > Chiavi API > Token di accesso personali.

2. Aggiungi il server MCP tramite la CLI:

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

   Oppure aggiungilo manualmente al tuo file di configurazione di 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. Riavvia Claude Desktop per applicare la nuova configurazione.

4. Verifica la connessione chiedendo a Claude: “Elenca le mie pipeline Pipe2.ai disponibili.”

Claude Code (CLI)

1. Aggiungi il server usando la CLI:

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

2. Avvia una sessione e chiedi a Claude Code di interagire con le tue pipeline:

   claude "List all available Pipe2.ai pipelines"

Cursor

1. Apri le impostazioni di Cursor (Cmd/Ctrl + Shift + P > “Cursor Settings”).

2. Vai alla sezione MCP.

3. Aggiungi un nuovo server MCP con queste impostazioni:

   • Nome: pipe2ai
   • URL: https://mcp.pipe2.ai/mcp
   • Header: Authorization: Bearer YOUR_TOKEN

4. Riavvia Cursor e usa gli strumenti di Pipe2.ai nella tua chat AI.

Altri client MCP

Qualsiasi client compatibile con MCP può connettersi a Pipe2.ai. La configurazione chiave:

Impostazione	Valore
URL del server	https://mcp.pipe2.ai/mcp
Trasporto	Streamable HTTP (preferito) o SSE (https://mcp.pipe2.ai/sse/)
Header di autenticazione	Authorization: Bearer YOUR_TOKEN

Nota

Per il flusso OAuth 2.1 invece dei token di accesso personali, consulta la pagina Autenticazione. OAuth è supportato per i client che implementano la specifica MCP OAuth.

Verificare la tua connessione

Una volta connesso, prova questi comandi con il tuo assistente AI:

1. “List available pipelines” — dovrebbe restituire tutte le pipeline attive con le relative descrizioni
2. “Check my credit balance” — dovrebbe mostrare i tuoi crediti attuali
3. “Show my recent assets” — dovrebbe elencare le immagini e i video generati

Se qualcuno di questi comandi fallisce, controlla il tuo token e la connettività di rete. Consulta Autenticazione per risolvere i problemi relativi ai token.