¿Qué es un servidor MCP de navegador?
MCP es un protocolo abierto que permite a una app de IA llamar a herramientas externas al modelo. Un servidor MCP de navegador añade herramientas que abren páginas web, hacen clic, escriben y leen, para que el asistente pueda usar sitios web sin API. El servidor de Browsa ejecuta esos pasos en un navegador en la nube y no en tu equipo, así que tu navegador, tus cookies y tus contraseñas nunca se tocan, y el trabajo sigue aunque la página sea lenta.
El servidor en sí es un pequeño proceso de Node.js que tu cliente MCP inicia con npx. Cada solicitud que envía va a la API de Browsa con tu clave agt_live_.
-
Obtén una clave de API
Regístrate y copia tu clave desde Keys en el panel. Recibes 100 créditos gratis al verificar tu correo, sin tarjeta.
-
Añade el servidor a tu cliente
Claude Desktop
Abre el archivo de configuración:
~/Library/Application Support/Claude/claude_desktop_config.jsonen macOS o%APPDATA%\Claude\claude_desktop_config.jsonen Windows. Añade el servidor, guarda y reinicia Claude Desktop.{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }Claude Code
Añádelo desde la terminal. Pon el nombre del servidor antes de
-e; todo lo que va después de--es el comando que ejecuta Claude Code.claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcpEjecuta
claude mcp listpara comprobar que se conectó.Cursor
Añade el mismo bloque a
~/.cursor/mcp.jsonpara todos los proyectos, o a.cursor/mcp.jsonen un solo proyecto.{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }VS Code
VS Code lee
.vscode/mcp.jsonen tu espacio de trabajo. Su formato usaserversen lugar demcpServers. Esta versión pide la clave la primera vez que se inicia el servidor, así que la clave no queda guardada en el archivo.{ "inputs": [ { "type": "promptString", "id": "browsa-api-key", "description": "Browsa API key (agt_live_...)", "password": true } ], "servers": { "browsa": { "type": "stdio", "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "${input:browsa-api-key}" } } } }Cline, Continue, Zed y otros clientes
Funciona cualquier cliente que inicie servidores MCP por stdio. Apúntalo a
npx -y @browsa/mcpy defineBROWSA_API_KEYen el entorno del servidor. -
Pruébalo
Pide a tu asistente algo que necesite una página web en vivo, por ejemplo:
- "Ve a news.ycombinator.com y dime cuál es la noticia principal."
- "Abre books.toscrape.com y enumera los cinco primeros libros con sus precios."
- "Cada mañana, revisa el precio en esta página de producto y envía el resultado a mi webhook."
El asistente llama a
run_task. El resultado llega con unlive_url: ábrelo para ver el navegador y toma el control si una página necesita a una persona.
¿Qué modelo ejecuta la tarea en el navegador?
El agente de navegador necesita un modelo de lenguaje. No hace falta poner una clave de modelo en la configuración. En cada llamada, gana la primera coincidencia:
llm: "browsa"en la llamadaEl modelo alojado de Browsa, sin clave, 5 créditos extra por tarea.BROWSA_LLM_API_KEYTu clave de Anthropic, OpenAI o Google, enviada con cada tarea, cifrada mientras la tarea se ejecuta y borrada al terminar.BROWSA_LLM_KEY_IDUna clave que guardaste en el panel, por id.- Nada definidoLa clave guardada por defecto del espacio de trabajo. Sin clave guardada y sin modelo indicado, la tarea se ejecuta en el modelo alojado de Browsa y el resultado lo indica.
BROWSA_LLM define un modelo por defecto, por ejemplo anthropic:claude-sonnet-5-5. Si indicas un modelo y no hay clave disponible, la herramienta devuelve LLM_KEY_REQUIRED en vez de pasar a otro modelo.
¿Qué herramientas obtiene el asistente?
run_task- Ejecuta una tarea de navegador descrita en lenguaje natural y devuelve el resultado y un enlace de vista en vivo.
get_job- Consulta una tarea larga, con espera opcional en el servidor.
cancel_job- Cancela una tarea en curso.
respond_to_job- Responde a una tarea que se detuvo para pedir información.
list_job_files- Lista los archivos que escribió una tarea, como informes descargados.
create_schedule,list_schedules- Tareas recurrentes, de cada hora a cada 30 días.
list_webhooks,create_webhook,delete_webhook- Dónde se entregan los resultados, como webhooks firmados con HMAC.
list_identities- Identidades persistentes cuyos logins guardados puede reutilizar una tarea.
list_llm_keys- Claves de modelo guardadas, enmascaradas. Nunca devuelve un secreto.
credits- Saldo de créditos y paquetes.
¿Cuánto cuesta?
El servidor MCP es gratis. Cada run_task es una tarea de agente que se cobra en créditos: su tiempo de navegador (1 crédito por cada bloque de 12 minutos iniciado), más 1 crédito, más 1 crédito por cada 5 pasos. El modelo alojado de Browsa suma 5 créditos.
| Tarea (termina en menos de 12 minutos) | Tu propia clave de modelo | Modelo alojado de Browsa |
|---|---|---|
| 10 pasos | 4 créditos | 9 créditos |
| 20 pasos | 6 créditos | 11 créditos |
A una tarea que falla se le devuelve el cargo del navegador y no se le cobran los pasos. Con tu propia clave, tu proveedor de modelos te cobra los tokens; Browsa no añade recargo. Un crédito cuesta $0.10 con el paquete Starter de $20. Todos los precios.
Solución de problemas
El servidor no aparece
Reinicia el cliente después de editar su configuración, comprueba que el JSON sea válido y ejecuta node --version en una terminal: el servidor necesita Node.js 18 o posterior y npx en el PATH que usa el cliente.
LLM_KEY_REQUIRED
Indicaste un modelo, pero no hay clave disponible para él. Guarda una clave en dashboard/llm-keys, define BROWSA_LLM_API_KEY o pide llm: "browsa".
402 INSUFFICIENT_CREDIT o BUDGET_REACHED
El saldo es demasiado bajo o alcanzaste tu límite de gasto mensual. Pide al asistente que use la herramienta credits, o revisa la página de créditos del panel.
Preguntas
¿El navegador se ejecuta en mi equipo?
No. El servidor MCP es un pequeño proceso de Node.js en tu equipo que llama a la API de Browsa. El navegador se ejecuta en la nube de Browsa, así que no hay que instalar nada más y tu navegador nunca se toca.
¿Necesito una clave de Anthropic u OpenAI?
No. Con solo BROWSA_API_KEY definida y sin clave guardada, las tareas se ejecutan en el modelo alojado de Browsa por 5 créditos extra cada una, y el servidor lo indica en el resultado. Para usar tu propio modelo, guarda una clave de Anthropic, OpenAI o Google en el panel, o define BROWSA_LLM_API_KEY.
¿Cuánto cuesta cada solicitud?
Cada llamada a run_task es una tarea de agente: su tiempo de navegador (1 crédito por cada bloque de 12 minutos iniciado), más 1 crédito, más 1 crédito por cada 5 pasos. Una tarea de 10 pasos que termina en menos de 12 minutos cuesta 4 créditos con tu propia clave y 9 con el modelo alojado de Browsa. El servidor MCP en sí es gratis.
¿Con qué clientes MCP funciona?
Con cualquier cliente que pueda iniciar un servidor MCP local por stdio, incluidos Claude Desktop, Claude Code, Cursor, VS Code, Cline, Continue y Zed. El servidor necesita Node.js 18 o posterior para npx.