Perplexity Ask MCP Server

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 Agent API y la Search API.

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 de 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

1. Obtén tu clave de API de Perplexity desde el Portal de API
2. Reemplaza your_key_here en las configuraciones a continuación con tu clave de API
3. (Opcional) Establece el tiempo de espera: PERPLEXITY_TIMEOUT_MS=600000 (predeterminado: 5 minutos)
4. (Opcional) Establece una URL base personalizada: PERPLEXITY_BASE_URL=https://your-custom-url.com (predeterminado: https://api.perplexity.ai)
5. (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 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

Plugins de Agente

Este repositorio está empaquetado como un Agent Plugin, por lo que los clientes que admiten el estándar pueden instalarlo directamente desde este repositorio. El formato de Agent Plugins no transporta secretos, así que establece la variable de entorno PERPLEXITY_API_KEY a través de la configuración de plugin o MCP de tu cliente.

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, 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 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.

[!NOTE] 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 exponerlo 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 (por ejemplo, https://app.example.com) o en * para permitir cualquier origen.	(vacío)
ALLOWED_HOSTS	Valores adicionales de cabecera 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 Search API de Perplexity. Devuelve resultados de búsqueda clasificados con metadatos, perfecto para encontrar información actual. Admite filtros de actualidad (search_recency_filter), restricciones de dominio (search_domain_filter) y Fast Search (search_type: "fast") para menor latencia y costo.

perplexity_ask

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

perplexity_research

Investigación profunda y exhaustiva respaldada por el preset high de la Agent API. 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 preset medium de la Agent API. Perfecto para tareas analíticas complejas.

[!NOTE] Los presets son configuraciones administradas (modelo, configuración de búsqueda, presupuesto de pasos) que Perplexity mantiene ajustadas con el tiempo; consulta la guía de presets. 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 Agent API no produce etiquetas <think>.

Uso como Biblioteca

El paquete también exporta la fábrica del servidor para incrustarlo 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 tu 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 a 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.

---