Gologin MCP Server

Servidor MCP GoLogin para Agentes de IA

Gerencie perfis de navegador, proxies, impressões digitais, pastas e sessões de navegador em nuvem do GoLogin por meio de conversas com IA. Este servidor Model Context Protocol (MCP) conecta seu cliente de IA à API do GoLogin.

Início Rápido

Você precisa do Node.js 22 ou mais recente, uma conta GoLogin ativa e um token da API GoLogin. Node.js 22 e 24 LTS foram testados no macOS Apple Silicon.

1. Entre na sua conta GoLogin, abra API & MCP e gere um token na aba API.
2. Adicione esta configuração ao seu cliente MCP, substituindo o espaço reservado do token. Mescle-a em qualquer configuração mcpServers existente.

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

3. Reinicie ou recarregue a conexão MCP do seu cliente e pergunte: "Mostre-me meus perfis GoLogin."

O cliente inicia o servidor automaticamente. -y permite que o npm instale o pacote sem confirmação interativa. Este servidor lê API_TOKEN; a variável GOLOGIN_TOKEN usada por outros CLIs do GoLogin não é um alias aqui.

Para uma verificação de inicialização no terminal, com API_TOKEN já definido no seu ambiente:

npx -y gologin-mcp

O servidor se comunica por entrada/saída padrão (stdio) e aguarda um cliente MCP. Ele não abre um navegador nem fornece um prompt de comando interativo por conta própria.

O Que Você Pode Fazer

• Criar, ler, atualizar, excluir e organizar perfis de navegador.
• Configurar proxies de perfil e atualizar impressões digitais do navegador.
• Gerenciar pastas e sua associação de perfis.
• Ler informações da conta.
• Iniciar e parar perfis de navegador na nuvem do GoLogin.

A inicialização na nuvem retorna uma URL de conexão. Este servidor não expõe navegação de páginas, cliques, preenchimento de formulários ou ferramentas locais de inicialização do Orbita. Para automação de páginas, use um cliente de automação de navegador separado ou o CLI do GoLogin Agent Browser.

O processo MCP é executado localmente; solicitações à API do GoLogin e sessões de navegador em nuvem exigem acesso à rede. A disponibilidade da nuvem e as operações da API dependem das permissões e do plano da sua conta.

Ferramentas

Os nomes das ferramentas são gerados a partir do método HTTP e do caminho na especificação OpenAPI do GoLogin, que o servidor carrega na inicialização. A seguir, uma seleção de ferramentas disponíveis, não uma lista fixa de aliases. Consulte tools/list no seu cliente MCP para obter os nomes atuais e os esquemas de entrada.

Ferramenta	Descrição
get_profile_v2	Listar e pesquisar perfis, com paginação e filtros de pasta
post_profile_custom	Criar um perfil com configurações parciais, como nome, SO e proxy
get_profile_id	Ler um perfil por ID
put_profile_id_custom	Atualizar configurações selecionadas do perfil
delete_profile	Excluir os perfis listados em profilesToDelete
patch_profile_proxy_many_v2	Configurar proxies para um ou mais perfis
patch_profile_fingerprints	Atualizar impressões digitais para os perfis listados em browsersIds
get_proxy_v2	Listar proxies
get_folders	Listar pastas
post_folders_folder	Criar uma pasta por nome
patch_folders_folder	Adicionar ou remover perfis de uma pasta
delete_folders_folder	Excluir uma pasta por nome
post_profile_id_web	Iniciar um perfil na nuvem e retornar uma URL de conexão
delete_profile_id_web	Parar um perfil na nuvem
get_user	Ler informações da conta

Por exemplo, um cliente MCP pode enviar esta solicitação tools/call para ler um perfil:

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

Os argumentos seguem o esquema de entrada de cada ferramenta. Parâmetros de caminho e consulta, e campos do corpo da solicitação, são passados como argumentos de nível superior.

Exemplos de Prompts

• "Mostre-me meus perfis GoLogin."
• "Crie um perfil Linux chamado 'Research'."
• "Renomeie o perfil PROFILE_ID para 'Research US'."
• "Atualize o perfil PROFILE_ID para usar estas configurações de proxy."
• "Atualize a impressão digital do perfil PROFILE_ID."
• "Crie uma pasta chamada 'Research' e adicione o perfil PROFILE_ID a ela."
• "Inicie o perfil PROFILE_ID na nuvem e me dê a URL de conexão."
• "Pare a sessão na nuvem do perfil PROFILE_ID."
• "Mostre as informações da minha conta GoLogin."

Configuração para Clientes MCP

Claude Desktop

Abra Configurações > Desenvolvedor > Editar Config e adicione a configuração de Início Rápido a claude_desktop_config.json. Saia completamente e reinicie o Claude Desktop e verifique se gologin-mcp e suas ferramentas estão disponíveis.

Consulte o guia oficial de configuração local do MCP para caminhos de configuração e solução de problemas.

Cursor

Adicione a configuração de Início Rápido a ~/.cursor/mcp.json para sua conta de usuário, ou .cursor/mcp.json para um projeto. Recarregue a conexão MCP e habilite as ferramentas do servidor. Mantenha configurações que contenham tokens de API fora do controle de versão.

Consulte a documentação MCP do Cursor para configurações atuais do cliente.

Outros Clientes MCP

Use um cliente que suporte servidores MCP stdio locais. Configure npx como o comando, -y e gologin-mcp como seus argumentos e API_TOKEN no ambiente do servidor. O formato e o local da configuração dependem do cliente.

Solução de Problemas

• Servidor não conecta: verifique se o Node.js e npx estão disponíveis para o cliente e reinicie a conexão MCP. O servidor também precisa de acesso a docs-download.gologin.com para carregar suas definições de ferramentas.
• API retorna 401 Unauthorized: verifique o API_TOKEN passado ao servidor e a validade do token no GoLogin. Reinicie a conexão após alterá-lo.
• Nome da ferramenta não encontrado: atualize a lista de ferramentas e use os nomes retornados por tools/list; nomes como list_profiles e start_browser não são aliases integrados.
• Falha na inicialização na nuvem: verifique a resposta da API e o acesso à nuvem da sua conta. A inicialização local do MCP não inicia o Orbita no seu computador por conta própria.

Desenvolvimento

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

Para executar sua compilação local com API_TOKEN já configurado:

node dist/index.js

Antes de publicar, execute:

npm run release:check

O pacote inclui apenas o servidor compilado, metadados do pacote, README e licença. A verificação de lançamento valida esta lista de permissões para que estado local, bancos de dados, credenciais e arquivos de desenvolvimento não possam ser incluídos como arquivos extras. npm publish executa a mesma verificação automaticamente.

Lançamentos no Registro MCP

server.json descreve este servidor para o Registro MCP oficial sob io.github.gologinapp/gologin-mcp. O pacote npm declara o mesmo identificador em mcpName.

Mantenha as versões em package.json, package-lock.json e server.json alinhadas. Publique o pacote npm verificado primeiro e depois execute Publish to MCP Registry na aba Actions do repositório em main. O fluxo de trabalho verifica se o lançamento npm contém o identificador correto do Registro e autentica usando GitHub OIDC, sem um token separado do Registro. Ele não publica no npm.

Links

• GoLogin
• Documentação da API GoLogin
• Pacote npm
• Diretório Glama

Licença

MIT, direitos autorais GoLogin.