Servidor MCP de la plataforma de la API de Perplexity

La implementación oficial del servidor MCP para la plataforma de la 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 utilizando la API de búsqueda de Perplexity. Devuelve resultados de búsqueda clasificados con metadatos, ideal para encontrar información actual.

perplexity_ask

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

perplexity_research

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

perplexity_reason

Razonamiento avanzado y resolución de problemas utilizando 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. Predeterminado: false

Configuración

Obtenga su clave de API

1. Obtenga su clave de API de Perplexity desde el Portal de API

2. Reemplace your_key_here en las configuraciones a continuación con su clave de API

3. (Opcional) Establecer tiempo de espera: PERPLEXITY_TIMEOUT_MS=600000 (predeterminado: 5 minutos)

4. (Opcional) Establecer URL base personalizada: PERPLEXITY_BASE_URL=https://your-custom-url.com (predeterminado: https://api.perplexity.ai)

5. (Opcional) Establecer 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 instale a través del 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 se pueden configurar manualmente utilizando el mismo contenedor mcpServers en su configuración de cliente (como se muestra para Cursor). Si un cliente tiene un esquema diferente, consulte su documentación para conocer el formato de contenedor exacto.

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

{
  "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á ejecutando este servidor en el trabajo, especialmente detrás de un firewall o proxy de la empresa, es posible que deba 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.

• Es posible que también necesite 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 utilizar PERPLEXITY_PROXY. Por ejemplo:

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

Si su proxy necesita un nombre de usuario y una contraseña, utilice:

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

3. Alternativa: Variables de entorno estándar

Si prefiere utilizar las variables estándar, admitimos HTTPS_PROXY y HTTP_PROXY.

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

Implementación del servidor HTTP

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

Variables de entorno

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 de API: Asegúrese de que PERPLEXITY_API_KEY esté configurado correctamente

• Errores de conexión: Compruebe su conexión a Internet y la validez de la clave de API

• Herramienta no encontrada: Asegúrese de que el paquete esté instalado y que la ruta del comando sea correcta

• Errores de tiempo de espera: Para consultas de investigación muy largas, establezca PERPLEXITY_TIMEOUT_MS en 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 de EOF / Inicialización: Algunos clientes MCP estrictos fallan porque npx escribe mensajes de instalación en stdout. Utilice npx -yq en lugar de npx -y para suprimir esta salida.

Para obtener asistencia, visite community.perplexity.ai o envíe un problema.