Conectar Codex

Instale o plugin de agente do Siglata no Codex, ou adicione a URL MCP diretamente. Cliente comprovado na v1.

Conecte o Siglata ao Codex (CLI, extensão de IDE ou modo Codex no ChatGPT desktop). O Codex é um cliente comprovado (v1).

Prefira o caminho do plugin. Ele instala skills e a conexão MCP juntos.

Pré-requisitos

Codex disponível (CLI, extensão de IDE ou ChatGPT desktop com Codex)
Acesso ao e-mail que você usa no Siglata

Passos (plugin, recomendado)

Execute estes comandos. Não é necessário npm.

codex plugin marketplace add siglata/agent-plugins
codex plugin add siglata@siglata-agent-plugins

Inicie uma nova sessão do Codex depois da instalação.
Quando solicitado, conclua o login do Siglata no navegador. Escolha a organização e aprove os escopos.
Em organizações do tier de teste, peça só escopos de leitura:

codex mcp login siglata --scopes "openid,profile,email,offline_access,organizations:read,members:read,files:read"

Peça ao Codex para usar siglata em tarefas de arquivos ou organização.

Auth sem navegador (agentes e CI)

O OAuth interativo precisa de callback em 127.0.0.1. Em um host headless, emita um access token MCP (device grant) e ligue-o ao Codex:

export SIGLATA_MCP_TOKEN=...
codex mcp add siglata --url https://www.siglata.com/v1/mcp --bearer-token-env-var SIGLATA_MCP_TOKEN

codex mcp list deve mostrar Auth Bearer token.

Detalhes do pacote estão em siglata/agent-plugins.

Passos (somente URL MCP)

Se quiser o servidor MCP sem as skills do plugin:

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

Em seguida execute codex mcp login siglata se o OAuth não iniciar sozinho. No TUI do Codex, digite /mcp para listar servidores.

O ChatGPT Desktop, a CLI do Codex e a extensão de IDE compartilham ~/.codex/config.toml. Configurar uma vez cobre essas superfícies.

`/poteto-mode` no Codex

poteto-mode é uma skill do repositório Siglata, não do pacote agent-plugins. O Codex lista essa skill quando uma destas raízes está disponível:

Skills do projeto (comum). Abra o checkout do Siglata como diretório de trabalho do Codex. O Codex lê .agents/skills/ e lista poteto-mode (e as skills principle-* irmãs).
Instalação em $CODEX_HOME. Em qualquer diretório:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo siglata/siglata --path .agents/skills/poteto-mode --ref main

Invoque /poteto-mode na sessão. Para provar sem chamar o modelo:

codex debug prompt-input "/poteto-mode"
# deve listar poteto-mode em Available skills, file: rN/poteto-mode/SKILL.md
python3 scripts/verify-codex-poteto.py   # em siglata/agent-plugins

O Codex lista o caminho e a descrição. Ele não cola o SKILL.md inteiro no prompt-input. O agente lê esse arquivo ao seguir a skill. Os princípios irmãos ficam em .agents/skills/principle-* no checkout; instale-os do mesmo modo se trabalhar fora do repositório.

Você terminou quando…

O plugin ou o servidor MCP siglata está ativado
O OAuth concluiu
/mcp (ou a lista de servidores MCP) mostra o Siglata conectado
O agente pode chamar execute e search
codex debug prompt-input "/poteto-mode" lista poteto-mode quando você precisar desse estilo

Experimente: “Use o siglata para listar os arquivos da minha organização.”

Solução de problemas

Auth ou consentimento travado. Execute codex mcp login siglata de novo com os escopos de leitura acima. Conclua o link mágico na mesma sessão do navegador quando possível. Em host headless, use o caminho com SIGLATA_MCP_TOKEN.
Consentimento rejeita *:write no tier de teste. O login padrão do Codex pede escrita. Passe a lista de --scopes só de leitura.
Organização errada. Revogue ou remova o servidor, adicione de novo e escolha a organização correta na autorização.
Plugin instalado sem ferramentas. Inicie uma nova sessão. Confirme que o plugin e o MCP estão ativados.
Configuração compartilhada. Uma mudança no ChatGPT Desktop também afeta a CLI do Codex (e o inverso).

O que o agente pode fazer

Listar e organizar arquivos e pastas, enviar e baixar dentro dos seus escopos e ajudar com membros e convites quando a sua função permitir. Detalhes: MCP.

Veja também Conectar ChatGPT Desktop se usar essa UI na mesma configuração compartilhada.

Voltar para Conectar.

Para agentes

Preferido:

codex plugin marketplace add siglata/agent-plugins
codex plugin add siglata@siglata-agent-plugins
codex mcp login siglata --scopes "openid,profile,email,offline_access,organizations:read,members:read,files:read"

Somente MCP:

codex mcp add siglata --url https://www.siglata.com/v1/mcp
codex mcp login siglata --scopes "openid,profile,email,offline_access,organizations:read,members:read,files:read"

Headless:

export SIGLATA_MCP_TOKEN=...
codex mcp add siglata --url https://www.siglata.com/v1/mcp --bearer-token-env-var SIGLATA_MCP_TOKEN

Ferramentas: apenas execute e search
Organização: principal_get dentro de execute (sem ferramenta context)
Hub: https://www.siglata.com/docs/agents/connect
Checagem no CLI real: python3 scripts/verify-codex-install.py em siglata/agent-plugins
Checagem /poteto-mode: python3 scripts/verify-codex-poteto.py no mesmo repositório (skills do projeto ou instalação em $CODEX_HOME/skills)