comet-mcp

comet-mcp

Dê ao Claude Code um navegador que pensa.

Um servidor MCP que conecta o Claude Code ao Perplexity Comet — permitindo navegação web agêntica, pesquisa aprofundada e monitoramento de tarefas em tempo real.

Por quê?

As ferramentas web existentes para o Claude Code se enquadram em duas categorias, ambas com limitações:

1. APIs de busca (Tavily, Perplexity API, WebFetch)

Retornam texto estático. Sem interação, sem login, sem conteúdo dinâmico. Ótimas para consultas rápidas, mas não conseguem navegar em sites complexos ou preencher formulários.

2. Automação de Navegador (browser-use, Puppeteer MCP, Playwright MCP)

Conseguem interagir com páginas, mas usam uma abordagem um-agente-faz-tudo: o mesmo modelo de raciocínio que escreve seu código também decide onde clicar, o que digitar e como navegar. Isso sobrecarrega a janela de contexto e fragmenta o foco.

3. Comet MCP: Delegação Multi-Agente

O Comet MCP adota uma abordagem diferente. Em vez de o Claude controlar um navegador diretamente, ele delega ao Perplexity Comet — uma IA projetada especificamente para pesquisa e navegação web.

• Claude permanece focado na sua tarefa de codificação
• Comet cuida da navegação: navegação, muros de login, conteúdo dinâmico, pesquisa aprofundada
• Resultado: a inteligência de codificação do Claude + a inteligência web da Perplexity, trabalhando juntas

Início Rápido

1. Configure o Claude Code

Adicione em ~/.claude.json ou .mcp.json:

{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"]
    }
  }
}

2. Instale o Comet Browser

Baixe e instale o Perplexity Comet.

Pronto! O servidor MCP inicia automaticamente o Comet com depuração remota quando necessário.

3. Use no Claude Code

You: "Use Comet to research the top AI frameworks in 2025"
Claude: [delegates to Comet, monitors progress, returns results]

You: "Log into my GitHub and check my notifications"
Claude: [Comet handles the login flow and navigation]

Ferramentas

Ferramenta	Descrição
comet_connect	Conecta ao Comet (inicia automaticamente se necessário)
comet_ask	Envia uma tarefa e aguarda a resposta
comet_poll	Verifica o progresso de tarefas de longa duração
comet_stop	Interrompe a tarefa atual
comet_screenshot	Captura a página atual
comet_mode	Alterna modos: busca, pesquisa, laboratórios, aprendizado

Como Funciona

Claude Code  →  MCP Server  →  CDP  →  Comet Browser  →  Perplexity AI
   (reasoning)     (bridge)                              (web browsing)

Claude envia objetivos de alto nível ("pesquisar X", "fazer login em Y"). O Comet descobre os cliques, rolagens e buscas. Os resultados fluem de volta para o Claude.

Requisitos

• Node.js 18+
• Perplexity Comet Browser
• Claude Code (ou qualquer cliente MCP)
• Plataformas suportadas: macOS, Windows, WSL2

Suporte a Windows e WSL

Windows nativo

Funciona de imediato. O Comet MCP detecta automaticamente o Windows e inicia o Comet a partir do local de instalação padrão.

WSL2 (Subsistema Windows para Linux)

O WSL2 requer rede espelhada (mirrored networking) para conectar ao Comet em execução no Windows:

1. Ative a rede espelhada (configuração única):

   # Create/edit %USERPROFILE%\.wslconfig (Windows side)
   [wsl2]
   networkingMode=mirrored
   

2. Reinicie o WSL:

   wsl --shutdown
   # Then reopen your WSL terminal
   

3. Pronto! O Comet MCP detecta automaticamente o WSL e usa o PowerShell para se comunicar com o Windows.

Se a rede espelhada não estiver disponível, você verá uma mensagem de erro útil com instruções de configuração.

Caminho Personalizado do Comet

Se o Comet estiver instalado em um local não padrão:

{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"],
      "env": {
        "COMET_PATH": "/path/to/your/Comet"
      }
    }
  }
}

Solução de Problemas

"Não é possível conectar ao Comet"

• macOS: Certifique-se de que o Comet esteja instalado em /Applications/Comet.app
• Windows: O Comet deve estar em %LOCALAPPDATA%\Perplexity\Comet\Application\
• Verifique se a porta 9222 está disponível

"O WSL não consegue conectar ao localhost do Windows"

• Ative a rede espelhada (veja a seção WSL acima)
• Ou execute o Claude Code no PowerShell do Windows em vez do WSL

"Ferramentas não aparecem no Claude"

• Reinicie o Claude Code após alterações de configuração

Licença

MIT

---

Reportar Problemas · Contribuir