---
title: Conectar Codex
description: Instale o plugin de agente do Siglata no Codex, ou adicione a URL MCP diretamente. Cliente comprovado na v1.
sidebar:
  order: 2
---

Conecte o Siglata ao [Codex](https://chatgpt.com/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.

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

1. Inicie uma **nova** sessão do Codex depois da instalação.
2. Quando solicitado, conclua o login do Siglata no navegador. Escolha a organização e aprove os escopos.
3. Peça ao Codex para usar **siglata** em tarefas de arquivos ou organização.

Detalhes do pacote estão em [siglata/agent-plugins](https://github.com/siglata/agent-plugins).

## Passos (somente URL MCP)

Se quiser o servidor MCP sem as skills do plugin:

```sh
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.

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

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. Conclua o link mágico na mesma sessão do navegador quando possível.
- **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](/docs/agents/mcp).

Veja também [Conectar ChatGPT Desktop](/docs/agents/install/chatgpt-desktop) se usar essa UI na mesma configuração compartilhada.

Voltar para [Conectar](/docs/agents/connect).

## Para agentes

Preferido:

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

Somente MCP:

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

- Ferramentas: apenas `execute` e `search`
- Organização: `principal_get` dentro de `execute` (sem ferramenta `context`)
- Hub: `https://www.siglata.com/docs/agents/connect`