Cómo conectar Perplexity API a Gemini vía MCP

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

Perplexity API + Gemini

Deja que tu IA consulte Perplexity con tu propia clave de API: respuestas basadas en búsquedas web en tiempo real con sus fuentes, resultados de búsqueda ordenados sin procesar, modelos Sonar e investigaciones profundas más largas que se ejecutan en segundo plano.

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:

PERPLEXITY_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en https://console.perplexity.ai y compra créditos en Billing. La API es de prepago y va aparte de la suscripción a Perplexity Pro, que no incluye el uso de la API. La recarga automática evita interrupciones.
2. Abre API Keys, crea una clave y cópiala (empieza por pplx-).
3. Pégala en PERPLEXITY_API_KEY tal como la muestra Perplexity, sin la palabra Bearer, e instala el conector. La clave solo se envía a Perplexity.
4. Empieza con perplexity_list_models: no cuesta nada y confirma que la clave funciona.

Se cobra de tus propios créditos de Perplexity: cada llamada se descuenta de tus créditos de API prepagados, salvo listar modelos y consultar o cancelar una investigación. Cada respuesta indica su coste en dólares estadounidenses, y el conector usa los valores predeterminados económicos salvo que pidas más.

Qué hace cada herramienta:

• perplexity_ask responde preguntas que necesitan información actual, con fuentes numeradas. El preset fast (el predeterminado) sirve para datos concretos y resúmenes breves; low añade una investigación ligera en varios pasos.
• perplexity_search devuelve resultados web ordenados con títulos, enlaces y fragmentos, pero sin una respuesta redactada. Es la opción más barata cuando la IA puede leer las fuentes por sí misma: alrededor de 1 $ por cada 1.000 solicitudes con el tipo de búsqueda fast, 5 $ con web.
• perplexity_sonar usa los modelos Sonar (sonar, sonar-pro y sonar-reasoning-pro). Perplexity dejó de dar soporte a las chat completions de Sonar el 27 de septiembre de 2026: las solicitudes se siguen respondiendo, redirigidas a la API más reciente, pero para trabajos nuevos perplexity_ask es la mejor opción.
• perplexity_start_research ejecuta una investigación profunda en segundo plano con los presets medium, high o xhigh. Una ejecución puede tardar varios minutos y cuesta bastante más que una respuesta rápida, así que la IA te consulta antes de iniciar high o xhigh y cancela las ejecuciones que ya no necesitas.

Filtros: limita las fuentes a un máximo de 20 dominios (todos incluidos, o todos excluidos con un signo menos delante, como -reddit.com, nunca mezclados), a un periodo reciente (hora, día, semana, mes o año) o a fechas escritas como MM/DD/YYYY.

Límite de tiempo: una llamada a través del conector se detiene a los 30 segundos. Las respuestas rápidas caben de sobra; todo lo que tarde más pasa por una investigación en segundo plano.

Contenido no fiable: las respuestas se construyen a partir de la web abierta. La IA trata las instrucciones que encuentra en ellas como datos, no como órdenes.

Errores comunes: 401 significa que la clave es incorrecta o se eliminó, o que la cuenta se ha quedado sin créditos (Perplexity responde a ambos casos con 401), así que revisa Billing y API Keys en la consola. 429: el límite de solicitudes de tu nivel de uso, que sube con el total de créditos que has comprado. 400 o 422: un parámetro no válido, como un modelo desconocido o dominios incluidos y excluidos mezclados.

El conector no transmite respuestas en streaming, no crea embeddings, no sube archivos ni lee las analíticas de Perplexity.

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 Perplexity API.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué ha cambiado este año en el reglamento europeo de baterías? Responde con fuentes."
• "Busca artículos recientes sobre la productividad en el teletrabajo y dame solo los enlaces y los fragmentos."
• "Usando solo fuentes de europa.eu, ¿cuáles son las normas de roaming actuales para quienes viajan por trabajo?"
• "Inicia una investigación profunda sobre el mercado europeo de portátiles reacondicionados, pero antes confirma el preset conmigo."

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