Skyvern

Servidor MCP para que Claude / tu IA controle el navegador

Documentación

Model Context Protocol (MCP)

La implementación del servidor MCP de Skyvern ayuda a conectar tus aplicaciones de IA con el navegador. Esto permite que tus aplicaciones de IA hagan cosas como: completar formularios, descargar archivos, investigar información en la web y más.

Puedes conectar tus aplicaciones habilitadas para MCP a Skyvern de dos maneras:

Servidor Skyvern Local
- Usa tu LLM favorito para impulsar Skyvern
Skyvern Cloud
- Crea una cuenta en app.skyvern.com
- Obtén la clave API desde la página de configuración, que se usará para la instalación

Inicio rápido

⚠️ REQUISITO: Skyvern solo se ejecuta en un entorno Python 3.11 hoy ⚠️

Instala Skyvern
```
pip install skyvern
```
Configura Skyvern Ejecuta el asistente de configuración que te guiará a través del proceso de configuración. Puedes conectarte a Skyvern Cloud o a una versión local de Skyvern.
```
skyvern init
```
(Opcional) Inicia el servidor Skyvern. Solo es necesario en modo local
```
skyvern run server
```

Ejemplos

Skyvern permite que Claude busque las publicaciones principales de Hackernews hoy

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

Cursor buscando los mejores trabajos de programación en tu área

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

Pide a Windsurf que haga una búsqueda del formulario 5500 y descargue algunos archivos

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

Aplicaciones compatibles

skyvern init ayuda a configurar las siguientes aplicaciones para ti:

Cursor
Windsurf
Claude Desktop
OpenCode (skyvern setup opencode — usa autenticación con clave API; evita tiempos de espera de devolución de llamada OAuth)
¿Tu aplicación MCP personalizada?

OpenCode (MCP remoto)

Si opencode mcp auth Skyvern falla con tiempo de espera de devolución de llamada OAuth, usa autenticación con clave API en su lugar:

skyvern login
skyvern setup opencode

Esto escribe ~/.config/opencode/opencode.json con "oauth": false y tu encabezado x-api-key. No ejecutes opencode mcp auth después.

Nota: El endpoint remoto /mcp no tiene estado. Llama a skyvern_browser_session_create primero y pasa browser_session_id en cada llamada de herramienta del navegador, o las herramientas del navegador devolverán BrowserNotAvailable.

Usa la siguiente configuración si deseas configurar Skyvern para cualquier otra aplicación habilitada 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"
      ]
    }
  }
}

Configuración de lanzamiento en Glama

El flujo de "lanzamiento" de Glama es diferente de publicar el paquete en PyPI o en el registro oficial de MCP. Para Glama, necesitas un contenedor de servidor ejecutable para que Glama pueda iniciar el servidor MCP, inspeccionar el esquema de herramientas y publicar un lanzamiento instalable en su directorio.

Usa el Dockerfile dedicado en este directorio para ese flujo. El Dockerfile raíz es para la pila completa de la aplicación Skyvern y inicia python -m skyvern.forge, que es el entorno de ejecución incorrecto para un lanzamiento de Glama solo MCP.

Configuración recomendada para Glama:

Reclama el servidor en Glama. Este repositorio ya incluye glama.json, por lo que los mantenedores autorizados pueden reclamar la entrada Skyvern-AI/skyvern.
En la página de administración de Dockerfile de Glama, apunta la compilación a Dockerfile.glama.
Mantén el comando predeterminado a menos que Glama solicite explícitamente transporte HTTP. La imagen usa por defecto python -m skyvern run mcp sobre stdio.
Si deseas que el lanzamiento alojado en Glama use sesiones de navegador de Skyvern Cloud, agrega un secreto real SKYVERN_API_KEY en Glama. De lo contrario, el contenedor se inicia en modo local integrado, que es suficiente para la inspección pero no ideal para sesiones de navegador respaldadas por la nube.
Implementa, espera a que la inspección pase y luego usa la acción "Make Release" de Glama en la interfaz de administración del servidor.

Si también estás publicando en el registro oficial de MCP, trata eso como un paso separado. El registro oficial usa metadatos de paquete y server.json; los lanzamientos de Glama se basan en contenedores.