Stagehand MCP Server

O que é o Stagehand MCP Server?

O Stagehand MCP Server atua como uma ponte entre aplicações de IA e tarefas reais de automação na web. Ao expor os controles do navegador web como ferramentas MCP, ele permite que modelos de linguagem grande naveguem em sites, executem tarefas e coletem dados programaticamente. Ele utiliza o Browserbase para navegação remota sem cabeça e se integra diretamente ao Claude Desktop, tornando a automação sofisticada de navegadores acessível a fluxos de trabalho baseados em LLM.

Como Configurar

1. Clone o repositório do Stagehand MCP Server de sua fonte oficial.
2. No diretório do projeto, instale as dependências usando:

   npm install
   npm run build
   

3. Atualize sua configuração do Claude Desktop para registrar o Stagehand MCP Server:

   {
     "mcpServers": {
       "stagehand": {
         "command": "node",
         "args": ["path/to/mcp-server-browserbase/stagehand/dist/index.js"],
         "env": {
           "BROWSERBASE_API_KEY": "<SUA_CHAVE_API_BROWSERBASE>",
           "BROWSERBASE_PROJECT_ID": "<SEU_ID_PROJETO_BROWSERBASE>",
           "OPENAI_API_KEY": "<SUA_CHAVE_API_OPENAI>"
         }
       }
     }
   }
   

4. Execute o servidor com:

   node dist/index.js
   

5. Reinicie o Claude Desktop para carregar a nova configuração MCP. As ferramentas do Stagehand aparecerão como ferramentas MCP disponíveis.

Como Usar

• Inicie o Claude Desktop com o MCP Server configurado.
• Acesse as ferramentas do Stagehand no menu de ferramentas MCP disponíveis (procure pelo ícone do martelo).
• Use ferramentas como navegação no site, automação de ações e extração de dados selecionando a ferramenta relevante, inserindo os parâmetros necessários (por exemplo, URLs, ações, instruções) e executando a função.
• Revise recursos como logs de console ou capturas de tela através de seus respectivos endpoints quando necessário.
• Para demonstração visual, consulte a documentação disponível ou vídeos de demonstração mostrando o Claude interagindo com a web por meio do Stagehand MCP Server.

Principais Características

• Ferramentas de automação web padronizadas facilmente acessíveis dentro do Claude Desktop via MCP.
• Integração segura com o Browserbase para sessões de navegador remoto e sem cabeça.
• Conjunto de ferramentas executáveis: navegue até sites, execute ações, extraia dados estruturados.
• Endpoints de recursos fornecem logs de console do navegador e capturas de tela sob demanda para total rastreabilidade.
• Suporte a credenciais personalizadas e isolamento ambiental para tarefas sensíveis e operações seguras.

Casos de Uso

• Coleta automatizada de dados de páginas web para insights atualizados.
• Automação de fluxo de trabalho de ponta a ponta, como login em sites, navegação em dashboards e download de relatórios.
• Prototipagem rápida de fluxos de trabalho baseados em navegador alimentados por LLMs.
• Monitoramento e raspagem de conteúdo da web público com extração em tempo real através de automação orientada por LLM.
• Coleta de capturas de tela e logs de diagnóstico para conformidade ou relatórios.

Perguntas Frequentes

Q1: Preciso expor meus arquivos locais ou banco de dados para usar o Stagehand MCP Server?

Não, o Stagehand MCP Server interage apenas com recursos da web e fornece acesso a sessões de navegador, capturas de tela e logs. Seus arquivos locais e bancos de dados permanecem isolados, a menos que integrados explicitamente através de outros servidores MCP.

Q2: O que eu preciso do Browserbase?

Você precisará de uma Chave da API do Browserbase e ID do Projeto. Essas credenciais são necessárias para criar sessões de navegador remoto seguras.

Q3: Como sei se o Stagehand MCP Server está funcionando corretamente?

Após iniciar o servidor e reiniciar o Claude Desktop, você deve ver as ferramentas do Stagehand aparecerem como ferramentas MCP chamáveis. Além disso, verifique a saída da linha de comando do servidor para confirmação de conexão ou erros.

Q4: Posso usar o Stagehand MCP Server com outros hosts de LLM além do Claude Desktop?

Atualmente, a principal integração oficial é com o Claude Desktop, mas qualquer host que suporte o protocolo e ferramentas MCP pode potencialmente usar o Stagehand MCP Server.

Q5: É possível capturar capturas de tela ou acessar logs do navegador programaticamente?

Sim, tanto as capturas de tela quanto os logs do console do navegador são expostos como recursos que podem ser acessados através de seus identificadores únicos, facilitando a recuperação de evidências ou a depuração de resultados programaticamente.