Conectar un agente de IA a un perfil de Dolphin {anty} mediante chrome-devtools-mcp

Información general 📜

Con chrome-devtools-mcp puedes dejar un perfil de navegador de Dolphin{anty} bajo el control de un agente de IA: Claude Code, Cursor o cualquier otro cliente MCP. El agente podrá abrir páginas, hacer clic, rellenar formularios, leer el contenido y tomar capturas de pantalla por sí mismo.

Hay un detalle: no basta con indicar el puerto una sola vez en la configuración de MCP. Cuando un perfil se inicia mediante la API con el parámetro automation=1, Dolphin{anty} le asigna cada vez un puerto aleatorio nuevo. Por eso el cliente MCP no ejecuta chrome-devtools-mcp directamente, sino un pequeño script wrapper que primero encuentra el puerto actual y luego se lo pasa.

Cómo encuentra el script el puerto:

• El perfil ya está abierto en modo de automatización → el script toma el puerto del archivo de servicio del perfil
• El perfil está cerrado → el script lo inicia mediante la API y toma el puerto de la respuesta

Después, chrome-devtools-mcp se conecta al perfil y el agente puede trabajar con él.

Qué necesitas ✅

1. Un plan de pago de Dolphin{anty}. En el plan Free la automatización no está disponible, la solicitud de inicio devuelve el error 402
2. Dolphin{anty} en ejecución y con la sesión iniciada. Puedes iniciar sesión de la forma habitual o con un token de API
3. Node.js 18 o posterior (sirve cualquier versión LTS). Puedes descargarlo en nodejs.org
4. Un cliente MCP que pueda ejecutar servidores locales (stdio): Claude Code, Cursor, VS Code, Windsurf, Claude Desktop y otros
5. El ID del perfil que quieres conectar. Aparece en la esquina superior derecha de la ventana de edición del perfil en Dolphin{anty}

Paso 1. Guardar el script wrapper 💾

El script es el mismo para todos los sistemas: macOS, Windows y Linux.

1. Crear una carpeta permanente para el script, por ejemplo ~/mcp/ en macOS y Linux o C:\mcp\ en Windows
2. Crear en ella el archivo dolphin-devtools-mcp.mjs
3. Pegar el código de abajo en el archivo y guardarlo

Qué hace el script:

1. Busca el archivo DevToolsActivePort en la carpeta del perfil. Si el archivo existe y el puerto responde, usa ese puerto
2. Si no, inicia el perfil con la solicitud GET http://127.0.0.1:3001/v1.0/browser_profiles/<ID>/start?automation=1 y toma el puerto del campo automation.port de la respuesta
3. Ejecuta chrome-devtools-mcp con ese puerto. Las opciones --no-usage-statistics y --no-performance-crux desactivan el envío de estadísticas y direcciones de páginas a Google

Los perfiles de Dolphin{anty} se guardan aquí (el script encuentra la carpeta solo, esto es solo de referencia):

~/Library/Application Support/dolphin_anty/browser_profiles/<ID>/data_dir/

%APPDATA%\dolphin_anty\browser_profiles\<ID>\data_dir\

~/.config/dolphin_anty/browser_profiles/<ID>/data_dir/

Paso 2. Conectar el servidor al cliente MCP 🔌

Cada perfil se conecta como un servidor MCP independiente con su propio nombre.

claude mcp add dolphin-123456789 -- node /Users/USERNAME/mcp/dolphin-devtools-mcp.mjs 123456789

claude mcp add dolphin-123456789 --scope user -- node /Users/USERNAME/mcp/dolphin-devtools-mcp.mjs 123456789

{
  "mcpServers": {
    "dolphin-123456789": {
      "command": "node",
      "args": ["/Users/USERNAME/mcp/dolphin-devtools-mcp.mjs", "123456789"]
    }
  }
}

"args": ["C:\\mcp\\dolphin-devtools-mcp.mjs", "123456789"]

Paso 3. Comprobar la conexión 🔍

Si todo está bien configurado, el perfil se abre solo al iniciarse el cliente MCP y el agente ve sus pestañas.

1. Cerrar el perfil en Dolphin{anty} si está abierto
2. Reiniciar el cliente MCP o empezar una nueva sesión: los servidores se conectan al arrancar. La primera vez tarda más de lo normal porque chrome-devtools-mcp se descarga de internet
3. Comprobar el estado del servidor. En Claude Code se usa el comando claude mcp list, el servidor debe aparecer como Connected. En otros clientes, el estado se ve en la configuración de MCP
4. Pedir al agente: "Muestra la lista de pestañas abiertas". El agente llamará a la herramienta list_pages y mostrará las pestañas del perfil

Seguridad y limitaciones 🛡️

• El perfil se abre al iniciarse el cliente MCP, no al enviar una petición al agente. Si eso molesta, el servidor se puede activar solo mientras se trabaja. En Claude Code se elimina con claude mcp remove dolphin-123456789
• Después del trabajo, el perfil sigue abierto junto con el puerto de depuración. El puerto solo es accesible desde este equipo, pero los programas locales pueden conectarse a él. Hay que cerrar el perfil en Dolphin{anty} o enviar GET http://127.0.0.1:3001/v1.0/browser_profiles/123456789/stop
• La opción --autoConnect no funciona con Dolphin{anty}. Busca la carpeta de Chrome normal, mientras que los perfiles de Dolphin{anty} se guardan en otro lugar