LinkedIn MCP

• Predeterminado (stdio): Comunicación estándar para servidores MCP locales
• HTTP transmisible: Para un servidor MCP basado en web
• Si no se especifica transporte, el servidor usa por defecto stdio
• Una terminal interactiva sin transporte explícito muestra un mensaje de selección

Sesión:

• --login - Abre un navegador para iniciar sesión y guardar la sesión
• --import-from-browser [BROWSER] - Reutiliza una sesión de un navegador Chromium con sesión iniciada localmente (chrome, chromium, brave, edge, arc, vivaldi, helium, yandex, whale, coccoc, opera, opera_gx, auto). La bandera simple elige auto, el navegador usado más recientemente con una sesión de LinkedIn activa.
• --auto-import / --no-auto-import - Importa una sesión de un navegador local con sesión iniciada en la primera llamada de herramienta que la necesite, antes de recurrir al inicio de sesión manual (predeterminado: activado). Se omite en Docker, detrás de un proxy y en un enlace HTTP que no sea de bucle local. En macOS, el llavero puede solicitar confirmación una vez.
• --logout - Borra la sesión almacenada
• --login-viewer - Solo Docker: muestra el navegador --login en una URL protegida por token en el puerto 6080 (consulta Autenticación)
• --user-data-dir PATH - Directorio de perfil del navegador (predeterminado: ~/.linkedin-mcp/profile). Rotar o borrar una sesión elimina este directorio y su padre, que contiene las cookies almacenadas y los perfiles derivados.
• --claim-profile-root - Toma el control de un directorio de perfil que el servidor no reclamará por sí solo, como uno cuyo padre ya contiene otros archivos. Necesario una vez por directorio.

Transporte:

• --transport {stdio,streamable-http} - Fuerza el modo de transporte (predeterminado: stdio)
• --host HOST / --port PORT / --path PATH - Dirección del servidor HTTP (predeterminados: 127.0.0.1, 8000, /mcp)

Tiempos de espera:

• --timeout MS - Tiempo de espera para una operación de página individual (predeterminado: 5000)
• --tool-timeout SECONDS - Tiempo de espera para una llamada de herramienta completa (predeterminado: 180). Auméntalo para raspados pesados, redes lentas o un navegador con arranque en frío.
• --login-timeout SECONDS - Cuánto tiempo espera el navegador de inicio de sesión a que termines de iniciar sesión (predeterminado: 1800; 0 = sin límite). --login-viewer finaliza la sesión después de 30 minutos en cualquier caso.
• --login-inline-wait SECONDS - Cuánto tiempo espera una llamada de herramienta a que finalice el inicio de sesión antes de indicar al modelo que reintente (predeterminado: 25, máximo 45; 0 = devolver de inmediato)

Navegador compartido:

• --browser-wait SECONDS - Cuánto tiempo esperar a que otro proceso del servidor entregue el navegador compartido (predeterminado: 25, máximo 45; 0 = informar ocupado de inmediato). Solo importa con varios clientes MCP ejecutándose a la vez.
• --browser-min-hold SECONDS - Tiempo mínimo que este proceso mantiene el navegador compartido antes de entregarlo (predeterminado: 20). Limitado a 3 segundos por debajo de --browser-wait, así que auméntalo junto con este. Un valor más alto significa menos reinicios del navegador pero esperas más largas para otros clientes.
• --browser-idle-timeout SECONDS - Cierra un navegador inactivo y libera el perfil después de este tiempo sin una llamada de herramienta (predeterminado: 600; 0 = mantenerlo abierto)

Navegador:

• --no-headless - Muestra la ventana del navegador (útil para depuración)
• --chrome-path PATH - Ruta a un ejecutable de Chrome/Chromium
• --proxy-server URL - Enruta el tráfico del navegador a través de un proxy, como scheme://host:port. Configúralo antes de --login; consulta Usar un proxy.

Otros:

• --log-level {DEBUG,INFO,WARNING,ERROR} - Nivel de registro (predeterminado: WARNING)

Si ya has iniciado sesión en LinkedIn en Chrome, Chromium, Brave, Edge, Arc, Vivaldi, Helium, Yandex, Naver Whale, Cốc Cốc, Opera u Opera GX, puedes omitir el paso manual de --login y reutilizar esa sesión:

# Auto-pick the most recently used browser with a live LinkedIn session
uvx mcp-server-linkedin@latest --import-from-browser
# Or target a specific browser
uvx mcp-server-linkedin@latest --import-from-browser brave

Esto lee las cookies de LinkedIn del navegador, las valida contra tu feed y las guarda en ~/.linkedin-mcp/profile/, el mismo lugar donde escribe --login. Notas:

• Con varios navegadores con sesión iniciada, se prueba primero la sesión de LinkedIn activa más reciente. Si LinkedIn la rechaza (revocada o cerrada sesión de forma remota), se prueba automáticamente la siguiente más reciente; la primera que el servidor acepte se importa. No hay mensaje para elegir. Pasa un nombre de navegador para dirigirse a uno específicamente.
• En macOS, el llavero del sistema puede solicitar permiso para acceder al Almacenamiento Seguro del navegador. Cierra primero el navegador de origen para una lectura más fiable.
• Las cookies protegidas por el cifrado vinculado a la aplicación de Chrome 127+ (v20) no se pueden descifrar sin elevación del sistema operativo; en ese caso, usa --login en su lugar.
• Las cookies importadas coinciden con el conjunto en disco de un inicio de sesión real. El servidor local las lee completas desde el perfil guardado; el puente de Docker se reduce al mismo subconjunto mínimo de autenticación que usa para una sesión normal.

Ejemplos básicos de uso:

# Run with debug logging
uvx mcp-server-linkedin@latest --log-level DEBUG

Ejemplo de modo HTTP (para clientes MCP basados en web):

uvx mcp-server-linkedin@latest --transport streamable-http --host 127.0.0.1 --port 8080 --path /mcp

Los registros del servidor en tiempo de ejecución los emite FastMCP/Uvicorn.

Las llamadas de herramienta se serializan para proteger la sesión compartida del navegador de LinkedIn, tanto dentro de un proceso de servidor como entre procesos separados. Si ejecutas varios clientes MCP a la vez, cada uno inicia su propio proceso de servidor, y solo uno de ellos usa el navegador a la vez; los demás esperan brevemente y toman el control tan pronto como termina una llamada. Un cliente que espera demasiado recibe un mensaje de "navegador ocupado" y simplemente puede reintentar. Usa --log-level DEBUG para ver los registros de espera/adquisición/liberación.

Esto cubre procesos en la misma máquina y en el mismo entorno de ejecución. No se extiende entre el host y un contenedor Docker que comparte el mismo directorio ~/.linkedin-mcp, así que no ejecutes --login o --logout en el host mientras un contenedor esté en ejecución.

Prueba con el inspector de mcp:

1. Instala y ejecuta el inspector de mcp bunx @modelcontextprotocol/inspector
2. Haz clic en la URL de token prellenada para abrir el inspector en tu navegador
3. Selecciona Streamable HTTP como Transport Type
4. Establece URL a http://localhost:8080/mcp
5. Conecta
6. Prueba las herramientas

• El perfil del navegador se almacena en ~/.linkedin-mcp/profile/
• Las descargas del navegador gestionado se guardan en caché en ~/.linkedin-mcp/patchright-browsers/
• La caché del navegador sigue creciendo: una actualización del servidor puede traer una nueva revisión de Chromium, y Patchright conserva la anterior mientras cualquier versión instalada aún la referencie. uvx mantiene un archivo por cada versión que hayas ejecutado, por lo que cada una de ellas mantiene dicha referencia y las revisiones antiguas permanecen. El servidor registra una advertencia nombrando las revisiones que conserva y cuánto espacio ocupan. Para recuperarlo, detén cada instancia del LinkedIn MCP Server, elimina ~/.linkedin-mcp/patchright-browsers/ y deja que el próximo lanzamiento descargue el navegador actual.

• Asegúrate de tener solo una sesión activa de LinkedIn a la vez
• LinkedIn puede requerir una confirmación de inicio de sesión en la aplicación móvil de LinkedIn para --login
• LinkedIn puede mostrar un desafío captcha durante el inicio de sesión. Ejecuta uvx mcp-server-linkedin@latest --login que abre un navegador donde puedes resolverlo manualmente.

• Operaciones de página que fallan (elementos no encontrados, navegación que se cuelga): aumenta el tiempo de espera de operaciones de página del navegador: --timeout 10000 o TIMEOUT=10000 (milisegundos, predeterminado 5000).
• Llamadas de herramienta completas que agotan el tiempo (por ejemplo, perfiles de varias secciones, Chromium en arranque en frío, contenedores lentos): aumenta el tiempo de espera de ejecución por herramienta: --tool-timeout 300 o TOOL_TIMEOUT=300 (segundos, predeterminado 180).
• Primera llamada de herramienta sin sesión: si un navegador local con sesión iniciada tiene una sesión activa de LinkedIn, el servidor la importa automáticamente (ver AUTO_IMPORT_FROM_BROWSER / --auto-import) en lugar de forzar un inicio de sesión manual. En macOS, el llavero puede solicitar una vez acceso a Safe Storage. Si no existe una sesión de navegador importable, se recurre a abrir una ventana de inicio de sesión y espera hasta LOGIN_INLINE_WAIT segundos (predeterminado 25, máximo 45; --login-inline-wait) para que un inicio de sesión rápido se resuelva en una llamada. Si el tiempo transcurre, la herramienta devuelve una señal pendiente y el modelo reintenta en unos 30 segundos. Ni la importación automática ni la espera en línea se aplican bajo Docker o cuando el servidor está vinculado a un host HTTP que no sea de bucle local. Crea la sesión en el host con --login, o usa el comando explícito de Docker --login --login-viewer.
• Los usuarios con conexiones lentas pueden necesitar valores más altos para cualquiera de los dos.

• Si las llamadas de herramienta responden "No valid LinkedIn session is available in Docker" en una máquina que no es un contenedor, el runtime fue mal detectado. Esto ocurrió en hosts Linux que ejecutan un daemon de Docker para servicios no relacionados. Establece LINKEDIN_MCP_CONTAINER=false para anular la detección; true fuerza lo contrario.

• Si Chrome está instalado en una ubicación no estándar, usa --chrome-path /path/to/chrome
• También se puede establecer mediante variable de entorno: CHROME_PATH=/path/to/chrome
• En macOS y Linux, el navegador debe ser al menos tan nuevo como el que abrió tu perfil por última vez, y el servidor rechaza el lanzamiento de lo contrario. (No en Windows: allí no se puede preguntar la versión de un navegador sin iniciar uno, por lo que la verificación está desactivada). Un navegador más antiguo puede descartar silenciosamente almacenes que uno más nuevo escribió, incluida la sesión guardada, y el fallo entonces parece exactamente un inicio de sesión caducado. El mensaje nombra ambas versiones. Volver al Chromium incluido después de ejecutar un Chrome más nuevo una vez es la forma habitual de cumplir esto; o ejecuta el navegador más nuevo nuevamente, cualquiera que haya sido, o ejecuta --login, que mueve la sesión almacenada a un lado e inicia sesión de nuevo con el navegador que tengas. --logout también lo borra pero descarta la sesión antigua en lugar de mantenerla recuperable, y pide confirmación en la terminal, por lo que no se puede usar desde un servidor que un cliente MCP haya iniciado.
• Solo Chrome, Chromium y Chrome for Testing se comparan de esta manera. Los forks se numeran de manera diferente (Vivaldi está en 7.x, el número de compilación de Edge está muy por debajo del de Chrome bajo el mismo major), por lo que apuntar CHROME_PATH a uno desactiva la verificación en lugar de producir un rechazo que nada podría satisfacer.

• Claude Desktop inicia el paquete inmediatamente; la configuración del navegador continúa en segundo plano
• Si el navegador Patchright Chromium aún se está descargando, reintenta la herramienta después de una breve espera
• Las descargas del navegador gestionado se comparten bajo ~/.linkedin-mcp/patchright-browsers/
• La caché del navegador sigue creciendo: Patchright conserva una revisión antigua de Chromium mientras cualquier versión instalada aún la referencie, por lo que una actualización puede dejar ambas en el disco. El servidor registra una advertencia nombrando lo que conserva. Para recuperar el espacio, detén cada instancia del LinkedIn MCP Server, elimina ~/.linkedin-mcp/patchright-browsers/ y deja que el próximo lanzamiento descargue el navegador actual.
• Windows, el paquete sale con DLL load failed while importing _greenlet: instala el Microsoft Visual C++ Redistributable, o reinstala un paquete que fije greenlet 3.5.5 o más reciente, cuyas ruedas de Windows publicadas incluyen el runtime de C++ dentro de la extensión nuevamente. Un paquete que fije greenlet 3.3.1 hasta 3.5.4 necesita MSVCP140.dll de ese redistribuible, que ni el instalador de python.org ni las compilaciones gestionadas por uv incluyen, y un greenlet compilado desde el código fuente puede necesitarlo en cualquier versión. El servidor lo nombra por sí mismo al inicio, y solo después de verificar que el cargador no puede producir esa DLL. Reportado como greenlet#525, corregido en greenlet#526.

• Asegúrate de tener solo una sesión activa de LinkedIn a la vez
• LinkedIn puede requerir una confirmación de inicio de sesión en la aplicación móvil de LinkedIn para --login
• LinkedIn puede mostrar un desafío captcha durante el inicio de sesión. Ejecuta uvx mcp-server-linkedin@latest --login que abre un navegador donde puedes resolver captchas manualmente. Consulta la configuración de uvx para los requisitos previos.

• Operaciones de página que fallan (elementos no encontrados, navegación que se cuelga): aumenta el tiempo de espera de operaciones de página del navegador: --timeout 10000 o TIMEOUT=10000 (milisegundos, predeterminado 5000).
• Llamadas de herramienta completas que agotan el tiempo (por ejemplo, perfiles de varias secciones, Chromium en arranque en frío, contenedores lentos): aumenta el tiempo de espera de ejecución por herramienta: --tool-timeout 300 o TOOL_TIMEOUT=300 (segundos, predeterminado 180).
• Primera llamada de herramienta sin sesión: si un navegador local con sesión iniciada tiene una sesión activa de LinkedIn, el servidor la importa automáticamente (ver AUTO_IMPORT_FROM_BROWSER / --auto-import) en lugar de forzar un inicio de sesión manual. En macOS, el llavero puede solicitar una vez acceso a Safe Storage. Si no existe una sesión de navegador importable, se recurre a abrir una ventana de inicio de sesión y espera hasta LOGIN_INLINE_WAIT segundos (predeterminado 25, máximo 45; --login-inline-wait) para que un inicio de sesión rápido se resuelva en una llamada. Si el tiempo transcurre, la herramienta devuelve una señal pendiente y el modelo reintenta en unos 30 segundos. Ni la importación automática ni la espera en línea se aplican bajo Docker o cuando el servidor está vinculado a un host HTTP que no sea de bucle local. Crea la sesión en el host con --login, o usa el comando explícito de Docker --login --login-viewer.
• Los usuarios con conexiones lentas pueden necesitar valores más altos para cualquiera de los dos.

• Si las llamadas de herramienta responden "No valid LinkedIn session is available in Docker" en una máquina que no es un contenedor, el runtime fue mal detectado. Esto ocurrió en hosts Linux que ejecutan un daemon de Docker para servicios no relacionados. Establece LINKEDIN_MCP_CONTAINER=false para anular la detección; true fuerza lo contrario.

Sesión:

• --login - Abre un navegador para iniciar sesión y guardar la sesión
• --import-from-browser [BROWSER] - Reutiliza una sesión de un navegador Chromium con sesión iniciada localmente (chrome, chromium, brave, edge, arc, vivaldi, helium, yandex, whale, coccoc, opera, opera_gx, auto). La bandera simple elige auto, el navegador usado más recientemente con una sesión activa de LinkedIn.
• --auto-import / --no-auto-import - Importa una sesión de un navegador local con sesión iniciada en la primera llamada de herramienta que la necesite, antes de recurrir al inicio de sesión manual (predeterminado: activado). Se omite en Docker, detrás de un proxy y en un enlace HTTP que no sea de bucle local. En macOS, el llavero puede solicitar una vez.
• --status - Verifica si la sesión almacenada es válida y luego sale
• --logout - Borra la sesión almacenada
• --user-data-dir PATH - Directorio del perfil del navegador (predeterminado: ~/.linkedin-mcp/profile). Rotar o borrar una sesión elimina este directorio y su padre, que contiene las cookies almacenadas y los perfiles derivados.
• --claim-profile-root - Toma el control de un directorio de perfil que el servidor no reclamará por sí solo, como uno cuyo padre ya contiene otros archivos. Se necesita una vez por directorio.

Transporte:

• --transport {stdio,streamable-http} - Fuerza el modo de transporte (predeterminado: stdio)
• --host HOST / --port PORT / --path PATH - Dirección del servidor HTTP (predeterminados: 127.0.0.1, 8000, /mcp)

Tiempos de espera:

• --timeout MS - Tiempo de espera para una sola operación de página (predeterminado: 5000)
• --tool-timeout SECONDS - Tiempo de espera para una llamada de herramienta completa (predeterminado: 180). Auméntalo para raspados pesados, redes lentas o un navegador de arranque en frío.
• --login-timeout SECONDS - Cuánto tiempo espera el navegador de inicio de sesión a que termines de iniciar sesión (predeterminado: 1800; 0 = sin límite). --login-viewer finaliza la sesión después de 30 minutos de todos modos.
• --login-inline-wait SECONDS - Cuánto tiempo espera una llamada de herramienta a que un inicio de sesión termine antes de decirle al modelo que reintente (predeterminado: 25, máximo 45; 0 = devolver de inmediato)

Navegador compartido:

• --browser-wait SECONDS - Cuánto tiempo esperar a que otro proceso del servidor entregue el navegador compartido (predeterminado: 25, máximo 45; 0 = informar ocupado de inmediato). Solo importa con varios clientes MCP ejecutándose a la vez.
• --browser-min-hold SECONDS - Tiempo más corto que este proceso mantiene el navegador compartido antes de entregarlo (predeterminado: 20). Se limita a 3 segundos por debajo de --browser-wait, así que auméntalo junto con ese. Un valor más alto significa menos reinicios del navegador pero esperas más largas para otros clientes.
• --browser-idle-timeout SECONDS - Cierra un navegador inactivo y libera el perfil después de este tiempo sin una llamada de herramienta (predeterminado: 600; 0 = mantenerlo abierto)

Navegador:

• --no-headless - Muestra la ventana del navegador (útil para depuración)
• --slow-mo MS - Retraso entre acciones del navegador (predeterminado: 0, útil para depuración)
• --viewport WxH - Tamaño de la ventana gráfica (predeterminado: 1280x720). Se aplica solo al modo sin ventana; un lanzamiento con ventana usa el tamaño real de la ventana.
• --chrome-path PATH - Ruta a un ejecutable de Chrome/Chromium
• --installer-temp-dir PATH - Directorio existente para archivos temporales de instalación del navegador (entorno: INSTALLER_TEMP_DIR).
• --proxy-server URL - Enruta el tráfico del navegador a través de un proxy, como scheme://host:port. Configúralo antes de --login; consulta Usar un proxy.

Otros:

• --log-level {DEBUG,INFO,WARNING,ERROR} - Nivel de registro (predeterminado: WARNING)
• --help - Muestra la ayuda

Nota: La mayoría de las opciones de CLI tienen equivalentes de variables de entorno. Consulta .env.example para más detalles.

Ejemplo de modo HTTP (para clientes MCP basados en web):

uv run -m linkedin_mcp_server --transport streamable-http --host 127.0.0.1 --port 8000 --path /mcp

Claude Desktop:

{
  "mcpServers": {
    "mcp-server-linkedin": {
      "command": "uv",
      "args": ["--directory", "/path/to/linkedin-mcp-server", "run", "-m", "linkedin_mcp_server"]
    }
  }
}

stdio se usa por defecto para esta configuración.

• Asegúrate de tener solo una sesión activa de LinkedIn a la vez
• LinkedIn puede requerir una confirmación de inicio de sesión en la aplicación móvil de LinkedIn para --login
• LinkedIn puede mostrar un desafío de captcha durante el inicio de sesión. El comando --login abre un navegador donde puedes resolverlo manualmente.

• Usa --no-headless para ver las acciones del navegador y depurar problemas de raspado
• Agrega --log-level DEBUG para ver un registro más detallado

• El perfil del navegador se almacena en ~/.linkedin-mcp/profile/
• Las descargas del navegador administrado se almacenan en caché en ~/.linkedin-mcp/patchright-browsers/, compartido con las instalaciones de uvx y MCP Bundle
• La caché del navegador sigue creciendo: Patchright mantiene una revisión antigua de Chromium mientras cualquier versión instalada aún la referencie, y un archivo uv o un segundo árbol de trabajo es una referencia de ese tipo. El servidor registra una advertencia nombrando lo que contiene. Para recuperar el espacio, detén cada instancia del LinkedIn MCP Server, elimina ~/.linkedin-mcp/patchright-browsers/ y deja que el próximo lanzamiento descargue el navegador actual.
• Usa --logout para borrar el perfil y comenzar de nuevo

• Verifica la versión de Python: python --version (debe ser 3.12.4+)
• Reinstala Patchright: uv run patchright install chromium
• Reinstala las dependencias: uv sync --reinstall

• Operaciones de página que fallan (elementos no encontrados, navegación que se cuelga): aumenta el tiempo de espera de operación de página del navegador: --timeout 10000 o TIMEOUT=10000 (milisegundos, predeterminado 5000).
• Llamadas de herramienta completas que agotan el tiempo (por ejemplo, perfiles de varias secciones, Chromium de arranque en frío, contenedores lentos): aumenta el tiempo de espera de ejecución por herramienta: --tool-timeout 300 o TOOL_TIMEOUT=300 (segundos, predeterminado 180).
• Primera llamada de herramienta sin sesión: si un navegador con sesión iniciada localmente tiene una sesión activa de LinkedIn, el servidor la importa automáticamente (consulta AUTO_IMPORT_FROM_BROWSER / --auto-import) en lugar de forzar un inicio de sesión manual. En macOS, el llavero puede solicitar una vez el acceso a Safe Storage. Si no existe una sesión de navegador importable, recurre a abrir una ventana de inicio de sesión y espera hasta LOGIN_INLINE_WAIT segundos (predeterminado 25, máximo 45; --login-inline-wait) para que un inicio de sesión rápido se resuelva en una llamada. Si la espera transcurre, la herramienta devuelve una señal pendiente y el modelo reintenta en unos 30 segundos. Ni la importación automática ni la espera en línea se aplican bajo Docker o cuando el servidor está vinculado a un host HTTP que no sea de bucle local. Crea la sesión en el host con --login, o usa el comando explícito de Docker --login --login-viewer.
• Los usuarios con conexiones lentas pueden necesitar valores más altos para cualquiera de los dos.

• Si las llamadas de herramienta responden "No valid LinkedIn session is available in Docker" en una máquina que no es un contenedor, el entorno de ejecución se detectó incorrectamente. Esto sucedió en hosts Linux que ejecutan un daemon de Docker para servicios no relacionados. Configura LINKEDIN_MCP_CONTAINER=false para anular la detección; true fuerza lo contrario.

• Si Chrome está instalado en una ubicación no estándar, usa --chrome-path /path/to/chrome
• También se puede configurar mediante variable de entorno: CHROME_PATH=/path/to/chrome
• En macOS y Linux, el navegador debe ser al menos tan nuevo como el que abrió tu perfil por última vez, y el servidor rechaza el lanzamiento de lo contrario. (No en Windows: a un navegador allí no se le puede preguntar su versión sin iniciar uno, por lo que la verificación está desactivada). Un navegador más antiguo puede descartar silenciosamente almacenes que uno más nuevo escribió, incluida la sesión guardada, y el fallo entonces se ve exactamente como un inicio de sesión caducado. El mensaje nombra ambas versiones. Volver al Chromium incluido después de ejecutar un Chrome más nuevo una vez es la forma habitual de cumplir esto; o ejecuta el navegador más nuevo nuevamente, cualquiera que haya sido, o ejecuta --login, que mueve la sesión almacenada a un lado e inicia sesión de nuevo con el navegador que tienes. --logout también lo borra pero descarta la sesión antigua en lugar de mantenerla recuperable, y pide confirmación en la terminal, por lo que no se puede usar desde un servidor que un cliente MCP inició.
• Solo Chrome, Chromium y Chrome for Testing se comparan de esta manera. Los forks se numeran de manera diferente (Vivaldi está en 7.x, el número de compilación de Edge está muy por debajo del de Chrome bajo el mismo mayor), por lo que apuntar CHROME_PATH a uno desactiva la verificación en lugar de producir un rechazo que nada podría satisfacer.