Integracion MCP

El Model Context Protocol (MCP) es un estandar abierto para conectar asistentes de IA con herramientas y fuentes de datos externas. Scavio ejecuta un servidor MCP que da acceso a cualquier cliente compatible a 11 herramientas que cubren Google Search, Amazon, Walmart, YouTube y Reddit. La configuracion toma menos de 2 minutos.

Requisitos previos

1. Obtiene tu clave API en dashboard.scavio.dev
2. Reemplaza YOUR_SCAVIO_API_KEY en los ejemplos a continuacion con tu clave real

Claude Code

Ejecuta este unico comando en tu terminal:

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

Para agregarlo a una configuracion de proyecto compartida (versionada en control de codigo), usa --scope project:

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

Alternativamente, agrega la configuracion JSON directamente:

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

Verifica la conexion:

claude mcp list

Claude Desktop

1. Abre Claude Desktop
2. Ve a Settings > Developer > Edit Config
3. Agrega Scavio a tu claude_desktop_config.json:

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

4. Guarda y reinicia Claude Desktop

Ubicacion del archivo de configuracion:

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

Cursor

1. Abre Cursor y ve a Settings > Tools & MCP
2. Haz clic en + Add New MCP Server
3. Selecciona el tipo HTTP e introduce:
   • Name: scavio
   • URL: https://mcp.scavio.dev/mcp
   • Headers: x-api-key: YOUR_SCAVIO_API_KEY
4. Haz clic en Save

O edita manualmente .cursor/mcp.json en la raiz de tu proyecto (o ~/.cursor/mcp.json para configuracion global):

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

Windsurf

1. Abre Windsurf y haz clic en el icono de martillo en Cascade
2. Haz clic en Configure para abrir la configuracion MCP
3. Agrega 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. Guarda el archivo y actualiza Windsurf

VS Code (GitHub Copilot)

1. Crea .vscode/mcp.json en la raiz de tu proyecto:

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

2. Abre la Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P)
3. Ejecuta MCP: List Servers para verificar la conexion

Para una configuracion global, agrega la misma configuracion en los ajustes de usuario de VS Code bajo mcp.servers.

ChatGPT

ChatGPT soporta servidores MCP remotos a traves de su funcionalidad Apps & Connectors:

1. Ve a Configuracion de ChatGPT > Apps & Connectors
2. Haz clic en Add custom connector
3. Introduce la URL del servidor MCP: https://mcp.scavio.dev/mcp
4. Configura la autenticacion con tu clave API
5. Guarda y comienza a usar las herramientas de Scavio en tus chats

El soporte MCP de ChatGPT requiere un plan Plus o Team y puede requerir configuracion OAuth dependiendo de tu setup.

Cline (Extension de VS Code)

1. Abre VS Code con Cline instalado
2. Haz clic en el icono de MCP Servers en la barra lateral de Cline
3. Haz clic en Configure MCP Servers
4. Agrega Scavio a la configuracion:

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

5. Guarda y Cline detectara automaticamente el nuevo servidor

Zed Editor

1. Abre Settings (Cmd+,)
2. Navega a la seccion Assistant
3. Agrega Scavio en servidores MCP:

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

Cualquier cliente compatible con MCP

Scavio funciona con cualquier herramienta que soporte el Model Context Protocol. La configuracion universal:

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

Herramientas disponibles

Una vez conectado, tu asistente de IA puede usar estas 11 herramientas:

Solucion de problemas

El servidor no se conecta?

• Verifica que tu clave API sea correcta y este activa
• Consulta tus creditos con get_usage o en dashboard.scavio.dev
• Asegurate de que la URL sea exactamente https://mcp.scavio.dev/mcp (sin barra final)

Las herramientas no aparecen?

• Reinicia tu cliente de IA despues de agregar la configuracion
• Verifica que no haya errores de sintaxis JSON en tu archivo de configuracion
• Confirma que el servidor MCP aparezca como "connected" en la configuracion MCP de tu cliente

Siguientes pasos

• Google Search API -- referencia completa del endpoint
• Amazon API -- busqueda de productos y detalles
• YouTube API -- busqueda y metadatos
• Walmart API -- busqueda de productos y detalles
• Reddit API -- busqueda de publicaciones y comentarios enlazados
• Rate Limits -- limites por plan