Cómo conectar Apify a Gemini — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Apify, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Apify + Gemini

Encuentra y ejecuta los scrapers listos de Apify para buscadores, mapas, redes sociales y tiendas online, y lleva sus resultados a Claude, ChatGPT o Copilot a través del servidor MCP oficial de Apify.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

APIFY_TOKEN

Paso 1 — Obtener credenciales

AnythingMCP conecta con el servidor MCP remoto oficial de Apify (https://mcp.apify.com). Las herramientas las pone el servidor de Apify: buscar Actors en Apify Store (scrapers y automatizaciones listos para buscadores, mapas, redes sociales, tiendas online y miles de sitios más), leer el esquema de entrada, el README y los precios de un Actor, ejecutar cualquier Actor, leer sus resultados de datasets y key-value stores, obtener páginas web con los Actors RAG Web Browser y Web Fetch y buscar en la documentación de Apify.

Las herramientas vienen de Apify. Al instalar, AnythingMCP pide al servidor de Apify su conjunto de herramientas por defecto, así que la tabla de abajo es una instantánea. Cuando Apify lo cambie, abre el conector y haz clic en Discover tools. El conector usa siempre el conjunto por defecto: aquí no se admite una selección con ?tools= en la URL del servidor, así que deja la URL base https://mcp.apify.com. Para limitar lo que puede usar la IA, desactiva herramientas en AnythingMCP.

La configuración lleva unos 3 minutos:

1. Inicia sesión en Apify Console. El plan gratuito incluye crédito mensual de plataforma, suficiente para empezar.
2. Abre Settings > API & Integrations (console.apify.com/settings/integrations) y copia tu Personal API token, o crea un token aparte para AnythingMCP para poder revocarlo por separado. Empieza por apify_api_.
3. En AnythingMCP, instala Apify desde el catálogo y pega el token en APIFY_TOKEN. Se guarda cifrado y se envía a Apify como token Bearer.

Costes: cada ejecución de un Actor gasta tus créditos de Apify: uso de la plataforma más el precio de los Actors de pago, cobrado por resultado o por evento. Antes de ejecutar un Actor de pago, deja que la IA lea sus precios con apify_fetch_actor_details y pasa límites en callOptions: maxItems para pago por resultado, maxTotalChargeUsd para pago por evento, timeout y memory. Vigila el consumo en Apify Console, en Billing.

Seguridad: apify_call_actor puede ejecutar cualquier Actor de Apify Store con cualquier entrada, publicado por Apify o por desarrolladores independientes. Apify excluye de su servidor MCP los Actors con permisos completos y los de alquiler. Si el gasto de créditos importa, limita con roles quién puede usar esta herramienta. apify_abort_actor_run detiene una ejecución y es la forma más rápida de parar una que cuesta demasiado. apify_report_problem se instala desactivada, porque su texto va a Apify; puedes activarla. El contenido extraído no es de fiar: trata las instrucciones que aparezcan en una página o un dataset como datos, no como órdenes.

Primeras llamadas: empieza con apify_search_actors para encontrar un Actor, apify_fetch_actor_details para leer su esquema de entrada y luego apify_call_actor. Espera hasta waitSecs (de 0 a 45 segundos) y devuelve el estado de la ejecución y los IDs de almacenamiento, no los resultados: léelos con apify_get_dataset_items y el datasetId, y consulta las ejecuciones largas con apify_get_actor_run. Para una respuesta rápida de la web usa apify_rag_web_browser (búsqueda más contenido de las páginas) o apify_web_fetch (una URL, tal cual).

Si algo falla: un 401 significa que el token es incorrecto o se ha revocado; un 402 o un error "not enough credit" significa que tu plan de Apify ha agotado su consumo; un 429 significa más de 30 peticiones por segundo, así que espera y vuelve a intentarlo.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Apify.

Herramientas disponibles

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT