Ejecuta `claude mcp add --transport http scavio https://mcp.scavio.dev/mcp --header "x-api-key: YOUR_API_KEY"` y luego escribe `/mcp` dentro de Claude Code para confirmar que las herramientas cargaron. Esa es toda la configuracion, y lleva menos de cinco minutos. Una vez conectado, Claude puede buscar en Google, Reddit, YouTube, Amazon y TikTok con datos en vivo en lugar de adivinar desde su fecha de corte. Los dos puntos donde la gente se traba: el servidor MCP se autentica con un header `x-api-key` (NO `Authorization: Bearer` — Bearer es solo para la API REST), y tienes que ejecutar `/mcp` para verificar, porque un fallo silencioso se ve identico a una configuracion correcta hasta que Claude intenta llamar a una herramienta.
Requisitos previos
- Claude Code instalado y con sesion iniciada (el mismo flujo funciona en Cursor, VS Code, Windsurf y ChatGPT).
- Una API key de Scavio desde el dashboard en scavio.dev — el registro te da 50 creditos gratis, sin tarjeta.
- Salida de red desde la maquina que ejecuta Claude Code (el MCP remoto vive en mcp.scavio.dev, asi que un firewall que bloquee HTTPS saliente lo rompera).
Guia paso a paso
Paso 1: Consigue tu API key de Scavio
Inicia sesion en scavio.dev, abre el dashboard y copia tu API key. Una cuenta nueva trae 50 creditos gratis, suficiente para probar cada herramienta varias veces. La mayoria de llamadas cuesta 1 credito; el post de Reddit (arbol completo de comentarios) y Google con light_request:false cuestan 2.
# Tu key se ve asi (copiala del dashboard):
# sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxPaso 2: Anade el servidor con un comando
La via mas rapida es la CLI. Esto registra el MCP remoto de Scavio sobre HTTP y adjunta el header de auth de una vez. Fijate que el header es x-api-key, no Bearer.
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
--header "x-api-key: YOUR_API_KEY"Paso 3: O edita la config JSON directamente
Si prefieres configurar a mano (o estas en Cursor/Windsurf/VS Code), anade este bloque a tu archivo de config MCP. La entrada mcpServers apunta a la URL remota y fija el mismo header x-api-key. Este JSON es identico en todos los clientes.
{
"mcpServers": {
"scavio": {
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}Paso 4: Verifica con /mcp antes de confiar
Abre Claude Code y escribe /mcp. Deberias ver scavio listado como conectado, con sus herramientas (busqueda de Google, Reddit, YouTube, Amazon, TikTok y mas). Si muestra fallido o se queda conectando para siempre, casi siempre es una de dos cosas: una key invalida/vencida, o pegaste Bearer en vez de x-api-key. Corrige el header y vuelve a anadirlo.
/mcp
# Esperado: scavio connected (tools: search_google, reddit_search, youtube_search, ...)Paso 5: Pide a Claude que busque
Cuando /mcp muestra conectado, simplemente pide en lenguaje natural. Claude elige la herramienta de Scavio correcta y devuelve resultados en vivo. Sin cableado extra.
# En Claude Code, escribe:
Search Google for "best web data API for AI agents 2026" and summarize the top 5 results.Ejemplo en Python
# El servidor MCP se maneja a traves de Claude, no de Python. Pero este es el
# flujo CLI equivalente para anadir e inspeccionar el servidor desde la terminal:
# 1. Anade el MCP remoto de Scavio (transporte HTTP, auth x-api-key)
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
--header "x-api-key: YOUR_API_KEY"
# 2. Lista los servidores configurados y confirma que scavio esta ahi
claude mcp list
# 3. Dentro de una sesion interactiva de Claude Code, verifica que cargaron las tools
# /mcp -> scavio connectedEjemplo en JavaScript
// Misma config, en forma JSON. Pega esto en el bloque mcpServers de tu
// archivo de ajustes MCP de Claude Code / Cursor / Windsurf / VS Code.
{
"mcpServers": {
"scavio": {
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}Salida esperada
Despues de `/mcp`, Claude Code muestra:
scavio connected
tools: search_google, reddit_search, reddit_post, youtube_search, youtube_metadata, amazon_product, walmart_product, tiktok_profile, tiktok_search_videos, tiktok_hashtag, ... (33 tools en total)
Luego, pedir a Claude "busca en Google X" devuelve resultados organicos en vivo, busquedas relacionadas y (con el modo profundo) datos de people-also-ask y knowledge-graph — extraidos al momento, no de la fecha de corte del modelo.