Conectar Codex

Conecte a Siglata ao Codex com um comando e entre na sua conta.

Para conectar a Siglata ao 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

1. No terminal, rode:

   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).

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, que usa ferramentas MCP fornecidas por plugins, não o config.toml do Codex.

Aprovações

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

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:

[sandbox_workspace_write]
network_access = true

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

Pronto

A configuração termina quando seu agente se autentica na Siglata. Continue no agente e adicione arquivos quando precisar.

Solução de problemas

• 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

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, 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.

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.