Perplexity

oficial

Un servidor MCP que se conecta a la API Sonar de Perplexity, permitiendo investigación en tiempo real en toda la web en IA conversacional.

GitHub

2.4k

¿Qué puedes hacer con Perplexity MCP?

Búsqueda web en tiempo real — Solicita información actualizada mediante perplexity_search, con filtros de recencia opcionales y restricciones de dominio.
Preguntas y respuestas rápidas con fuentes en vivo — Usa perplexity_ask para respuestas conversacionales respaldadas por búsqueda web en tiempo real.
Informes de investigación profundos — Solicita análisis exhaustivos y de múltiples pasos a través de perplexity_research, que transmite el progreso de tareas de larga duración.
Tareas de razonamiento complejo — Aprovecha perplexity_reason para resolución avanzada de problemas y trabajo analítico.
Opciones de implementación personalizadas — Ejecuta el servidor localmente, mediante Docker, o como un servicio HTTP autohospedado con configuración de proxy y seguridad ajustable.

Documentación

Servidor MCP de la Plataforma API de Perplexity

La implementación oficial del servidor MCP para la Plataforma API de Perplexity, que proporciona a los asistentes de IA capacidades de búsqueda web en tiempo real, razonamiento e investigación a través de la API de Agente y la API de Búsqueda.

Servidor MCP Remoto

El servidor MCP remoto está alojado por Perplexity y es la forma más fácil de comenzar: las mismas herramientas, sin nada que instalar o actualizar. Los botones de Cursor y VS Code en la parte superior de esta página se conectan a él con un clic. Si tu cliente MCP aún no admite servidores remotos, salta a la configuración del servidor local a continuación. Conéctate a través de Streamable HTTP con tu clave de API de Perplexity:

https://api.perplexity.ai/mcp

Para Claude Code:

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

Consulta la documentación de integración MCP para la configuración manual de Cursor/VS Code, el uso desde la API de Anthropic y la configuración para otros clientes.

Servidor MCP Local

Obtén tu Clave de API

Obtén tu Clave de API de Perplexity desde el Portal de API
Reemplaza your_key_here en las configuraciones a continuación con tu clave de API
(Opcional) Establece el tiempo de espera: PERPLEXITY_TIMEOUT_MS=600000 (predeterminado: 5 minutos)
(Opcional) Establece una URL base personalizada: PERPLEXITY_BASE_URL=https://your-custom-url.com (predeterminado: https://api.perplexity.ai)
(Opcional) Establece el nivel de registro: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (predeterminado: ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

O instala mediante el complemento:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Otros Clientes MCP

La mayoría de los clientes se pueden configurar manualmente usando el mismo envoltorio mcpServers en su configuración de cliente (como se muestra para Cursor). Si un cliente tiene un esquema diferente, consulta su documentación para conocer el formato exacto del envoltorio.

Para la configuración manual, estos clientes usan todos la misma estructura mcpServers:

Cliente	Archivo de Configuración
Cursor	`~/.cursor/mcp.json`
Claude Desktop	`claude_desktop_config.json`
Kiro	`.kiro/settings/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
VS Code	`.vscode/mcp.json`

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

Configuración de Proxy (Para Redes Corporativas)

Si estás ejecutando este servidor en el trabajo, especialmente detrás de un firewall o proxy de la empresa, es posible que necesites indicar al programa cómo enviar su tráfico de internet a través del proxy de tu red. Sigue estos pasos:

1. Obtén los detalles de tu proxy

Pregunta a tu departamento de TI por la dirección y el puerto de tu proxy HTTPS.
También es posible que necesites un nombre de usuario y una contraseña.

2. Establece la variable de entorno del proxy

La forma más fácil y confiable para Perplexity MCP es usar PERPLEXITY_PROXY. Por ejemplo:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

Si tu proxy requiere nombre de usuario y contraseña, usa:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. Alternativa: Variables de entorno estándar

Si prefieres usar las variables estándar, admitimos HTTPS_PROXY y HTTP_PROXY.

[!NOTA] El servidor verifica la configuración del proxy en este orden: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Si no se establece ninguna, se conecta directamente a internet. Las URL deben incluir https://. Los puertos típicos son 8080, 3128 y 80.

Modo HTTP Autohospedado

Para implementaciones en la nube o compartidas, ejecuta el servidor en modo HTTP.

Variables de Entorno

Variable	Descripción	Predeterminado
`PERPLEXITY_API_KEY`	Tu clave de API de Perplexity	Requerida
`PERPLEXITY_BASE_URL`	URL base personalizada para solicitudes de API	`https://api.perplexity.ai`
`PORT`	Puerto del servidor HTTP	`8080`
`BIND_ADDRESS`	Interfaz de red a la que vincularse. El valor predeterminado es loopback. Establécelo en `0.0.0.0` para exponer en todas las interfaces.	`127.0.0.1`
`ALLOWED_ORIGINS`	Orígenes CORS (separados por comas). El valor predeterminado está vacío (sin solicitudes de navegador entre orígenes). Establécelo en una lista de permitidos explícita (p. ej., `https://app.example.com`) o en `*` para permitir cualquier origen.	(vacío)
`ALLOWED_HOSTS`	Valores adicionales del encabezado `Host` para aceptar (separados por comas). Los hosts de loopback en `PORT` siempre están permitidos. Agrega el nombre de host público al vincular a `0.0.0.0`.	(solo loopback)

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

El servidor será accesible en http://localhost:8080/mcp

Herramientas Disponibles

perplexity_search

Búsqueda web directa mediante la API de Búsqueda de Perplexity. Devuelve resultados de búsqueda clasificados con metadatos, perfectos para encontrar información actual. Admite filtros de actualidad (search_recency_filter) y restricciones de dominio (search_domain_filter).

perplexity_ask

IA conversacional de propósito general con búsqueda web en tiempo real, respaldada por el ajuste preestablecido fast de la API de Agente. Ideal para preguntas rápidas y búsquedas cotidianas.

perplexity_research

Investigación profunda y exhaustiva respaldada por el ajuste preestablecido high de la API de Agente. Ideal para análisis minuciosos e informes detallados. Las ejecuciones pueden tardar minutos; el servidor transmite la ejecución e informa el progreso a los clientes que lo soliciten.

perplexity_reason

Razonamiento avanzado y resolución de problemas respaldado por el ajuste preestablecido medium de la API de Agente. Perfecto para tareas analíticas complejas.

[!NOTA] Los ajustes preestablecidos son configuraciones administradas (modelo, configuración de búsqueda, presupuesto de pasos) que Perplexity mantiene ajustados con el tiempo; consulta la guía de ajustes preestablecidos. Las versiones anteriores de este servidor llamaban a los modelos heredados sonar-pro, sonar-reasoning-pro y sonar-deep-research y aceptaban los parámetros strip_thinking / reasoning_effort. Esos parámetros ya no forman parte de los esquemas de las herramientas y se ignoran si se envían; la API de Agente no produce etiquetas <think>.

Uso como Biblioteca

El paquete también exporta la fábrica del servidor para integrarlo en tu propio proceso de Node:

import { createPerplexityServer } from "@perplexity-ai/mcp-server";

// Single-tenant: reads PERPLEXITY_API_KEY from the environment.
const server = createPerplexityServer("my-service");

// Multi-tenant hosts resolve the key per call instead. When a provider is
// set, the environment variable is never consulted, and a provider that
// returns no key fails the call rather than falling back.
const tenantServer = createPerplexityServer("my-service", {
  apiKey: () => currentRequestApiKey,
});

Monta el servidor devuelto en cualquier transporte MCP (stdio, HTTP transmisible, en memoria).

Solución de Problemas

Problemas con la Clave de API: Asegúrate de que PERPLEXITY_API_KEY esté configurada correctamente
Errores de Conexión: Verifica tu conexión a internet y la validez de la clave de API
Herramienta No Encontrada: Asegúrate de que el paquete esté instalado y la ruta del comando sea correcta
Errores de Tiempo de Espera: Para consultas de investigación muy largas, establece PERPLEXITY_TIMEOUT_MS en un valor más alto
Problemas de Proxy: Verifica tu configuración de PERPLEXITY_PROXY o HTTPS_PROXY y asegúrate de que api.perplexity.ai no esté bloqueado por tu firewall.
Errores de EOF / Inicialización: Algunos clientes MCP estrictos fallan porque npx escribe mensajes de instalación en stdout. Usa npx -yq en lugar de npx -y para suprimir esta salida.

Para soporte, visita community.perplexity.ai o reporta un problema.