> ## 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 Codex

> Conecte o LanderLab ao Codex usando MCP. Adicione o servidor no Codex CLI, na extensão para IDE ou no app para desktop, faça login e gerencie seus landers.

Conecte o LanderLab ao Codex usando MCP para gerenciar landing pages, leads, análises e testes A/B pelo terminal, pelo editor ou pelo app para desktop. Você adiciona o servidor do LanderLab uma única vez e faz login com sua conta do LanderLab. Não é preciso chave de API.

## O que você precisa

* Uma conta do LanderLab.
* O Codex no seu computador: o Codex CLI, a extensão do Codex para IDE ou o app do ChatGPT para desktop. Consulte a [documentação de MCP do Codex](https://developers.openai.com/codex/mcp) para ver as instruções de instalação.

<Note>
  O Codex CLI, a extensão para IDE e o app para desktop compartilham a mesma configuração de MCP. Configure o LanderLab em um deles e ele ficará disponível nos três.
</Note>

## Como conectar o LanderLab ao Codex

Escolha o cliente do Codex que você usa. A URL do servidor é a mesma em todas as opções:

```text theme={null}
https://api.landerlab.dev/mcp
```

<Tabs>
  <Tab title="Codex CLI">
    O Codex CLI é executado no seu terminal. Você adiciona o LanderLab e faz login na mesma janela.

    <Frame caption="O Codex CLI em uma sessão de terminal. Captura de tela do repositório oficial openai/codex, licença Apache 2.0.">
      <img src="https://raw.githubusercontent.com/openai/codex/a5cce8895a1400f94eb0a71771275284027fff17/.github/codex-cli-splash.png" alt="Codex CLI em execução em uma janela de terminal, mostrando o modelo, o diretório de trabalho e um prompt" lightAlt="Codex CLI em execução em uma janela de terminal, mostrando o modelo, o diretório de trabalho e um prompt" darkAlt="Codex CLI em execução em uma janela de terminal, mostrando o modelo, o diretório de trabalho e um prompt" />
    </Frame>

    <Steps>
      <Step title="Adicione o servidor do LanderLab">
        Abra o terminal e execute:

        ```bash theme={null}
        codex mcp add landerlab --url https://api.landerlab.dev/mcp
        ```

        Não é preciso chave de API nem cabeçalhos.
      </Step>

      <Step title="Faça login no LanderLab">
        Se o Codex não iniciar o login automaticamente depois de adicionar o servidor, execute:

        ```bash theme={null}
        codex mcp login 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 o login.
      </Step>
    </Steps>
  </Tab>

  <Tab title="App para desktop">
    <Steps>
      <Step title="Abra Plugins">
        Na barra lateral esquerda, clique no ícone **Customize**. A página **Plugins** será aberta.
      </Step>

      <Step title="Crie um app MCP">
        Clique em **Add** no canto superior direito e selecione **Create MCP App**.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/1gZjm1faMjRf0zI6/images/codex-app-create-mcp-app.png?fit=max&auto=format&n=1gZjm1faMjRf0zI6&q=85&s=e47f3e2673531d73c8683af8c53a0730" alt="Página Plugins do app do ChatGPT para desktop com o ícone Customize na barra lateral esquerda, o menu Add aberto e Create MCP App destacado" lightAlt="Página Plugins do app do ChatGPT para desktop com o ícone Customize na barra lateral esquerda, o menu Add aberto e Create MCP App destacado" darkAlt="Página Plugins do app do ChatGPT para desktop com o ícone Customize na barra lateral esquerda, o menu Add aberto e Create MCP App destacado" title="Codex App Create Mcp App" width="1909" height="1044" data-path="images/codex-app-create-mcp-app.png" />
        </Frame>
      </Step>

      <Step title="Insira os dados do servidor do LanderLab">
        Na janela **New Plugin**, digite `LanderLab` em **Name**. Em **Connection**, mantenha **Server URL** selecionado e cole `https://api.landerlab.dev/mcp`. Deixe **Authentication** definido como **OAuth**. Não é preciso alterar **Advanced OAuth settings**.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/1gZjm1faMjRf0zI6/images/codex-app-new-plugin.png?fit=max&auto=format&n=1gZjm1faMjRf0zI6&q=85&s=ce7f5497a4fcf87053dc9793a3aa0dfe" alt="Janela New Plugin com LanderLab como nome, a URL do servidor MCP do LanderLab, autenticação OAuth e a caixa I understand and want to continue marcada" lightAlt="Janela New Plugin com LanderLab como nome, a URL do servidor MCP do LanderLab, autenticação OAuth e a caixa I understand and want to continue marcada" darkAlt="Janela New Plugin com LanderLab como nome, a URL do servidor MCP do LanderLab, autenticação OAuth e a caixa I understand and want to continue marcada" title="Codex App New Plugin" width="613" height="762" data-path="images/codex-app-new-plugin.png" />
        </Frame>
      </Step>

      <Step title="Confirme e crie">
        Marque **I understand and want to continue** e clique em **Create**.
      </Step>

      <Step title="Faça login no LanderLab">
        Seu navegador abrirá uma página de login do LanderLab. Faça login, revise a solicitação de acesso e clique em **Authorize**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Extensão para IDE">
    <Steps>
      <Step title="Abra o config.toml">
        Na extensão do Codex para IDE, abra o menu de engrenagem e selecione **MCP settings** > **Open config.toml**. Você também pode abrir o arquivo diretamente em `~/.codex/config.toml`.
      </Step>

      <Step title="Adicione o servidor do LanderLab">
        Adicione o bloco abaixo e salve o arquivo:

        ```toml theme={null}
        [mcp_servers.landerlab]
        url = "https://api.landerlab.dev/mcp"
        ```

        Se o arquivo já tiver outros servidores, adicione este bloco abaixo deles.
      </Step>

      <Step title="Faça login no LanderLab">
        No terminal, execute:

        ```bash theme={null}
        codex mcp login landerlab
        ```

        Seu navegador abrirá uma página de login do LanderLab. Faça login, revise a solicitação de acesso e clique em **Authorize**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Verifique a conexão

Em uma sessão do Codex, digite `/mcp`. O servidor `landerlab` deve aparecer na lista de servidores ativos. No terminal, você também pode executar `codex mcp list` para verificar o status.

Depois, peça:

```text theme={null}
Liste meus espaços de trabalho do LanderLab
```

O Codex 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"
* "Defina os pesos do teste A/B como 60/40 para o lander X"

## Gerencie o acesso

Sua conexão fica ativa até você revogá-la. Para desconectar, execute `codex mcp logout landerlab` no terminal ou abra **Settings > Connected Apps** no LanderLab e revogue o acesso por lá. Para remover o servidor do Codex por completo, execute `codex mcp remove landerlab`.

## Solução de problemas

**"OAuth authorization endpoint origin does not match the authorization server origin without issuer-bound callbacks"** - Algumas versões do Codex interrompem o login do LanderLab antes de o navegador abrir. Conecte-se pela ponte `mcp-remote`, que faz o login fora do Codex. É preciso ter o [Node.js](https://nodejs.org) instalado. Substitua o bloco `landerlab` em `~/.codex/config.toml` por:

```toml theme={null}
[mcp_servers.landerlab]
command = "npx"
args = ["-y", "mcp-remote", "https://api.landerlab.dev/mcp"]
startup_timeout_sec = 60
```

Reinicie o Codex. Na primeira vez que o servidor for iniciado, seu navegador abrirá a página de login do LanderLab.

**As ferramentas do LanderLab não estão disponíveis** - Verifique se o `config.toml` é um TOML válido e usa `[mcp_servers.landerlab]`, e não `mcpServers`. Reinicie o Codex depois de qualquer alteração.

**Servidor listado, mas não autenticado** - Execute `codex mcp login landerlab` novamente. Se o navegador não abrir, copie a URL exibida no terminal e abra-a manualmente.

**401 Unauthorized** - Sua sessão expirou ou o acesso foi revogado no LanderLab. Execute `codex mcp logout landerlab` e, em seguida, `codex mcp login landerlab`.

**Servidor adicionado a um projeto, mas não carregado** - O Codex só lê o `.codex/config.toml` de um projeto se ele for confiável. Marque o projeto como confiável ou adicione o servidor ao `~/.codex/config.toml`.

**Migração da configuração com chave de API** - Remova a linha `http_headers`, `env_http_headers` ou `bearer_token_env_var` e o valor antigo de `url` do bloco `landerlab` e, em seguida, siga os passos acima.

## Relacionados

* [Conecte assistentes de IA ao LanderLab via MCP](/pt-BR/mcp/overview)
* [Conecte o LanderLab ao ChatGPT (MCP)](/pt-BR/mcp/ai-assistants/chatgpt)
* [Conecte o LanderLab MCP ao Claude Code](/pt-BR/mcp/ai-assistants/claude-code)
* [Conecte o LanderLab MCP ao Cursor](/pt-BR/mcp/ai-assistants/cursor)