Gologin MCP Server

Servidor MCP de GoLogin para Agentes de IA

Gestiona perfiles de navegador de GoLogin, proxies, huellas digitales, carpetas y sesiones de navegador en la nube a través de conversaciones con IA. Este servidor del Model Context Protocol (MCP) conecta tu cliente de IA con la API de GoLogin.

Inicio rápido

Necesitas Node.js 22 o superior, una cuenta activa de GoLogin y un token de API de GoLogin. Node.js 22 y 24 LTS han sido probados en macOS Apple Silicon.

1. Inicia sesión en tu cuenta de GoLogin, abre API y MCP y genera un token en la pestaña API.
2. Añade esta configuración a tu cliente MCP, reemplazando el marcador de posición del token. Combínala con cualquier configuración existente de mcpServers.

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. Reinicia o recarga la conexión MCP de tu cliente y luego pregunta: "Muéstrame mis perfiles de GoLogin".

El cliente inicia el servidor automáticamente. -y permite que npm instale el paquete sin una confirmación interactiva. Este servidor lee API_TOKEN; la variable GOLOGIN_TOKEN utilizada por otras CLI de GoLogin no es un alias aquí.

Para una verificación de inicio en la terminal, con API_TOKEN ya configurado en tu entorno:

npx -y gologin-mcp

El servidor se comunica a través de entrada/salida estándar (stdio) y espera a un cliente MCP. No abre un navegador ni proporciona un símbolo del sistema interactivo por sí mismo.

Lo que puedes hacer

• Crear, leer, actualizar, eliminar y organizar perfiles de navegador.
• Configurar proxies de perfil y actualizar huellas digitales del navegador.
• Gestionar carpetas y su membresía de perfiles.
• Leer información de la cuenta.
• Iniciar y detener perfiles de navegador en la nube de GoLogin.

El inicio en la nube devuelve una URL de conexión. Este servidor no expone herramientas de navegación de páginas, clics, relleno de formularios ni inicio local de Orbita. Para la automatización de páginas, utiliza un cliente de automatización de navegador separado o la CLI del Agente de Navegador de GoLogin.

El proceso MCP se ejecuta localmente; las solicitudes a la API de GoLogin y las sesiones de navegador en la nube requieren acceso a la red. La disponibilidad de la nube y las operaciones de la API dependen de los permisos y el plan de tu cuenta.

Herramientas

Los nombres de las herramientas se generan a partir del método HTTP y la ruta en la especificación OpenAPI de GoLogin, que el servidor carga al inicio. Lo siguiente es una selección de herramientas disponibles, no una lista fija de alias. Consulta tools/list en tu cliente MCP para conocer los nombres y esquemas de entrada actuales.

Herramienta	Descripción
get_profile_v2	Listar y buscar perfiles, con paginación y filtros de carpeta
post_profile_custom	Crear un perfil con configuraciones parciales como nombre, sistema operativo y proxy
get_profile_id	Leer un perfil por ID
put_profile_id_custom	Actualizar configuraciones seleccionadas del perfil
delete_profile	Eliminar los perfiles listados en profilesToDelete
patch_profile_proxy_many_v2	Configurar proxies para uno o más perfiles
patch_profile_fingerprints	Actualizar huellas digitales para los perfiles listados en browsersIds
get_proxy_v2	Listar proxies
get_folders	Listar carpetas
post_folders_folder	Crear una carpeta por nombre
patch_folders_folder	Añadir o eliminar perfiles de una carpeta
delete_folders_folder	Eliminar una carpeta por nombre
post_profile_id_web	Iniciar un perfil en la nube y devolver una URL de conexión
delete_profile_id_web	Detener un perfil en la nube
get_user	Leer información de la cuenta

Por ejemplo, un cliente MCP puede enviar esta solicitud tools/call para leer un perfil:

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

Los argumentos siguen el esquema de entrada de cada herramienta. Los parámetros de ruta y consulta, y los campos del cuerpo de la solicitud, se pasan como argumentos de nivel superior.

Ejemplos de indicaciones

• "Muéstrame mis perfiles de GoLogin".
• "Crea un perfil de Linux llamado 'Research'".
• "Renombra el perfil PROFILE_ID a 'Research US'".
• "Actualiza el perfil PROFILE_ID para usar estas configuraciones de proxy".
• "Actualiza la huella digital del perfil PROFILE_ID".
• "Crea una carpeta llamada 'Research' y añade el perfil PROFILE_ID a ella".
• "Inicia el perfil PROFILE_ID en la nube y dame la URL de conexión".
• "Detén la sesión en la nube del perfil PROFILE_ID".
• "Muestra la información de mi cuenta de GoLogin".

Configuración para clientes MCP

Claude Desktop

Abre Configuración > Desarrollador > Editar configuración y añade la configuración de Inicio rápido a claude_desktop_config.json. Cierra y reinicia completamente Claude Desktop, luego verifica que gologin-mcp y sus herramientas estén disponibles.

Consulta la guía oficial de configuración local de MCP para rutas de configuración y solución de problemas.

Cursor

Añade la configuración de Inicio rápido a ~/.cursor/mcp.json para tu cuenta de usuario, o a .cursor/mcp.json para un proyecto. Recarga la conexión MCP y habilita las herramientas del servidor. Mantén las configuraciones que contengan tokens de API fuera del control de versiones.

Consulta la documentación de MCP de Cursor para la configuración actual del cliente.

Otros clientes MCP

Usa un cliente que admita servidores MCP locales con stdio. Configura npx como el comando, -y y gologin-mcp como sus argumentos, y API_TOKEN en el entorno del servidor. El formato y la ubicación de la configuración dependen del cliente.

Solución de problemas

• El servidor no se conecta: verifica que Node.js y npx estén disponibles para el cliente y luego reinicia su conexión MCP. El servidor también necesita acceso a docs-download.gologin.com para cargar sus definiciones de herramientas.
• La API devuelve 401 Unauthorized: verifica el API_TOKEN pasado al servidor y la validez del token en GoLogin. Reinicia la conexión después de cambiarlo.
• Nombre de herramienta no encontrado: actualiza la lista de herramientas y usa los nombres devueltos por tools/list; nombres como list_profiles y start_browser no son alias integrados.
• El inicio en la nube falla: verifica la respuesta de la API y el acceso a la nube de tu cuenta. El inicio local de MCP no inicia Orbita en tu computadora por sí mismo.

Desarrollo

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

Para ejecutar tu compilación local con API_TOKEN ya configurado:

node dist/index.js

Antes de publicar, ejecuta:

npm run release:check

El paquete incluye solo el servidor compilado, los metadatos del paquete, el README y la licencia. La verificación de lanzamiento valida esta lista de permitidos para que el estado local, las bases de datos, las credenciales y los archivos de desarrollo no puedan incluirse como archivos adicionales. npm publish ejecuta la misma verificación automáticamente.

Lanzamientos del Registro MCP

server.json describe este servidor para el Registro MCP oficial bajo io.github.gologinapp/gologin-mcp. El paquete npm declara el mismo identificador en mcpName.

Mantén alineadas las versiones en package.json, package-lock.json y server.json. Publica primero el paquete npm verificado y luego ejecuta Publicar en el Registro MCP desde la pestaña Actions del repositorio en main. El flujo de trabajo verifica que el lanzamiento de npm contenga el identificador correcto del Registro y se autentica usando GitHub OIDC, sin un token separado del Registro. No publica en npm.

Enlaces

• GoLogin
• Documentación de la API de GoLogin
• Paquete npm
• Directorio de Glama

Licencia

MIT, copyright GoLogin.