Skyvern

Model Context Protocol (MCP)

A implementação do servidor MCP da Skyvern ajuda a conectar seus aplicativos de IA ao navegador. Isso permite que seus aplicativos de IA façam coisas como: preencher formulários, baixar arquivos, pesquisar informações na web e muito mais.

Você pode conectar seus aplicativos habilitados para MCP à Skyvern de duas maneiras:

1. Servidor Skyvern Local
   • Use seu LLM favorito para alimentar a Skyvern
2. Skyvern Cloud
   • Crie uma conta em app.skyvern.com
   • Obtenha a chave de API na página de configurações, que será usada para a configuração.

Início Rápido

⚠️ REQUISITO: A Skyvern só roda em ambiente Python 3.11 atualmente ⚠️

1. Instale a Skyvern

   pip install skyvern
   

2. Configure a Skyvern Execute o assistente de configuração, que o guiará pelo processo de configuração. Você pode conectar-se à Skyvern Cloud ou a uma versão local da Skyvern.

   skyvern init
   

3. (Opcional) Inicie o Servidor Skyvern. Apenas necessário no modo local

   skyvern run server
   

Exemplos

A Skyvern permite que o Claude consulte as principais postagens do Hackernews hoje

https://github.com/user-attachments/assets/0c10dd96-c6ff-4b99-ad99-f34a5afd04fe

Cursor consultando as principais vagas de programação na sua região

https://github.com/user-attachments/assets/084c89c9-6229-4bac-adc9-6ad69b41327d

Peça ao Windsurf para fazer uma busca no formulário 5500 e baixar alguns arquivos

https://github.com/user-attachments/assets/70cfe310-24dc-431a-adde-e72691f198a7

Aplicativos Suportados

skyvern init ajuda a configurar os seguintes aplicativos para você:

• Cursor
• Windsurf
• Claude Desktop
• OpenCode (skyvern setup opencode — usa autenticação por chave de API; evita timeouts de callback OAuth)
• Seu aplicativo MCP personalizado?

OpenCode (MCP remoto)

Se opencode mcp auth Skyvern falhar com timeout de callback OAuth, use autenticação por chave de API em vez disso:

skyvern login
skyvern setup opencode

Isso grava ~/.config/opencode/opencode.json com "oauth": false e seu cabeçalho x-api-key. Não execute opencode mcp auth depois.

Nota: O endpoint remoto /mcp é sem estado. Chame skyvern_browser_session_create primeiro e passe browser_session_id em cada chamada de ferramenta do navegador, ou as ferramentas do navegador retornarão BrowserNotAvailable.

Use a seguinte configuração se quiser configurar a Skyvern para qualquer outro aplicativo habilitado para MCP

{
  "mcpServers": {
    "Skyvern": {
      "env": {
        "SKYVERN_BASE_URL": "https://api.skyvern.com", # "http://localhost:8000" if running locally
        "SKYVERN_API_KEY": "YOUR_SKYVERN_API_KEY" # find the local SKYVERN_API_KEY in the .env file after running `skyvern init` or in your Skyvern Cloud console
      },
      "command": "PATH_TO_PYTHON",
      "args": [
        "-m",
        "skyvern",
        "run",
        "mcp"
      ]
    }
  }
}

Configuração de Release do Glama

O fluxo de "release" do Glama é diferente de publicar o pacote no PyPI ou no Registro MCP oficial. Para o Glama, você precisa de um contêiner de servidor executável para que o Glama possa iniciar o servidor MCP, inspecionar o esquema das ferramentas e publicar uma versão instalável em seu diretório.

Use o Dockerfile dedicado neste diretório para esse fluxo. O Dockerfile raiz é para a pilha completa do aplicativo Skyvern e inicia python -m skyvern.forge, que é o runtime errado para uma release do Glama apenas com MCP.

Configuração recomendada do Glama:

1. Reivindique o servidor no Glama. Este repositório já inclui glama.json, então mantenedores autorizados podem reivindicar a entrada Skyvern-AI/skyvern.
2. Na página de administração do Dockerfile do Glama, aponte a compilação para Dockerfile.glama.
3. Mantenha o comando padrão, a menos que o Glama peça explicitamente transporte HTTP. A imagem usa por padrão python -m skyvern run mcp via stdio.
4. Se você quiser que a release hospedada do Glama use sessões de navegador da Skyvern Cloud, adicione um segredo real SKYVERN_API_KEY no Glama. Caso contrário, o contêiner inicia no modo embutido local, o que é suficiente para inspeção, mas não é ideal para sessões de navegador com suporte em nuvem.
5. Implante, aguarde a inspeção passar e use a ação "Make Release" do Glama na interface de administração do servidor.

Se você também estiver publicando no Registro MCP oficial, trate isso como uma etapa separada. O registro oficial usa metadados de pacote e server.json; as releases do Glama são baseadas em contêiner.