GeeLark MCP: Guia de Configuração e 7 Casos de Uso
Compartilhar
Conheça o GeeLark MCP Server. Agora você pode conectar o GeeLark a agentes de IA como Codex, Claude e Cursor. Basta dizer à IA o que você quer fazer e ela ajudará a gerenciar seus celulares na nuvem, perfis de navegador ou a configurar tarefas de automação.
Este guia explica o que o GeeLark MCP faz e como conectá-lo ao seu agente de IA. Também vou compartilhar exemplos reais de como usar a IA para gerenciar celulares na nuvem e automatizar tarefas do dia a dia.
O que é o GeeLark MCP
O GeeLark MCP permite que agentes de IA como Codex, Claude e Cursor utilizem a API do GeeLark para interagir com seus celulares na nuvem, perfis de navegador e outros recursos.
Ele utiliza o Model Context Protocol (MCP), um padrão aberto que conecta ferramentas de IA a outros serviços. Assim que você conecta o GeeLark e o autoriza com um token de API, pode orientar sua IA em linguagem natural. Em seguida, a IA chama as ferramentas do GeeLark necessárias para realizar a tarefa.
Confira o que o GeeLark MCP suporta:
| Categoria | O que você pode fazer |
| Cloud phones | Buscar, criar, editar, iniciar, parar, duplicar e excluir celulares na nuvem. Verificar o status dos dispositivos e capturar telas. |
| Celulares na nuvem | Criar, gerenciar e abrir perfis de navegador, capturar telas e agendar tarefas de automação de navegador. |
| Proxies | Adicionar, visualizar, editar, excluir e testar proxies. |
| Grupos | Criar, visualizar, editar e excluir grupos para organizar os dispositivos por projeto. |
| Tags | Criar, visualizar, editar e excluir tags, além de atribuí-las aos celulares na nuvem. |
| Automação | Criar e agendar tarefas de automação, verificar o histórico de tarefas, cancelar ou executar novamente tarefas e usar modelos suportados de automação para redes sociais. |
| Apps e arquivos | Instalar e remover aplicativos, gerenciar apps em múltiplos dispositivos, enviar arquivos e gerenciar conteúdos na biblioteca do GeeLark. |
| Faturamento e planos | Consulte seu saldo, suas transações e os detalhes do seu plano. Utilize as opções disponíveis para renovar ou fazer upgrade do plano e comprar tempo de uso dos celulares na nuvem. |
Antes de se conectar ao GeeLark MCP
Antes de começar, você precisará de:
- Uma conta paga do GeeLark: Certifique-se de que seu plano inclui acesso à API (Base ou Pro).
- Token da API do GeeLark: Você pode encontrá-lo no GeeHub, dentro do aplicativo do GeeLark.
- Um agente de IA com suporte a MCP: Por exemplo, Codex, Claude, Cursor ou outro agente de IA.
No GeeHub, verifique se o status da Conexão da API está exibindo “Ativo“. Em seguida, localize a variável GEELARK_TOKEN nas configurações do MCP. Você precisará desse token na hora de configurar a conexão.
Mantenha-o privado. Não cole seu token no chat.
Como Conectar ao GeeLark MCP
Configurando o GeeLark MCP com auxílio da IA
A maneira mais simples é abrir seu agente de IA e enviar a seguinte instrução:
Ajude-me a conectar o GeeLark MCP Server ao agente de IA que estou usando. Considere que sou iniciante no assunto e me guie no passo a passo da configuração, uma etapa por vez.
Comece lendo a documentação oficial do GeeLark
https://github.com/GeeLark/geelark-cli/#use-as-mcp-server
Gostaria que você me ajudasse da seguinte forma:
1. Vá passo a passo. Não me envie uma lista longa de comandos ou arquivos de configuração logo de início. Explique apenas a próxima etapa, aguarde eu concluir e use uma linguagem simples.
2. Faça o máximo possível da configuração por mim. Primeiro, verifique meu computador e escolha o método de instalação mais adequado. Se você puder realizar alterações no meu computador, peça minha permissão antes de instalar programas ou alterar configurações. Caso não consiga, me diga exatamente onde clicar e o que digitar.
3. Me ajude a inserir o token do GeeLark localmente. No aplicativo do GeeLark, acesse GeeHub → API → MCP. Procure por GEELARK_TOKEN. Mostre-me como inseri-lo no meu computador. Não me peça para colar meu token real neste chat.
4. Siga a documentação oficial. Não tente adivinhar configurações nem use servidores MCP de terceiros. Se não conseguir acessar a documentação, peça para eu colar o trecho correspondente.
5. Teste a conexão. Quando terminar a configuração, verifique se o GeeLark MCP está funcionando tentando buscar a minha lista de celulares na nuvem.
O mais importante: não me envie todo o processo de configuração de uma vez só. Passe apenas a primeira etapa por enquanto.
Depois disso, basta seguir as instruções do seu agente de IA para concluir a instalação.
Configurando o GeeLark MCP manualmente
Se você já tem experiência na configuração de servidores MCP, pode adicionar o GeeLark MCP diretamente à sua ferramenta de IA.
Claude Code/Cursor/Trae
Abra o arquivo de configuração de MCP da sua ferramenta de IA. Por exemplo:
- Cursor: \~/.cursor/mcp.json
- Trae: \~/.trae/mcp/mcp.json
- Claude Code: Você pode adicionar o servidor usando o comando “claude mcp add”.
Para ferramentas que utilizam arquivos de configuração em JSON, você pode tomar este exemplo como base:
{
“mcpServers”: {
“geelark”: {
“command”: “npx”,
“args”: [“-y”, “geelark-cli@latest”, “mcp”],
“env”: {
“GEELARK_TOKEN”: “SEU_GEELARK_TOKEN”
}
}
}
}
Substitua SEU_GEELARK_TOKEN pelo token obtido em GeeHub → MCP no aplicativo do GeeLark.
Essa configuração executa o GeeLark MCP via npx, portanto seu computador precisará ter um ambiente Node.js funcional instalado.
O GeeLark também aceita duas configurações opcionais:
- GEELARK_BASE_URL: O endereço da API do GeeLark. O padrão é https://openapi.geelark.com.
- GEELARK_BROWSER_BASE_URL: O endereço da API local do navegador. O padrão é http://localhost:40185.
Se você não precisa de endereços personalizados, pode omitir essas variáveis.
Se já tiver a geelark-cli instalada, pode iniciar o servidor com o comando geelark-cli mcp em vez de usar o npx.
Para conferir mais opções de configuração, consulte a documentação oficial do GeeLark MCP.
Codex
Abra o arquivo de configuração do Codex localizado em \~/.codex/config.toml. Adicione o exemplo correspondente ao seu sistema operacional.
Windows:
[mcp_servers.geelark]
command = “cmd.exe”
args = [“/d”, “/c”, “npx”, “-y”, “geelark-cli@latest”, “mcp”]
[mcp_servers.geelark.env]
GEELARK_TOKEN = “YOUR_GEELARK_TOKEN”
macOS / Linux:
[mcp_servers.geelark]
command = “npx”
args = [“-y”, “geelark-cli@latest”, “mcp”]
[mcp_servers.geelark.env]
GEELARK_TOKEN = “YOUR_GEELARK_TOKEN”
Substitua SEU_GEELARK_TOKEN pelo token obtido em GeeHub → MCP.
Salve o arquivo e reinicie o Codex. Agora você já pode testar o uso do GeeLark MCP.
Nota: Seu computador precisa conseguir executar o npx para essa configuração funcionar. Se a conexão falhar, peça ao seu agente de IA para verificar a instalação no seu computador e as configurações do MCP.
Teste sua Conexão
Após concluir a configuração, envie este comando simples para testar a conexão:
Quantos celulares na nuvem eu tenho no GeeLark?
Se a conexão estiver funcionando corretamente, sua IA usará o GeeLark MCP para contar seus celulares na nuvem.
Compare esse número com o que aparece no aplicativo do GeeLark. Se forem iguais, está tudo pronto.
Prepare sua IA para usar o GeeLark MCP
Diferentes agentes e modelos de IA podem interpretar instruções e utilizar ferramentas de formas distintas. Depois que você conecta o MCP, a IA geralmente consegue visualizar as ferramentas disponíveis. No entanto, ela pode não saber de imediato como combiná-las para concluir uma tarefa inteira.
Em meus testes, o processo fluiu muito melhor quando pedi primeiro para a IA entender o que o GeeLark MCP era capaz de fazer. Dessa forma, não precisei memorizar comandos de API nem nomes exatos de ferramentas. Pude descrever o trabalho em linguagem natural.
Comece enviando esta instrução:
I’ve connected GeeLark MCP to my AI agent.
Before we start, please check the GeeLark MCP tools available to you. Understand what each tool does, how to use it, and any important limitations.
I’ll describe what I want to do in everyday language, without knowing the exact tool names or API commands. Please figure out which GeeLark tools to use and how to combine them when a task requires multiple steps.
Only use tools that are actually available. Don’t guess what GeeLark MCP can do. Ask me questions only when important information is missing, and get my confirmation before making changes.
For now, don’t perform any actions. Just give me a short overview of what you can help me do, along with five practical examples.
Once that’s done, you can ask the AI to find certain cloud phones, organize devices by project, or schedule automation tasks. It can choose from the GeeLark MCP tools that are actually available.
Conectei o GeeLark MCP ao meu agente de IA.
Antes de começarmos, por favor, verifique as ferramentas do GeeLark MCP disponíveis para você. Entenda o que cada ferramenta faz, como usá-la e quais são suas limitações importantes.
Vou descrever o que preciso fazer em linguagem natural, sem saber os nomes exatos das ferramentas ou comandos de API. Por favor, identifique quais ferramentas do GeeLark usar e como combiná-las quando uma tarefa exigir várias etapas.
Use apenas as ferramentas que estiverem realmente disponíveis. Não tente adivinhar o que o GeeLark MCP pode fazer. Faça perguntas apenas quando faltarem informações essenciais e peça minha confirmação antes de realizar alterações.
Por enquanto, não execute nenhuma ação. Apenas me dê um breve resumo do que você pode me ajudar a fazer, acompanhado de cinco exemplos práticos.
Depois disso, você pode pedir à IA para buscar determinados celulares na nuvem, organizar dispositivos por projeto ou agendar tarefas de automação. Ela escolherá entre as ferramentas do GeeLark MCP que estiverem de fato disponíveis.
Casos de uso do GeeLark MCP
O GeeLark MCP vai muito além de pedir à IA para clicar em botões. Ele ajuda a conectar a busca de dispositivos, a organização de informações e a execução de ações em um único fluxo de trabalho. Confira a seguir sete exemplos práticos. Você pode copiar as instruções e substituir o texto entre [colchetes] pelos seus próprios dados.
Casos de uso do GeeLark MCP
O GeeLark MCP vai muito além de pedir à IA para clicar em botões. Ele ajuda a conectar a busca de dispositivos, a organização de informações e a execução de ações em um único fluxo de trabalho. Confira a seguir sete exemplos práticos. Você pode copiar as instruções e substituir o texto entre [colchetes] pelos seus próprios dados.
Configurar celulares na nuvem
Suponha que você precise de 10 celulares na nuvem rodando Android 13–16. Você quer marcas e modelos variados, além de cinco proxies dos EUA escolhidos entre os que você já salvou no GeeLark. Cada celular também deve ter uma localização GPS correspondente ao proxy atribuído a ele.
Fazer isso manualmente significa verificar as versões de Android disponíveis, modelos, proxies e localizações, para só então configurar os aparelhos. Com o GeeLark MCP, você pode pedir à IA que verifique a disponibilidade, elabore um plano e crie os celulares após a sua aprovação.
Um detalhe importante aqui: a verificação de um proxy pode mostrar o país, o estado e a cidade do seu endereço IP, mas não as coordenadas exatas de GPS. A IA deve buscar coordenadas confiáveis em vez de inventá-las. Além disso, se você distribuir cinco proxies entre 10 celulares, alguns proxies serão compartilhados. Revise o plano antes de criar os celulares.
Prompt:
Crie [10] celulares na nuvem com Android [13–16] e modelos variados disponíveis. Escolha [5] proxies dos EUA funcionando da minha lista salva e atribua-os entre os celulares. Configure o GPS de cada celular para coincidir com a localização detectada do IP do proxy, usando coordenadas verificadas.
2. Analisar seus celulares na nuvem
Quando você gerencia dezenas ou centenas de celulares na nuvem, é fácil perder o controle da distribuição dos seus dispositivos. Quantos usam Android 14? Quantos estão no Android 16? Quais marcas e modelos você mais utiliza?
Peça à sua IA para ler a lista de dispositivos do GeeLark, contar os celulares por versão do Android, marca e modelo, e organizar os resultados em uma tabela. É uma maneira rápida de visualizar a estrutura dos seus dispositivos sem precisar checar um por um.
Prompt:
Em [MEUS GRUPOS], quantos celulares na nuvem do GeeLark eu tenho em cada versão do Android e modelo de aparelho? Organize os resultados em uma tabela simples.
3. Limpar e organizar tags
Com o uso contínuo do GeeLark, as tags podem se acumular. Algumas podem não estar mais em uso, enquanto outras podem ter nomes quase idênticos. Peça à IA para revisar suas tags e os celulares na nuvem vinculados a elas, identificar tags sem uso e sugerir um sistema de nomenclatura mais organizado.
Prompt:
Revise as tags de [todos os meus celulares na nuvem]. Encontre tags não utilizadas, nomes semelhantes e celulares sem tag. Sugira um sistema de nomenclatura mais organizado, mas não faça alterações ainda.
4. Instalar aplicativos diferentes em vários celulares na nuvem
Digamos que você acabou de criar 50 celulares na nuvem para diferentes projetos de redes sociais. Um grupo precisa do TikTok e do Instagram. Outro precisa do TikTok, Facebook e Reddit.
Informe à IA quais aplicativos cada grupo precisa. Ela pode ligar os celulares, instalar os aplicativos e desligá-los em seguida. Você não precisará alternar entre grupos nem configurar cada instalação manualmente.
Prompt:
Acabei de criar novos celulares na nuvem no [Grupo A] e no [Grupo B], e estão todos desligados. Ligue os celulares, instale [TikTok e Instagram] no Grupo A e [TikTok, Facebook e Reddit] no Grupo B. Assim que a instalação for concluída, desligue todos os celulares e me informe os resultados.
5. Verificar e organizar seus proxies
Se você importou muitos proxies para o GeeLark, pode acabar esquecendo quais ainda estão funcionando, quais estão atribuídos a celulares e quais não estão sendo utilizados.
Peça ao GeeLark MCP para checar o status de conexão, ver quais celulares estão usando cada proxy e identificar os proxies parados. A IA também pode sugerir como agrupá-los por país ou por projeto.
Prompt:
Verifique todos os meus proxies no GeeLark. Encontre os que falharem nos testes de conexão ou que não estiverem atribuídos a um celular na nuvem. Mostre-me quais celulares estão usando cada proxy e sugira como organizá-los por [país ou projeto]. Não exclua nem altere nada ainda.
6. Aquecer contas do TikTok
Suponha que você gerencie várias contas do TikTok e queira usar o modelo de aquecimento de contas com IA para TikTok do GeeLark para agendar tarefas diárias de navegação e aquecimento.
Você pode pedir à IA para planejar as tarefas e criá-las no GeeLark. Mesmo com 100 ou 200 contas, você não precisará configurar cada tarefa manualmente.
Por exemplo, a IA pode escolher os temas de pesquisa, o tempo de visualização dos vídeos, se os comentários devem ser visualizados e as probabilidades de curtir ou salvar vídeos com base no nicho de cada conta. Ela também pode definir datas e horários diferentes para cada celular na nuvem.
Prompt:
Tenho 10 contas do TikTok no grupo [TikTok demo]. Configure três dias de tarefas para elas usando o modelo de aquecimento de contas com IA para TikTok do GeeLark. Defina para cada conta o seu próprio nicho, com tópicos de pesquisa relevantes e horários variados com base no fuso horário local. Assim que as tarefas forem criadas, mostre-me o cronograma e as configurações de cada celular.
Mas não espere que tudo saia perfeito logo na primeira instrução.
Sua IA pode não entender de início todas as configurações do modelo ou exatamente o que você quer para cada conta. Pode ser necessário esclarecer os nichos das contas, ajustar parâmetros e corrigir pequenos detalhes ao longo de algumas mensagens.
Isso exige um pequeno esforço no começo. No entanto, assim que a IA compreender suas preferências no chat atual, ela poderá reutilizar as regras combinadas para tarefas semelhantes no futuro.
Veja um exemplo de tarefas de aquecimento para TikTok que criei com o GeeLark MCP.
7. Agendar publicações no TikTok e Instagram Reels
Se você publica vídeos curtos em diversas contas do TikTok e do Instagram, a IA também pode ajudar a organizar o conteúdo e agendar as postagens.
Passe os arquivos de vídeo e alguns detalhes sobre o conteúdo para a IA. Ela pode rascunhar as legendas e, em seguida, usar o GeeLark MCP com os modelos de publicação de vídeo no TikTok e publicação de Reels no Instagram para atribuir os vídeos, preencher as legendas, definir as opções e agendar os posts.
Prompt:
Tenho vídeos prontos na pasta [pasta do seu computador]. Agende-os para as minhas contas do TikTok no [Grupo A] e contas do Instagram no [Grupo B] ao longo dos próximos [7 dias]. Faça o upload dos vídeos conforme necessário, escreva legendas adequadas para cada vídeo e plataforma, e agende as postagens em horários variados com base no fuso horário local de cada conta. Assim que tudo estiver configurado, mostre-me o cronograma de postagens e as legendas.
Dicas para usar o GeeLark MCP
Depois de passar um tempo utilizando o GeeLark MCP, reuni algumas lições práticas que podem ajudar se você estiver começando agora.
1. Deixe a IA conhecer o seu espaço de trabalho no GeeLark
Quando conectar o GeeLark MCP pela primeira vez, comece com algumas perguntas simples.
Pergunte quantos grupos você tem, quais celulares na nuvem estão em cada grupo, quais tags e proxies eles utilizam e se algum proxy é compartilhado por mais de um aparelho.
Isso fornece à IA uma visão geral do seu ambiente de trabalho. Mais tarde, quando você pedir para ela organizar dispositivos ou executar tarefas em lote, não precisará explicar tudo do zero.
2. Se a IA ficar confusa, direcione-a de volta para a documentação
A IA nem sempre entenderá o GeeLark MCP perfeitamente de primeira. Ela pode escolher a ferramenta errada, usar parâmetros incorretos ou dizer que algo não é possível quando na verdade é.
Quando isso acontecer, peço para ela revisar adocumentação oficial da CLI do GeeLark, checar as ferramentas e configurações disponíveis e tentar novamente.
Algumas tarefas também exigem mais de uma mensagem. Pode ser necessário detalhar melhor o que você quer, apontar eventuais erros e ajustar as instruções até que a IA acerte o resultado.
3. Agentes de IA diferentes podem se comportar de formas distintas
Em meus testes, duas ferramentas de IA às vezes reagiram de maneiras totalmente opostas à mesma instrução.
Por exemplo, o Codex em alguns momentos se recusou a agendar certas tarefas de automação para redes sociais, mesmo quando eu pedi apenas para configurar um modelo já existente do GeeLark.
Se isso acontecer, tente ser mais específico. Mencione o nome exato do modelo, explique quais parâmetros você precisa e confirme se deseja que a tarefa seja criada. Ainda assim, mudar a instrução nem sempre resolverá uma limitação da ferramenta de IA ou uma ação sem suporte.
Com o OpenCode e o DeepSeek V4, não enfrentei esse tipo de problema até o momento. Essa é apenas a minha experiência pessoal; vale a pena testar diferentes agentes de IA para ver qual se adapta melhor ao seu fluxo de trabalho.
4. Explore outras ferramentas MCP para automação no Android
O GeeLark MCP dá acesso principalmente aos recursos nativos do GeeLark. Se você quer que a IA interaja com a tela do Android — tocando em botões, digitando textos, deslizando ou testando aplicativos —, vale a pena conferir este projeto open-source: uiautomator2-mcp-server
Ele utiliza ADB e uiautomator2 para permitir que a IA interaja diretamente com dispositivos Android.
Lembre-se de que este é um projeto de terceiros, e não parte do servidor MCP oficial do GeeLark. Verifique os requisitos de conexão ADB e teste se ele funciona corretamente com seus celulares na nuvem do GeeLark.
5. Certifique-se de desligar os celulares na nuvem ao finalizar uma tarefa
Iniciar um celular na nuvem via GeeLark MCP é diferente de abri-lo manualmente. A IA pode iniciar e controlar o dispositivo em segundo plano, sem que uma janela do celular apareça na tela do seu computador.
Se suas instruções não forem claras ou se a IA as interpretar mal, os aparelhos podem continuar rodando após a conclusão da tarefa. Se você não notar, eles continuarão consumindo seus minutos pagos.
Para tarefas que não exigem que o celular permaneça ligado (como instalar apps ou alterar configurações do dispositivo), inclua uma instrução clara: desligue todos os celulares iniciados assim que a tarefa for concluída e confirme que estão desligados.
Isso ajuda a evitar cobranças por tempo de uso não planejado.
Comece a usar o GeeLark MCP
O maior benefício do GeeLark MCP é que a IA faz mais do que apenas explicar como usar o GeeLark: ela executa as tarefas por você.
Desde a criação de celulares na nuvem e organização de proxies até a instalação de aplicativos em lote e o agendamento de automações, você pode simplesmente descrever o que precisa e deixar a IA acionar as ferramentas certas do GeeLark.
Se você é novo no mundo do MCP, comece aos poucos. Peça à IA para contar seus celulares na nuvem ou verificar seus proxies. Assim que se sentir confortável, avance para ações em lote e automações mais complexas.
A IA nem sempre acertará de primeira. Ao fazer alterações em muitos dispositivos ou criar tarefas maiores, confira os resultados e vá aprimorando a forma como você trabalha com ela.