Perplexity Ask MCP Server

oficial

Un conector para la API de Perplexity que permite realizar búsquedas web dentro del ecosistema MCP.

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 los modelos Sonar y la API de Búsqueda.

Herramientas Disponibles

perplexity_search

Búsqueda web directa usando la API de Búsqueda de Perplexity. Devuelve resultados de búsqueda clasificados con metadatos, perfecto para encontrar información actual.

perplexity_ask

IA conversacional de propósito general con búsqueda web en tiempo real usando el modelo sonar-pro. Ideal para preguntas rápidas y búsquedas cotidianas.

perplexity_research

Investigación profunda y exhaustiva usando el modelo sonar-deep-research. Ideal para análisis minuciosos e informes detallados.

perplexity_reason

Razonamiento avanzado y resolución de problemas usando el modelo sonar-reasoning-pro. Perfecto para tareas analíticas complejas.

[!TIP] Disponible como parámetro opcional para perplexity_reason y perplexity_research: strip_thinking

Establézcalo en true para eliminar las etiquetas <think>...</think> de la respuesta, ahorrando tokens de contexto. Valor predeterminado: false

Configuración

Obtenga su Clave API

Obtenga su Clave API de Perplexity desde el Portal API
Reemplace your_key_here en las configuraciones siguientes con su clave API
(Opcional) Establezca el tiempo de espera: PERPLEXITY_TIMEOUT_MS=600000 (predeterminado: 5 minutos)
(Opcional) Establezca una URL base personalizada: PERPLEXITY_BASE_URL=https://your-custom-url.com (predeterminado: https://api.perplexity.ai)
(Opcional) Establezca 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 instálelo mediante plugin:

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

Cursor, Claude Desktop, Kiro, Windsurf y VS Code

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

Para la configuración manual, todos estos clientes usan 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 ejecuta este servidor en el trabajo—especialmente detrás de un firewall o proxy corporativo—puede que necesite indicarle al programa cómo enviar su tráfico de internet a través del proxy de su red. Siga estos pasos:

1. Obtenga los detalles de su proxy

Solicite a su departamento de TI la dirección y el puerto de su proxy HTTPS.
También puede necesitar un nombre de usuario y una contraseña.

2. Establezca la variable de entorno del proxy

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

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

Si su proxy requiere nombre de usuario y contraseña, use:

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

3. Alternativa: Variables de entorno estándar

Si prefiere usar las variables estándar, soportamos HTTPS_PROXY y HTTP_PROXY.

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

Despliegue del Servidor HTTP

Para despliegues en la nube o compartidos, ejecute el servidor en modo HTTP.

Variables de Entorno

Variable	Descripción	Valor Predeterminado
`PERPLEXITY_API_KEY`	Su clave API de Perplexity	Requerida
`PERPLEXITY_BASE_URL`	URL base personalizada para las solicitudes API	`https://api.perplexity.ai`
`PORT`	Puerto del servidor HTTP	`8080`
`BIND_ADDRESS`	Interfaz de red a la que enlazar. Predeterminado a loopback. Establezca en `0.0.0.0` para exponer en todas las interfaces.	`127.0.0.1`
`ALLOWED_ORIGINS`	Orígenes CORS (separados por comas). Predeterminado a vacío (sin solicitudes de navegador de origen cruzado). Establezca una lista explícita de permitidos (ej. `https://app.example.com`) o en `*` para permitir cualquier origen.	(vacío)
`ALLOWED_HOSTS`	Valores adicionales de cabecera `Host` a aceptar (separados por comas). Los hosts de loopback en `PORT` siempre están permitidos. Añada el nombre de host público al enlazar 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

Solución de Problemas

Problemas con la Clave API: Asegúrese de que PERPLEXITY_API_KEY esté configurada correctamente
Errores de Conexión: Verifique su conexión a internet y la validez de la clave API
Herramienta No Encontrada: Asegúrese 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, establezca PERPLEXITY_TIMEOUT_MS a un valor más alto
Problemas de Proxy: Verifique su configuración de PERPLEXITY_PROXY o HTTPS_PROXY y asegúrese de que api.perplexity.ai no esté bloqueado por su firewall.
Errores EOF / de Inicialización: Algunos clientes MCP estrictos fallan porque npx escribe mensajes de instalación en stdout. Use npx -yq en lugar de npx -y para suprimir esta salida.

Para soporte, visite community.perplexity.ai o presente un problema.