Perplexity Ask MCP Server

Servidor MCP da Plataforma Perplexity API

     

A implementação oficial do servidor MCP para a Plataforma Perplexity API, fornecendo a assistentes de IA capacidades de busca na web em tempo real, raciocínio e pesquisa através dos modelos Sonar e da API de Busca.

Ferramentas Disponíveis

perplexity_search

Busca direta na web usando a API de Busca do Perplexity. Retorna resultados de busca classificados com metadados, perfeito para encontrar informações atuais.

perplexity_ask

IA conversacional de propósito geral com busca na web em tempo real usando o modelo sonar-pro. Ótimo para perguntas rápidas e buscas cotidianas.

perplexity_research

Pesquisa profunda e abrangente usando o modelo sonar-deep-research. Ideal para análises minuciosas e relatórios detalhados.

perplexity_reason

Raciocínio avançado e resolução de problemas usando o modelo sonar-reasoning-pro. Perfeito para tarefas analíticas complexas.

[!TIP] Disponível como parâmetro opcional para perplexity_reason e perplexity_research: strip_thinking

Defina como true para remover as tags <think>...</think> da resposta, economizando tokens de contexto. Padrão: false

Configuração

Obtenha Sua Chave de API

1. Obtenha sua Chave de API Perplexity no Portal da API
2. Substitua your_key_here nas configurações abaixo pela sua chave de API
3. (Opcional) Defina o tempo limite: PERPLEXITY_TIMEOUT_MS=600000 (padrão: 5 minutos)
4. (Opcional) Defina a URL base personalizada: PERPLEXITY_BASE_URL=https://your-custom-url.com (padrão: https://api.perplexity.ai)
5. (Opcional) Defina o nível de log: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (padrão: ERROR)

Claude Code

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

Ou instale via 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 e VS Code

A maioria dos clientes pode ser configurada manualmente usando o mesmo wrapper mcpServers em sua configuração de cliente (como mostrado para o Cursor). Se um cliente tiver um esquema diferente, verifique sua documentação para o formato exato do wrapper.

Para configuração manual, todos esses clientes usam a mesma estrutura mcpServers:

Cliente	Arquivo de Configuração
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"
      }
    }
  }
}

Configuração de Proxy (Para Redes Corporativas)

Se você estiver executando este servidor no trabalho — especialmente atrás de um firewall ou proxy corporativo — pode ser necessário informar ao programa como enviar seu tráfego de internet através do proxy da sua rede. Siga estes passos:

1. Obtenha os detalhes do seu proxy

• Solicite ao seu departamento de TI o endereço e a porta do proxy HTTPS.
• Você também pode precisar de um nome de usuário e senha.

2. Defina a variável de ambiente do proxy

A maneira mais fácil e confiável para o Perplexity MCP é usar PERPLEXITY_PROXY. Por exemplo:

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

Se seu proxy precisar de nome de usuário e senha, use:

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

3. Alternativa: Variáveis de ambiente padrão

Se preferir usar as variáveis padrão, oferecemos suporte a HTTPS_PROXY e HTTP_PROXY.

[!NOTE] O servidor verifica as configurações de proxy nesta ordem: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Se nenhuma estiver definida, ele se conecta diretamente à internet. As URLs devem incluir https://. As portas típicas são 8080, 3128 e 80.

Implantação do Servidor HTTP

Para implantações em nuvem ou compartilhadas, execute o servidor no modo HTTP.

Variáveis de Ambiente

Variável	Descrição	Padrão
PERPLEXITY_API_KEY	Sua chave de API Perplexity	Obrigatório
PERPLEXITY_BASE_URL	URL base personalizada para requisições da API	https://api.perplexity.ai
PORT	Porta do servidor HTTP	8080
BIND_ADDRESS	Interface de rede para vinculação. Padrão é loopback. Defina como 0.0.0.0 para expor em todas as interfaces.	127.0.0.1
ALLOWED_ORIGINS	Origens CORS (separadas por vírgula). Padrão é vazio (sem requisições de navegador de origem cruzada). Defina como uma lista de permissões explícita (ex.: https://app.example.com) ou como * para permitir qualquer origem.	(vazio)
ALLOWED_HOSTS	Valores adicionais de cabeçalho Host a aceitar (separados por vírgula). Hosts de loopback em PORT são sempre permitidos. Adicione o nome de host público ao vincular a 0.0.0.0.	(somente 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

O servidor estará acessível em http://localhost:8080/mcp

Solução de Problemas

• Problemas com a Chave de API: Certifique-se de que PERPLEXITY_API_KEY esteja definida corretamente
• Erros de Conexão: Verifique sua conexão com a internet e a validade da chave de API
• Ferramenta Não Encontrada: Certifique-se de que o pacote está instalado e o caminho do comando está correto
• Erros de Tempo Limite: Para consultas de pesquisa muito longas, defina PERPLEXITY_TIMEOUT_MS para um valor mais alto
• Problemas de Proxy: Verifique sua configuração de PERPLEXITY_PROXY ou HTTPS_PROXY e certifique-se de que api.perplexity.ai não está bloqueado pelo seu firewall.
• Erros de EOF / Inicialização: Alguns clientes MCP estritos falham porque npx grava mensagens de instalação no stdout. Use npx -yq em vez de npx -y para suprimir essa saída.

Para suporte, visite community.perplexity.ai ou registre um problema.

---