Integrazione MCP

Il Model Context Protocol (MCP) è uno standard aperto per connettere assistenti AI a strumenti e fonti di dati esterni. Scavio esegue un server MCP che fornisce a qualsiasi client compatibile l'accesso a 11 strumenti che coprono Google Search, Amazon, Walmart, YouTube e Reddit. La configurazione richiede meno di 2 minuti.

Prerequisiti

1. Ottieni la tua chiave API su dashboard.scavio.dev
2. Sostituisci YOUR_SCAVIO_API_KEY negli esempi seguenti con la tua chiave reale

Claude Code

Esegui questo singolo comando nel tuo terminale:

claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

Per aggiungerlo a una configurazione di progetto condivisa (sotto controllo versione), usa --scope project:

claude mcp add --transport http --scope project scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

In alternativa, aggiungi direttamente la configurazione JSON:

claude mcp add-json scavio '{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}'

Verifica la connessione:

claude mcp list

Claude Desktop

1. Apri Claude Desktop
2. Vai su Impostazioni > Sviluppatore > Modifica configurazione
3. Aggiungi Scavio al tuo claude_desktop_config.json:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

4. Salva e riavvia Claude Desktop

Posizione del file di configurazione:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

1. Apri Cursor e vai su Impostazioni > Strumenti e MCP
2. Clicca su + Aggiungi nuovo server MCP
3. Seleziona il tipo HTTP e inserisci:
   • Nome: scavio
   • URL: https://mcp.scavio.dev/mcp
   • Headers: x-api-key: YOUR_SCAVIO_API_KEY
4. Clicca su Salva

Oppure modifica manualmente .cursor/mcp.json nella root del tuo progetto (o ~/.cursor/mcp.json per una configurazione globale):

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Windsurf

1. Apri Windsurf e clicca sull'icona del martello in Cascade
2. Clicca su Configura per aprire la configurazione MCP
3. Aggiungi Scavio a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

4. Salva il file e aggiorna Windsurf

VS Code (GitHub Copilot)

1. Crea .vscode/mcp.json nella root del tuo progetto:

{
  "servers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

2. Apri la tavolozza dei comandi (Ctrl+Shift+P / Cmd+Shift+P)
3. Esegui MCP: Elenca server per verificare la connessione

Per una configurazione globale, aggiungi la stessa configurazione alle impostazioni utente di VS Code sotto mcp.servers.

ChatGPT

ChatGPT supporta server MCP remoti tramite la sua funzionalità App e Connettori:

1. Vai su Impostazioni ChatGPT > App e Connettori
2. Clicca su Aggiungi connettore personalizzato
3. Inserisci l'URL del server MCP: https://mcp.scavio.dev/mcp
4. Configura l'autenticazione con la tua chiave API
5. Salva e inizia a usare gli strumenti di Scavio nelle tue chat

Il supporto MCP di ChatGPT richiede un piano Plus o Team e potrebbe richiedere la configurazione OAuth a seconda della tua configurazione.

Cline (Estensione VS Code)

1. Apri VS Code con Cline installato
2. Clicca sull'icona Server MCP nella barra laterale di Cline
3. Clicca su Configura server MCP
4. Aggiungi Scavio alla configurazione:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

5. Salva e Cline rileverà automaticamente il nuovo server

Zed Editor

1. Apri Impostazioni (Cmd+,)
2. Vai alla sezione Assistente
3. Aggiungi Scavio sotto server MCP:

{
  "assistant": {
    "mcp_servers": {
      "scavio": {
        "type": "http",
        "url": "https://mcp.scavio.dev/mcp",
        "headers": {
          "x-api-key": "YOUR_SCAVIO_API_KEY"
        }
      }
    }
  }
}

Qualsiasi client compatibile con MCP

Scavio funziona con qualsiasi strumento che supporti il Model Context Protocol. La configurazione universale:

{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}

Strumenti disponibili

Una volta connesso, il tuo assistente AI può usare questi 11 strumenti:

Risoluzione dei problemi

Il server non si connette?

• Verifica che la tua chiave API sia corretta e attiva
• Controlla i tuoi crediti con get_usage o su dashboard.scavio.dev
• Assicurati che l'URL sia esattamente https://mcp.scavio.dev/mcp (senza barra finale)

Gli strumenti non vengono visualizzati?

• Riavvia il tuo client AI dopo aver aggiunto la configurazione
• Controlla la presenza di errori di sintassi JSON nel file di configurazione
• Conferma che il server MCP appaia come "connesso" nelle impostazioni MCP del tuo client

Passaggi successivi

• API Google Search -- riferimento completo degli endpoint
• API Amazon -- ricerca prodotti e dettagli
• API YouTube -- ricerca e metadati
• API Walmart -- ricerca prodotti e dettagli
• API Reddit -- ricerca post e commenti annidati
• Limiti di velocità -- limiti per piano e header