LinkedIn MCP

• Padrão (stdio): Comunicação padrão para servidores MCP locais
• HTTP Streamable: Para um servidor MCP baseado na web
• Se nenhum transporte for especificado, o servidor usa o padrão stdio
• Um terminal interativo sem transporte explícito mostra um prompt de seleção

Sessão:

• --login - Abre um navegador para fazer login e salvar a sessão
• --import-from-browser [BROWSER] - Reutiliza uma sessão de um navegador Chromium com login local (chrome, chromium, brave, edge, arc, vivaldi, helium, yandex, whale, coccoc, opera, opera_gx, auto). A flag simples escolhe auto, o navegador usado mais recentemente com uma sessão ativa do LinkedIn.
• --auto-import / --no-auto-import - Importa uma sessão de um navegador local com login na primeira chamada de ferramenta que precisar de uma, antes de recorrer ao login manual (padrão: ativado). Ignorado no Docker, atrás de proxy e em um bind HTTP não-loopback. No macOS, o keychain pode solicitar uma vez.
• --logout - Limpa a sessão armazenada
• --login-viewer - Somente Docker: mostra o navegador --login em uma URL protegida por token na porta 6080 (veja Autenticação)
• --user-data-dir PATH - Diretório do perfil do navegador (padrão: ~/.linkedin-mcp/profile). Rotacionar ou limpar uma sessão exclui este diretório e seu pai, que contém os cookies armazenados e perfis derivados.
• --claim-profile-root - Assume um diretório de perfil que o servidor não reivindicará por conta própria, como um cujo pai já contém outros arquivos. Necessário uma vez por diretório.

Transporte:

• --transport {stdio,streamable-http} - Força o modo de transporte (padrão: stdio)
• --host HOST / --port PORT / --path PATH - Endereço do servidor HTTP (padrões: 127.0.0.1, 8000, /mcp)

Timeouts:

• --timeout MS - Timeout para uma única operação de página (padrão: 5000)
• --tool-timeout SECONDS - Timeout para uma chamada de ferramenta inteira (padrão: 180). Aumente para raspagens pesadas, redes lentas ou navegador com inicialização a frio.
• --login-timeout SECONDS - Quanto tempo o navegador de login espera você terminar de entrar (padrão: 1800; 0 = sem limite). --login-viewer encerra a sessão após 30 minutos de qualquer forma.
• --login-inline-wait SECONDS - Quanto tempo uma chamada de ferramenta espera um login terminar antes de dizer ao modelo para tentar novamente (padrão: 25, máx. 45; 0 = retornar imediatamente)

Navegador compartilhado:

• --browser-wait SECONDS - Quanto tempo esperar outro processo de servidor entregar o navegador compartilhado (padrão: 25, máx. 45; 0 = reportar ocupado imediatamente). Só importa com vários clientes MCP rodando ao mesmo tempo.
• --browser-min-hold SECONDS - Tempo mínimo que este processo mantém o navegador compartilhado antes de entregá-lo (padrão: 20). Limitado a 3 segundos abaixo de --browser-wait, então aumente esse junto. Maior significa menos reinicializações do navegador, mas esperas mais longas para outros clientes.
• --browser-idle-timeout SECONDS - Fecha um navegador ocioso e libera o perfil após esse tempo sem uma chamada de ferramenta (padrão: 600; 0 = mantém aberto)

Navegador:

• --no-headless - Mostra a janela do navegador (útil para depuração)
• --chrome-path PATH - Caminho para um executável Chrome/Chromium
• --proxy-server URL - Roteia o tráfego do navegador por um proxy, como scheme://host:port. Configure antes de --login; veja Usando um proxy.

Outros:

• --log-level {DEBUG,INFO,WARNING,ERROR} - Nível de registro (padrão: WARNING)

Se você já está conectado ao LinkedIn no Chrome, Chromium, Brave, Edge, Arc, Vivaldi, Helium, Yandex, Naver Whale, Cốc Cốc, Opera ou Opera GX, você pode pular a etapa manual de --login e reutilizar essa sessão:

# 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

Isso lê os cookies do LinkedIn do navegador, valida-os contra seu feed e os salva em ~/.linkedin-mcp/profile/, o mesmo lugar onde --login grava. Notas:

• Com vários navegadores conectados, a sessão ativa do LinkedIn usada mais recentemente é tentada primeiro. Se o LinkedIn a rejeitar (revogada ou desconectada remotamente), a próxima mais recente é tentada automaticamente; a primeira que o servidor aceitar é importada. Não há prompt para escolher. Passe um nome de navegador para direcionar um especificamente.
• No macOS, o keychain do sistema pode solicitar permissão para acessar o Safe Storage do navegador. Feche o navegador de origem primeiro para a leitura mais confiável.
• Cookies protegidos pela criptografia vinculada ao aplicativo do Chrome 127+ (v20) não podem ser descriptografados sem elevação do SO; nesse caso, use --login em vez disso.
• Cookies importados correspondem ao conjunto em disco de um login real. O servidor local os lê de volta integralmente do perfil salvo; a ponte Docker reduz ao mesmo subconjunto mínimo de autenticação que usa para uma sessão normal.

Exemplos básicos de uso:

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

Exemplo de modo HTTP (para clientes MCP baseados na web):

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

Os logs do servidor em tempo de execução são emitidos pelo FastMCP/Uvicorn.

As chamadas de ferramenta são serializadas para proteger a sessão compartilhada do navegador do LinkedIn, tanto dentro de um único processo de servidor quanto entre processos separados. Se você executar vários clientes MCP ao mesmo tempo, cada um inicia seu próprio processo de servidor, e apenas um deles usa o navegador por vez; os outros esperam brevemente e assumem assim que ele termina uma chamada. Um cliente que espera demais recebe uma mensagem de "navegador ocupado" e pode simplesmente tentar novamente. Use --log-level DEBUG para ver os logs de espera/aquisição/liberação.

Isso cobre processos na mesma máquina e no mesmo runtime. Não se estende entre o host e um contêiner Docker compartilhando o mesmo diretório ~/.linkedin-mcp, então não execute --login ou --logout no host enquanto um contêiner estiver em execução.

Teste com o mcp inspector:

1. Instale e execute o mcp inspector bunx @modelcontextprotocol/inspector
2. Clique na URL de token pré-preenchida para abrir o inspector no seu navegador
3. Selecione Streamable HTTP como Transport Type
4. Defina URL para http://localhost:8080/mcp
5. Conecte
6. Teste as ferramentas

• O perfil do navegador é armazenado em ~/.linkedin-mcp/profile/
• Os downloads do navegador gerenciado são armazenados em cache em ~/.linkedin-mcp/patchright-browsers/
• O cache do navegador continua crescendo: uma atualização do servidor pode trazer uma nova revisão do Chromium, e o Patchright mantém a antiga enquanto qualquer versão instalada ainda a referenciar. O uvx mantém um arquivo por versão que você já executou, então cada uma delas mantém essa referência e as revisões antigas permanecem. O servidor registra um aviso nomeando as revisões que está mantendo e quanto espaço elas ocupam. Para recuperar esse espaço, pare todas as instâncias do LinkedIn MCP Server, exclua ~/.linkedin-mcp/patchright-browsers/ e deixe a próxima inicialização baixar o navegador atual.

• Certifique-se de ter apenas uma sessão ativa do LinkedIn por vez
• O LinkedIn pode exigir uma confirmação de login no aplicativo móvel do LinkedIn para --login
• O LinkedIn pode exibir um desafio de captcha durante o login. Execute uvx mcp-server-linkedin@latest --login, que abre um navegador onde você pode resolvê-lo manualmente.

• Operações de página falhando (elementos não encontrados, navegação travada): aumente o tempo limite de operação da página do navegador: --timeout 10000 ou TIMEOUT=10000 (milissegundos, padrão 5000).
• Chamadas de ferramenta inteiras expirando (por exemplo, perfis com várias seções, Chromium em inicialização a frio, contêineres lentos): aumente o tempo limite de execução por ferramenta: --tool-timeout 300 ou TOOL_TIMEOUT=300 (segundos, padrão 180).
• Primeira chamada de ferramenta sem sessão: se um navegador com login local tiver uma sessão ativa do LinkedIn, o servidor a importa automaticamente (veja AUTO_IMPORT_FROM_BROWSER / --auto-import) em vez de forçar um login manual. No macOS, o chaveiro pode solicitar uma vez o acesso ao Safe Storage. Se não existir uma sessão de navegador importável, ele volta a abrir uma janela de login e aguarda até LOGIN_INLINE_WAIT segundos (padrão 25, máximo 45; --login-inline-wait) para que um login rápido seja resolvido em uma chamada. Se o tempo expirar, a ferramenta retorna um sinal de pendência e o modelo tenta novamente em cerca de 30 segundos. Nem a importação automática nem a espera inline se aplicam no Docker ou quando o servidor está vinculado a um host HTTP que não seja de loopback. Crie a sessão no host com --login, ou use o comando explícito do Docker --login --login-viewer.
• Usuários em conexões lentas podem precisar de valores maiores para qualquer um deles.

• Se as chamadas de ferramenta responderem "No valid LinkedIn session is available in Docker" em uma máquina que não é um contêiner, o runtime foi detectado incorretamente. Isso aconteceu em hosts Linux executando um daemon Docker para serviços não relacionados. Defina LINKEDIN_MCP_CONTAINER=false para substituir a detecção; true força o oposto.

• Se o Chrome estiver instalado em um local não padrão, use --chrome-path /path/to/chrome
• Também pode ser definido via variável de ambiente: CHROME_PATH=/path/to/chrome
• No macOS e Linux, o navegador deve ser pelo menos tão novo quanto aquele que abriu seu perfil pela última vez, e o servidor recusa a inicialização caso contrário. (Não no Windows: um navegador lá não pode ter sua versão consultada sem iniciar um, então a verificação está desativada.) Um navegador mais antigo pode silenciosamente descartar stores que um mais novo escreveu, incluindo a sessão salva, e a falha então parece exatamente um login expirado. A mensagem nomeia ambas as versões. Voltar ao Chromium incluído após executar um Chrome mais novo uma vez é a maneira usual de atender a isso; execute o navegador mais novo novamente, seja qual for, ou execute --login, que move a sessão armazenada para o lado e faz login do zero com o navegador que você tem. O --logout também limpa, mas descarta a sessão antiga em vez de mantê-la recuperável, e pede confirmação no terminal, então não é utilizável a partir de um servidor iniciado por um cliente MCP.
• Apenas Chrome, Chromium e Chrome for Testing são comparados dessa forma. Forks numeram-se de maneira diferente (Vivaldi está na 7.x, o número de build do Edge fica muito abaixo do Chrome sob o mesmo major), então apontar CHROME_PATH para um deles desativa a verificação em vez de produzir uma recusa que nada poderia satisfazer.

• O Claude Desktop inicia o bundle imediatamente; a configuração do navegador continua em segundo plano
• Se o navegador Patchright Chromium ainda estiver baixando, tente a ferramenta novamente após uma breve espera
• Os downloads do navegador gerenciado são compartilhados em ~/.linkedin-mcp/patchright-browsers/
• O cache do navegador continua crescendo: o Patchright mantém uma revisão antiga do Chromium enquanto qualquer versão instalada ainda a referenciar, então uma atualização pode deixar ambas no disco. O servidor registra um aviso nomeando o que mantém. Para recuperar o espaço, pare todas as instâncias do LinkedIn MCP Server, exclua ~/.linkedin-mcp/patchright-browsers/ e deixe a próxima inicialização baixar o navegador atual.
• Windows, o bundle sai com DLL load failed while importing _greenlet: instale o Microsoft Visual C++ Redistributable, ou reinstale um bundle fixando greenlet 3.5.5 ou mais recente, cujas wheels publicadas para Windows incluem o runtime C++ dentro da extensão novamente. Um bundle fixando greenlet 3.3.1 até 3.5.4 precisa de MSVCP140.dll desse redistribuível, que nem o instalador do python.org nem os builds gerenciados pelo uv incluem, e um greenlet compilado a partir do código-fonte pode precisar dele em qualquer versão. O servidor nomeia isso por conta própria na inicialização, e somente após verificar que o carregador não pode produzir essa DLL. Relatado como greenlet#525, corrigido em greenlet#526.

• Certifique-se de ter apenas uma sessão ativa do LinkedIn por vez
• O LinkedIn pode exigir uma confirmação de login no aplicativo móvel do LinkedIn para --login
• O LinkedIn pode exibir um desafio de captcha durante o login. Execute uvx mcp-server-linkedin@latest --login, que abre um navegador onde você pode resolver captchas manualmente. Veja a configuração do uvx para pré-requisitos.

• Operações de página falhando (elementos não encontrados, navegação travada): aumente o tempo limite de operação da página do navegador: --timeout 10000 ou TIMEOUT=10000 (milissegundos, padrão 5000).
• Chamadas de ferramenta inteiras expirando (por exemplo, perfis com várias seções, Chromium em inicialização a frio, contêineres lentos): aumente o tempo limite de execução por ferramenta: --tool-timeout 300 ou TOOL_TIMEOUT=300 (segundos, padrão 180).
• Primeira chamada de ferramenta sem sessão: se um navegador com login local tiver uma sessão ativa do LinkedIn, o servidor a importa automaticamente (veja AUTO_IMPORT_FROM_BROWSER / --auto-import) em vez de forçar um login manual. No macOS, o chaveiro pode solicitar uma vez o acesso ao Safe Storage. Se não existir uma sessão de navegador importável, ele volta a abrir uma janela de login e aguarda até LOGIN_INLINE_WAIT segundos (padrão 25, máximo 45; --login-inline-wait) para que um login rápido seja resolvido em uma chamada. Se o tempo expirar, a ferramenta retorna um sinal de pendência e o modelo tenta novamente em cerca de 30 segundos. Nem a importação automática nem a espera inline se aplicam no Docker ou quando o servidor está vinculado a um host HTTP que não seja de loopback. Crie a sessão no host com --login, ou use o comando explícito do Docker --login --login-viewer.
• Usuários em conexões lentas podem precisar de valores maiores para qualquer um deles.

• Se as chamadas de ferramenta responderem "No valid LinkedIn session is available in Docker" em uma máquina que não é um contêiner, o runtime foi detectado incorretamente. Isso aconteceu em hosts Linux executando um daemon Docker para serviços não relacionados. Defina LINKEDIN_MCP_CONTAINER=false para substituir a detecção; true força o oposto.

Sessão:

• --login - Abra um navegador para fazer login e salvar a sessão
• --import-from-browser [BROWSER] - Reutilize uma sessão de um navegador Chromium com login local (chrome, chromium, brave, edge, arc, vivaldi, helium, yandex, whale, coccoc, opera, opera_gx, auto). A flag simples escolhe auto, o navegador usado mais recentemente com uma sessão ativa do LinkedIn.
• --auto-import / --no-auto-import - Importe uma sessão de um navegador local com login na primeira chamada de ferramenta que precisar, antes de cair no login manual (padrão: ativado). Ignorado no Docker, atrás de um proxy e em um bind HTTP não-loopback. No macOS, o keychain pode solicitar uma vez.
• --status - Verifique se a sessão armazenada é válida e saia
• --logout - Limpe a sessão armazenada
• --user-data-dir PATH - Diretório do perfil do navegador (padrão: ~/.linkedin-mcp/profile). Rotacionar ou limpar uma sessão exclui este diretório e seu pai, que contém os cookies armazenados e os perfis derivados.
• --claim-profile-root - Assuma um diretório de perfil que o servidor não reivindicará por conta própria, como um cujo pai já contém outros arquivos. Necessário uma vez por diretório.

Transporte:

• --transport {stdio,streamable-http} - Force o modo de transporte (padrão: stdio)
• --host HOST / --port PORT / --path PATH - Endereço do servidor HTTP (padrões: 127.0.0.1, 8000, /mcp)

Timeouts:

• --timeout MS - Timeout para uma única operação de página (padrão: 5000)
• --tool-timeout SECONDS - Timeout para uma chamada de ferramenta inteira (padrão: 180). Aumente para raspagens pesadas, redes lentas ou navegador com inicialização a frio.
• --login-timeout SECONDS - Quanto tempo o navegador de login espera você terminar de entrar (padrão: 1800; 0 = sem limite). --login-viewer encerra a sessão após 30 minutos de qualquer forma.
• --login-inline-wait SECONDS - Quanto tempo uma chamada de ferramenta espera um login terminar antes de dizer ao modelo para tentar novamente (padrão: 25, máx. 45; 0 = retornar imediatamente)

Navegador compartilhado:

• --browser-wait SECONDS - Quanto tempo esperar outro processo de servidor entregar o navegador compartilhado (padrão: 25, máx. 45; 0 = reportar ocupado imediatamente). Só importa com vários clientes MCP rodando ao mesmo tempo.
• --browser-min-hold SECONDS - Tempo mínimo que este processo mantém o navegador compartilhado antes de entregá-lo (padrão: 20). Limitado a 3 segundos abaixo de --browser-wait, então aumente esse junto. Maior significa menos reinicializações do navegador, mas esperas mais longas para outros clientes.
• --browser-idle-timeout SECONDS - Feche um navegador ocioso e libere o perfil após esse tempo sem uma chamada de ferramenta (padrão: 600; 0 = manter aberto)

Navegador:

• --no-headless - Mostre a janela do navegador (útil para depuração)
• --slow-mo MS - Atraso entre ações do navegador (padrão: 0, útil para depuração)
• --viewport WxH - Tamanho do viewport (padrão: 1280x720). Aplica-se apenas ao modo sem janela; uma inicialização com janela usa o tamanho real da janela.
• --chrome-path PATH - Caminho para um executável Chrome/Chromium
• --installer-temp-dir PATH - Diretório existente para arquivos temporários de instalação do navegador (ambiente: INSTALLER_TEMP_DIR).
• --proxy-server URL - Roteie o tráfego do navegador por um proxy, como scheme://host:port. Configure-o antes de --login; veja Usando um proxy.

Outros:

• --log-level {DEBUG,INFO,WARNING,ERROR} - Nível de registro (padrão: WARNING)
• --help - Mostre ajuda

Nota: A maioria das opções de CLI tem equivalentes em variáveis de ambiente. Veja .env.example para detalhes.

Exemplo de Modo HTTP (para clientes MCP baseados na 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 é usado por padrão para esta configuração.

• Certifique-se de ter apenas uma sessão ativa do LinkedIn por vez
• O LinkedIn pode exigir uma confirmação de login no aplicativo móvel do LinkedIn para --login
• O LinkedIn pode mostrar um desafio de captcha durante o login. O comando --login abre um navegador onde você pode resolvê-lo manualmente.

• Use --no-headless para ver as ações do navegador e depurar problemas de raspagem
• Adicione --log-level DEBUG para ver registros mais detalhados

• O perfil do navegador é armazenado em ~/.linkedin-mcp/profile/
• Os downloads do navegador gerenciado são armazenados em cache em ~/.linkedin-mcp/patchright-browsers/, compartilhados com as instalações do uvx e do MCP Bundle
• O cache do navegador continua crescendo: o Patchright mantém uma revisão antiga do Chromium enquanto qualquer versão instalada ainda a referenciar, e um arquivo uv ou um segundo worktree é essa referência. O servidor registra um aviso nomeando o que ele mantém. Para recuperar o espaço, pare todas as instâncias do LinkedIn MCP Server, exclua ~/.linkedin-mcp/patchright-browsers/ e deixe a próxima inicialização baixar o navegador atual.
• Use --logout para limpar o perfil e começar do zero

• Verifique a versão do Python: python --version (deve ser 3.12.4+)
• Reinstale o Patchright: uv run patchright install chromium
• Reinstale as dependências: uv sync --reinstall

• Operações de página falhando (elementos não encontrados, navegação travada): aumente o timeout de operação de página do navegador: --timeout 10000 ou TIMEOUT=10000 (milissegundos, padrão 5000).
• Chamadas de ferramenta inteiras expirando (ex.: perfis de várias seções, Chromium com inicialização a frio, contêineres lentos): aumente o timeout de execução por ferramenta: --tool-timeout 300 ou TOOL_TIMEOUT=300 (segundos, padrão 180).
• Primeira chamada de ferramenta sem sessão: se um navegador com login local tiver uma sessão ativa do LinkedIn, o servidor a importa automaticamente (veja AUTO_IMPORT_FROM_BROWSER / --auto-import) em vez de forçar um login manual. No macOS, o keychain pode solicitar uma vez para acesso ao Safe Storage. Se não existir uma sessão de navegador importável, ele cai em abrir uma janela de login e espera até LOGIN_INLINE_WAIT segundos (padrão 25, máx. 45; --login-inline-wait) para que um login rápido seja resolvido em uma chamada. Se a espera expirar, a ferramenta retorna um sinal pendente e o modelo tenta novamente em cerca de 30 segundos. Nem a importação automática nem a espera inline se aplicam no Docker ou quando o servidor está vinculado a um host HTTP não-loopback. Crie a sessão no host com --login, ou use o comando Docker explícito --login --login-viewer.
• Usuários em conexões lentas podem precisar de valores maiores para qualquer um.

• Se as chamadas de ferramenta responderem "No valid LinkedIn session is available in Docker" em uma máquina que não é um contêiner, o runtime foi detectado incorretamente. Isso aconteceu em hosts Linux executando um daemon Docker para serviços não relacionados. Defina LINKEDIN_MCP_CONTAINER=false para substituir a detecção; true força o oposto.

• Se o Chrome estiver instalado em um local não padrão, use --chrome-path /path/to/chrome
• Também pode ser definido via variável de ambiente: CHROME_PATH=/path/to/chrome
• No macOS e Linux, o navegador deve ser pelo menos tão novo quanto o que abriu seu perfil pela última vez, e o servidor recusa a inicialização caso contrário. (Não no Windows: um navegador lá não pode ter sua versão consultada sem iniciar um, então a verificação está desligada.) Um navegador mais antigo pode silenciosamente descartar stores que um mais novo escreveu, incluindo a sessão salva, e a falha então parece exatamente um login expirado. A mensagem nomeia ambas as versões. Voltar ao Chromium empacotado depois de executar um Chrome mais novo uma vez é a maneira usual de atender a isso; ou execute o navegador mais novo novamente, seja qual for, ou execute --login, que move a sessão armazenada para o lado e faz login do zero com o navegador que você tem. --logout também limpa, mas descarta a sessão antiga em vez de mantê-la recuperável, e pede confirmação no terminal, então não é utilizável de um servidor que um cliente MCP iniciou.
• Apenas Chrome, Chromium e Chrome for Testing são comparados dessa forma. Forks se numeram de maneira diferente (Vivaldi está em 7.x, o número de build do Edge fica muito abaixo do Chrome sob o mesmo major), então apontar CHROME_PATH para um deles desliga a verificação em vez de produzir uma recusa que nada poderia satisfazer.