> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conecte o LanderLab MCP ao Gemini CLI

> Conecte sua conta do LanderLab ao Gemini CLI usando MCP. Adicione o servidor à configuração do Gemini CLI, faça login uma única vez e gerencie landing pages, leads e análises pelo terminal.

## O que você precisa

* Uma conta do LanderLab.
* O Gemini CLI instalado no seu computador. Consulte a [documentação do Gemini CLI](https://geminicli.com/docs) para ver as instruções de instalação.

> **Observação:** este guia aborda apenas o **Gemini CLI**. No momento, o app web do Gemini em gemini.google.com não permite a conexão com servidores MCP externos.

***

## Passo 1: Abra o arquivo de configuração

O Gemini CLI armazena a configuração dos servidores MCP em um arquivo de configurações. Abra ou crie:

```text theme={null}
~/.gemini/settings.json
```

***

## Passo 2: Adicione o servidor do LanderLab

Adicione o conteúdo abaixo ao seu arquivo `settings.json`. Se o arquivo já tiver conteúdo, adicione o bloco `landerlab` dentro do objeto `mcpServers` existente.

```json theme={null}
{
  "mcpServers": {
    "landerlab": {
      "httpUrl": "https://api.landerlab.dev/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}
```

Não é preciso chave de API nem cabeçalhos.

***

## Passo 3: Faça login

Reinicie sua sessão do terminal e execute:

```text theme={null}
/mcp auth landerlab
```

Seu navegador abrirá uma página de login do LanderLab. Faça login, revise a solicitação de acesso e clique em **Authorize**. Volte ao terminal assim que ele confirmar.

***

## Verifique a conexão

Inicie uma nova sessão e peça:

```text theme={null}
List my LanderLab workspaces
```

O Gemini CLI chamará `workspaces_list` e retornará os resultados.

***

## Exemplos de prompts

* "Liste todos os meus landers e o status de publicação deles"
* "Mostre as análises do lander X dos últimos 7 dias"
* "Despublique o lander X"
* "Mostre todos os leads do espaço de trabalho 1"

***

## Solução de problemas

**As ferramentas do LanderLab não estão disponíveis** - Verifique se o JSON no seu `settings.json` é válido (sem vírgulas, chaves ou colchetes faltando). Confirme que o arquivo está salvo em `~/.gemini/settings.json` e reinicie o Gemini CLI.

**Servidor listado, mas não autenticado** - Execute `/mcp auth landerlab` novamente. Se o navegador não abrir, copie a URL exibida no terminal.

**401 Unauthorized** - Sua sessão expirou ou o acesso foi revogado no LanderLab. Execute o comando de autenticação novamente.

**Migração da configuração com chave de API** - Remova o bloco `headers` e o valor antigo de `url` e, em seguida, siga o Passo 2.
