Steel MCP Server

Dale a Claude, Cursor, VS Code u otro cliente MCP un navegador Chromium gestionado por Steel. Usa Steel para leer páginas que bloquean un fetch simple, tomar capturas de pantalla o trabajar en sitios interactivos haciendo clic, escribiendo y rellenando formularios.

A diferencia del bucle de capturas de pantalla y cajas numeradas de v1, v2 lee las páginas como markdown o árboles de accesibilidad, muestra capturas pequeñas mediante bloques de imagen de MCP sin usar píxeles para interactuar, y hace explícitas las sesiones de navegador.

Estado: 2.0.0-rc.8. Ejecuta el servidor localmente a través de stdio, o ejecuta tú mismo el endpoint alojado — está incluido en el paquete y documentado más abajo. mcp.steel.dev aún no está activo.

Ejemplos de indicaciones

Related MCP server: visual-inspector-mcp

Lo que expone

El perfil browse predeterminado incluye dieciséis herramientas:

Configura STEEL_PROFILE=scrape para exponer solo las tres herramientas de lectura sin estado. Nunca inician una sesión de navegador. El perfil browse predeterminado añade las trece herramientas de sesión anteriores.

Identidad guardada y sesiones no predeterminadas

Llama a steel_session_options con una URL de destino absoluta, un objetivo read, interact o account, y solo las necesidades que la tarea exija explícitamente. Las lecturas simples siguen recomendando steel_scrape. Los planes no predeterminados devuelven una configuration firmada de corta duración para steel_session_create; el token está vinculado a esta credencial de Steel y caduca a los diez minutos. Cuando una solicitud dice "mi perfil", "inicio de sesión guardado" o "credenciales de Steel", descubre primero las opciones de cuenta; nunca adivines un UUID de perfil ni un espacio de nombres de credencial.

{
  "url": "https://example.com/account",
  "goal": "account",
  "needs": ["persist_profile", "location"],
  "country": "DE"
}

El catálogo de cuentas expone solo el UUID/estado/marcas de tiempo del perfil y el espacio de nombres/marcas de tiempo de credenciales de origen exacto. Los valores almacenados, las cookies, las huellas digitales, la configuración de proxy, los nombres de usuario, las contraseñas y los secretos TOTP nunca entran en el contexto del modelo. Selecciona un perfil READY por UUID; los nombres no se adivinan. Cargar un perfil es de solo lectura a menos que persist_profile se haya planificado explícitamente. Con la persistencia, Steel crea o actualiza el perfil al liberar la sesión; puede estar UPLOADING antes de pasar a READY. Un perfil existente no puede tener dos escritores persistentes a la vez a través de este MCP. El inicio de sesión gestionado usa el espacio de nombres de origen exacto devuelto y puede enviar automáticamente un formulario coincidente.

STEEL_PROFILE=browse|scrape selecciona el ajuste predefinido de herramientas de este servidor y no está relacionado con los perfiles de navegador guardados. El descubrimiento de perfiles, la persistencia, las credenciales, los proxies y la asistencia con CAPTCHA son funciones de Steel Cloud; los despliegues autoalojados devuelven un resultado que nombra la capacidad no admitida.

Observar y tomar el control

En un host que admita MCP Apps — entre ellos Claude — steel_session_create muestra el navegador en ejecución en línea dentro de la conversación. Los fotogramas se pintan en un canvas a partir de la screencast CDP de la propia sesión. Tomar el control adquiere una concesión exclusiva renovable antes de que los clics, la escritura o el desplazamiento regresen a la página, de modo que el agente y una persona no puedan manejar el navegador a la vez. Devolver el control restaura la propiedad. Durante un steel_session_handoff, acepta después la solicitud de transferencia pendiente; el agente entonces vuelve a leer la página antes de continuar. Los hosts de chat dimensionan una vista en línea para una tarjeta en lugar de un navegador, así que la vista solicita la altura que su página necesita y ofrece Pantalla completa — en un host que lo permita; el control se elimina a sí mismo en uno que no lo haga.

steel_session_handoff invoca ese flujo para información sensible, revisión, escritura manual, archivos locales o siempre que pidas tomar el control. Los muros de inicio de sesión y los CAPTCHA pueden invocarlo automáticamente. La herramienta responde input_required, espera la devolución del control y verifica la página actual antes de que el agente continúe. Los clientes con obtención de URL abren el reproductor externo de Steel cuando no hay una aplicación en línea disponible.

Cuando se abre una entrada de archivo remota mientras controlas el visor en línea, Elegir archivo local abre un selector local de confianza. Tras la confirmación, hasta 5 MB viajan por el socket del navegador con ámbito de sesión directamente a esa página. El modelo y el servidor MCP no reciben ni la ruta local ni los bytes del archivo, y el archivo no se almacena en la API persistente de Files de Steel. Un cliente que no pueda renderizar el visor en línea informa de que la subida local no está disponible, en lugar de fingir que puede leer tu máquina.

Para un navegador que ya ha terminado, pide explícitamente verlo o reproducirlo y pasa su UUID del panel de Steel a steel_session_replay, u omite el UUID para seleccionar la última sesión liberada. Esta versión devuelve un enlace saneado al panel de Steel. La reproducción en línea de sesiones finalizadas está deshabilitada hasta que su recurso de navegador pueda alojarse de forma inmutable sin aumentar el payload de MCP Apps.

Inicio rápido

Claude para macOS o Windows

Compila la extensión de escritorio y ábrela — Claude la instala y te pide tu clave de API de Steel. No hay nada más que configurar, y no se necesita ninguna instalación de Node propia en tiempo de ejecución.

git clone https://github.com/steel-dev/steel-mcp-server.git
cd steel-mcp-server
npm install
npm run pack:mcpb
open "build/steel-mcp-$(node -p 'require("./package.json").version').mcpb"    # Windows: double-click it

Al reemplazar un paquete instalado, sal por completo de Claude y vuelve a abrirlo cuando el instalador termine; luego inicia una conversación nueva para que Claude lea el nuevo catálogo de herramientas en lugar de reutilizar uno anterior.

Steel Cloud

Necesitas Node.js 20 o superior y una clave de API de Steel. Todavía no está publicado en npm, así que instálalo desde el código fuente:

git clone https://github.com/steel-dev/steel-mcp-server.git
cd steel-mcp-server
npm install

npm install también compila el servidor. Para usarlo con Claude Desktop en macOS, añade esto a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "steel": {
      "command": "node",
      "args": ["/absolute/path/to/steel-mcp-server/dist/stdio.js"],
      "env": {
        "STEEL_API_KEY": "<your-steel-api-key>"
      }
    }
  }
}

O con Claude Code:

claude mcp add steel -e STEEL_API_KEY=your-steel-api-key -- node "$PWD/dist/stdio.js"

steel-browser autoalojado

Ejecuta la imagen de steel-browser y luego apunta el servidor a ella. No se necesita ni se envía ninguna clave de API:

{
  "mcpServers": {
    "steel": {
      "command": "node",
      "args": ["/absolute/path/to/steel-mcp-server/dist/stdio.js"],
      "env": {
        "STEEL_LOCAL": "true"
      }
    }
  }
}

Para Claude Code, ejecuta esto desde el directorio clonado steel-mcp-server:

claude mcp add steel -e STEEL_LOCAL=true -- node "$PWD/dist/stdio.js"

Steel autoalojado ejecuta una sesión de navegador a la vez. No admite proxies gestionados por Steel, perfiles de navegador, credenciales gestionadas ni resolución de CAPTCHA. El servidor devuelve una explicación específica si una herramienta solicita una de esas funciones exclusivas de la nube.

Configuración

Los registros son JSON estructurado en stderr; stdout no transporta nada más que JSON-RPC.

La continuidad de la sesión está limitada tanto por la inactividad como por el inmutable expires_at. Un visor visible por sí solo no reserva una sesión. El traspaso explícito suspende la reclamación local por inactividad solo hasta el vencimiento máximo, y la entrada real de un humano en el navegador reinicia el reloj de inactividad de Steel. Libere las sesiones terminadas con prontitud.

Ejecutar el endpoint alojado

El punto de entrada alojado necesita dos paquetes que una instalación predeterminada omite deliberadamente, para que un usuario de escritorio o de npx no tenga que cargar con la pila alojada:

npm install ioredis @modelcontextprotocol/node
# and, only if you want OTLP tracing:
npm install @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-http

Se declaran como peerDependencies opcionales. Una copia del código fuente ya tiene los cuatro, y la imagen Docker los instala por sí misma.

node dist/hosted.js (o npm run start:hosted) sirve las mismas herramientas mediante Streamable HTTP en POST /mcp. Cada llamada aporta su propia clave de Steel, como cabecera Authorization: Bearer o como parámetro de consulta ?apiKey= para los hosts que no pueden establecer cabeceras; un identificador emitido por una solicitud solo puede usarlo la credencial que lo emitió. GET /healthz responde a una sonda del balanceador de carga sin consultar la lista de hosts permitidos. GET y DELETE en /mcp responden 405, como exige la especificación del 2026-07-28.

El servidor nunca guarda una clave de Steel propia, por lo que es tarea de un despliegue autohospedado terminar TLS delante de él. Los registros alojados son JSON estructurado en stdout, y las credenciales se redactan antes de que lleguen a ellos.

docker-compose.yaml despliega ese endpoint en cualquier host de compose, incluido Coolify:

STEEL_ALLOWED_HOSTS=mcp.example.com docker compose up -d --wait

Construye la imagen desde este repositorio y especifica dist/hosted.js como comando, porque el comando predeterminado de la propia imagen es el servidor stdio — que no vincula ningún puerto, por lo que una plataforma que no pueda anular el comando desplegaría un contenedor que nunca llega a estar sano. Apunte el proxy al puerto 8080 en lugar del que tenga por defecto, y establezca STEEL_ALLOWED_HOSTS al nombre de host público al que el proxy reenvía: cualquier otro Host se rechaza, mientras que /healthz responde en cualquier caso, de modo que una sonda dirigida a una IP sigue pasando.

Conexión de un cliente a él

Claude Code habla Streamable HTTP por sí mismo:

claude mcp add steel --transport http https://mcp.example.com/mcp \
  --header "Authorization: Bearer $STEEL_API_KEY"

Claude Desktop no. Su claude_desktop_config.json lanza un programa y habla JSON-RPC a través de stdin y stdout de ese programa, por lo que un endpoint remoto necesita un puente local:

{
  "mcpServers": {
    "steel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.38",
        "https://mcp.example.com/mcp",
        "--header",
        "Authorization:${STEEL_AUTH_HEADER}"
      ],
      "env": { "STEEL_AUTH_HEADER": "Bearer <your-steel-api-key>" }
    }
  }
}

Dos detalles en ese fragmento parecen errores y no lo son. La cabecera no tiene espacio después de los dos puntos, y la credencial está en env en lugar de en línea, porque algunos hosts no escapan un espacio dentro de args y estropean el valor. Prefiera una cabecera al parámetro de consulta ?apiKey= siempre que el cliente pueda establecerla: la opción de consulta está ahí para los clientes que no pueden, y cualquier proxy delante de este servidor registra una cadena de consulta antes de que se alcance al servidor.

Cómo obtener buenos resultados

Recurra a steel_scrape primero: la mayoría de las preguntas sobre una página terminan ahí, y no inicia ninguna sesión facturada. Solo cree una sesión cuando necesite interactuar con la página.

Para actuar sobre una página, léala con steel_snapshot. Si ya sabe lo que necesita, use steel_find con al menos uno de text, regex o role; las expresiones regulares no seguras se rechazan. Ambas herramientas asignan referencias @eN a los elementos que el servidor puede seleccionar. Los elementos sin referencia no se pueden hacer clic.

Las acciones no devuelven otra instantánea completa a menos que se la pida. En su lugar, informan de lo que ha cambiado. Si una acción dice que nada ha cambiado, tome una instantánea nueva en lugar de repetirla. steel_session_diagnostics acepta un session_id MCP en vivo, un UUID de sesión finalizada del panel de Steel, list_live: true para recuperar los identificadores activos de esta credencial, o ningún id para inspeccionar la sesión liberada más reciente. Nunca inicia un navegador. Los clics directos, el desplazamiento y la escritura realizados a través del visor en vivo viajan por CDP y pueden faltar en su cronología de trazas del agente; los recuentos ocultos se refieren solo a los registros habituales de Request/Response de red del navegador.

Para tomar el control del navegador, pida al agente que llame a steel_session_handoff; use Devolver el control cuando termine y luego acepte la solicitud de traspaso pendiente para que el agente pueda continuar. Para ver un navegador en la nube fuera de un host de MCP Apps, abra la viewer_url devuelta por steel_session_create. Las sesiones activas también aparecen en el panel de Steel.

El texto de la página está envuelto en un bloque <untrusted-page-content>. Trátelo como datos, no como instrucciones. El servidor elimina el contenido oculto y otros vectores habituales de inyección de prompt, pero no puede hacer que un sitio web arbitrario sea digno de confianza.

Desarrollo

npm run build
npm run typecheck
npm run lint
npm test               # unit + integration
npm run budget         # tools/list byte budget per profile
npm run conformance    # MCP conformance suite
npm run test:browser   # runs the inline viewer in a real Chrome
npm run test:e2e       # starts, waits for and tears down the real-browser stack

Consulte CLAUDE.md para conocer las reglas de trabajo. PLAN.md hace seguimiento de la implementación, y RESEARCH.md registra la evidencia que respalda el diseño. RELEASING.md explica qué se distribuye desde este único paquete — el paquete de escritorio, el paquete npm, la imagen de contenedor y el servicio alojado — y cómo se realiza un lanzamiento.

Solución de problemas

Un sitio devuelve 403 o muestra una página de verificación. Eso es detección de bots, no un error. El error menciona el proveedor y una cosa que probar a continuación; cambie una cosa a la vez. steel_session_diagnostics muestra lo que ocurrió.

Los proxies gestionados o la resolución de CAPTCHA fallan con un error de pago. Esos necesitan un saldo de pago verificado de 10 $ en Launch; los créditos gratuitos no cuentan.

Una referencia @eN dejó de funcionar. El error dice por qué — la página navegó, el nodo se eliminó o el elemento cambió de rol o de nombre accesible — y qué llamar para recuperarse.

Una sesión parece haber desaparecido. Steel libera una sesión después de diez minutos sin actividad, y en el límite de tiempo máximo del plan. Cree una nueva solo si necesita interactuar de nuevo. Para leer la actividad anterior, llame a steel_session_diagnostics con su UUID del panel, u omita el id para la sesión liberada más reciente.

Un clic informa de que nada ha cambiado. Probablemente hizo clic en otra cosa. Si una superposición está cubriendo el objetivo, el error la menciona; ejecute steel_act con dismiss_overlays y vuelva a intentarlo.

La extensión no se inicia con un mensaje sobre STEEL_API_KEY. La clave nunca llegó al servidor. Abra la configuración de la extensión en Claude y vuelva a introducirla; el campo es de solo escritura, por lo que uno en blanco se ve igual que uno lleno.

«Límite de concurrencia alcanzado» en steel_session_create. Su plan de Steel permite menos navegadores simultáneos de los que hay abiertos. Las sesiones que olvidó liberar cuentan: steel_session_release libera una inmediatamente, y Steel recupera las sesiones inactivas después de diez minutos.

Se solicitó el trazado pero no pudo iniciarse. El paquete de escritorio se distribuye deliberadamente sin la pila de exportadores de OpenTelemetry. El servidor registra esto una vez y funciona con normalidad; instale @opentelemetry/sdk-node y @opentelemetry/exporter-trace-otlp-http en una copia del código fuente si desea trazas.

Soporte

:.

• (`` ` (