---
slug: agentes/instalar/codex
title: Conectar Codex
description: Conecte a Siglata ao Codex com um comando e entre na sua conta.
sidebar:
  order: 2
---

**Para conectar a Siglata ao [Codex](https://chatgpt.com/codex), rode `codex mcp add siglata --url https://www.siglata.com/v1/mcp` no terminal e entre na sua conta Siglata no navegador que o comando abre.** O Codex CLI, a extensão de IDE e o app desktop do ChatGPT usam o mesmo `~/.codex/config.toml`, então uma conexão vale para todos.

## Passos [#steps]

1. No terminal, rode:

   ```sh
   codex mcp add siglata --url https://www.siglata.com/v1/mcp
   ```

2. O comando abre o login no navegador. Entre na Siglata e aprove o acesso.
3. Abra uma nova sessão do Codex, ou retome a conversa. O Codex carrega os servidores MCP quando a sessão começa.

Prefere que o Codex faça isso? Cole na conversa `Configure a Siglata: https://www.siglata.com/SKILL.md`. O Codex pede aprovação para rodar o comando fora da sandbox, porque ele grava `~/.codex/config.toml` e usa a rede. Ele também salva a skill `siglata` em `.codex/skills/siglata`, na sua pasta de usuário (no Mac e no Windows), para procurar na Siglata primeiro nas próximas conversas.

As skills da Siglata chegam pela conexão (veja [Skills da Siglata](/docs/espaco-de-trabalho/empresa#catalog)).

Cada pessoa faz essa configuração. Administradores do workspace podem restringir os servidores MCP disponíveis com uma lista de permissão em `requirements.toml`. A conexão do Codex é separada da do [ChatGPT na web](/docs/agentes/instalar/chatgpt), que usa ferramentas MCP fornecidas por plugins, não o `config.toml` do Codex.

## Aprovações [#approvals]

O Codex lê as anotações das ferramentas: as de leitura, como `list`, `sql` e `document_search`, rodam sem pedir aprovação; as de escrita, como `sheet_write`, `move` e `trash`, mudam arquivos, pastas, compartilhamento ou membros, e o Codex pede aprovação antes de cada chamada. Mantenha o padrão. Não defina `default_tools_approval_mode = "approve"` para o servidor `siglata`: isso também libera as escritas sem pedir.

## Envio de arquivos [#uploads]

Para enviar um arquivo, o agente roda um `curl` que manda os bytes ao link de envio da Siglata. A sandbox padrão do Codex não tem rede, então o Codex pede aprovação para esse comando a cada envio. Aprove com **Yes, proceed**. O comando leva um token de uso único, então a opção de não perguntar de novo não vale para o próximo envio.

Para enviar sem aprovação, libere a rede da sandbox uma vez em `~/.codex/config.toml`:

```toml
[sandbox_workspace_write]
network_access = true
```

Isso libera a rede para todo comando da sandbox, não só para a Siglata.

## Pronto [#done]

A configuração termina quando seu agente se autentica na Siglata. Continue no agente e [adicione arquivos](/docs/espaco-de-trabalho/arquivos) quando precisar.

## Solução de problemas [#troubleshooting]

- **Login travado ou organização errada.** Rode `codex mcp login siglata` e escolha a organização certa.
- **Sem ferramentas.** Abra uma nova sessão. `codex mcp list` deve mostrar **siglata**.

## Perguntas frequentes [#faq]

### Preciso de um plano pago do ChatGPT para usar a Siglata no Codex?

Não. Em outubro de 2026, a OpenAI [inclui o Codex em todos os planos do ChatGPT](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan), inclusive Free e Go, com limites de uso que variam por plano.

### A conexão do Codex vale no ChatGPT na web?

Não. O ChatGPT na web usa um plugin de servidor MCP personalizado, configurado à parte. Veja [Conectar ChatGPT](/docs/agentes/instalar/chatgpt).

### Por que o Codex pede aprovação a cada envio de arquivo?

O envio roda um `curl`, e a sandbox padrão do Codex não tem rede. Aprove o comando a cada envio ou libere a rede da sandbox, como em [Envio de arquivos](#uploads).