Saltar al contenido
Browsa
  1. Guías
  2. Servidor MCP

Configura el servidor MCP de Browsa en Claude, Cursor y VS Code.

El servidor MCP de Browsa (@browsa/mcp) es un servidor de Model Context Protocol que le da a un asistente de IA un navegador real en la nube. Pides algo en lenguaje natural, un agente de navegador en Browsa hace el trabajo y el asistente recibe la respuesta con un enlace para ver el navegador en vivo.

Tiempo
Unos 2 minutos
Requisitos
Node.js 18 o posterior, una clave de API de Browsa
Paquete
@browsa/mcp en npm, MIT

¿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_.

  1. 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.

  2. Añade el servidor a tu cliente

    Claude Desktop

    Abre el archivo de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows. Añade el servidor, guarda y reinicia Claude Desktop.

    claude_desktop_config.json
    {
      "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.

    Terminal
    claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcp

    Ejecuta claude mcp list para comprobar que se conectó.

    Cursor

    Añade el mismo bloque a ~/.cursor/mcp.json para todos los proyectos, o a .cursor/mcp.json en un solo proyecto.

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "browsa": {
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": { "BROWSA_API_KEY": "agt_live_..." }
        }
      }
    }

    VS Code

    VS Code lee .vscode/mcp.json en tu espacio de trabajo. Su formato usa servers en lugar de mcpServers. Esta versión pide la clave la primera vez que se inicia el servidor, así que la clave no queda guardada en el archivo.

    .vscode/mcp.json
    {
      "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/mcp y define BROWSA_API_KEY en el entorno del servidor.

  3. 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 un live_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:

  1. llm: "browsa" en la llamadaEl modelo alojado de Browsa, sin clave, 5 créditos extra por tarea.
  2. BROWSA_LLM_API_KEYTu clave de Anthropic, OpenAI o Google, enviada con cada tarea, cifrada mientras la tarea se ejecuta y borrada al terminar.
  3. BROWSA_LLM_KEY_IDUna clave que guardaste en el panel, por id.
  4. 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 modeloModelo alojado de Browsa
10 pasos4 créditos9 créditos
20 pasos6 créditos11 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.

Próximos pasos

Dale un navegador a tu asistente.

100 créditos gratis. Sin tarjeta, sin suscripción.