---
title: Integração com Codex
description: Como conectar o OpenAI Codex e a CLI do Codex às ferramentas MCP e ao catálogo de arquivos da Siglata.
sidebar:
  label: Codex
  order: 3
---

O Codex integra-se com a Siglata através do Plugin de Agente oficial `@siglata` e do servidor Model Context Protocol (MCP).

## Instalação

Inicie o instalador compatível da Siglata:

```bash
siglata install
```

Ou configure diretamente o arquivo de descoberta de ferramentas do Codex:

```json
{
  "plugins": ["@siglata/files"],
  "mcp": {
    "siglata": {
      "type": "streamable-http",
      "url": "https://www.siglata.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${SIGLATA_API_KEY}"
      }
    }
  }
}
```

## Como o Codex Interage com a Siglata

1. **Inicialização de Contexto**: O Codex chama `context` para verificar permissões da organização e limites.
2. **Download e Ingestão de Arquivos**: Quando arquivos ou planilhas são passados ao Codex, o Codex fornece a URL de download; a Siglata baixa os bytes, calcula checksums SHA-256 e armazena com segurança no cofre.
3. **Execução Transacional**: O Codex planeja edições usando `execute({ mode: "plan" })`, revisa o digest da mutação e confirma com `execute({ mode: "apply" })`.

## Exemplo de Prompt

```text
Use a Siglata para inspecionar nossa planilha de Receita do 3º Trimestre, calcular o total entre todas as regiões e adicionar uma linha de resumo.
```