---
title: Instalar
description: Copie os passos do seu sistema operacional e do app.
sidebar:
  order: 0
---

Use esta página quando quiser o caminho mais direto de “tenho um agente” para “ele consegue usar meu espaço de trabalho no Siglata”. A página detecta seu sistema operacional no navegador e mostra Bash para macOS e Linux ou PowerShell para Windows. Você pode trocar a opção manualmente.

Para o Claude Desktop, siga o [guia do conector remoto](/docs/agents/install/claude-desktop). A opção Claude abaixo exibe as instruções do conector. Para o ChatGPT Work, estes comandos locais se aplicam ao app desktop. [O Work na web usa plugins](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

<div data-siglata-install-picker data-locale="pt-BR" style="border: 1px solid var(--blume-border); border-radius: 8px; padding: 1rem; margin: 1.5rem 0;">
  <p style="margin: 0 0 0.75rem;"><strong>Sistema operacional detectado:</strong> <span data-os-label>Verificando...</span></p>
  <div style="display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 1rem;">
    <button type="button" data-os-choice="mac" style="border: 1px solid var(--blume-border); border-radius: 6px; padding: 0.4rem 0.65rem;">macOS / Linux</button>
    <button type="button" data-os-choice="windows" style="border: 1px solid var(--blume-border); border-radius: 6px; padding: 0.4rem 0.65rem;">Windows</button>
  </div>
  <div data-os-panel="mac">

```bash
#!/usr/bin/env bash
# Escolha um: codex, cursor, claude, vscode, chatgpt
AGENT="${AGENT:-codex}"

case "$AGENT" in
  codex)
    codex plugin marketplace add siglata/agent-plugins
    codex plugin add siglata@siglata-agent-plugins
    ;;
  cursor)
    mkdir -p .cursor
    cat > .cursor/mcp.json <<'JSON'
{
  "mcpServers": {
    "siglata": {
      "url": "https://www.siglata.com/v1/mcp"
    }
  }
}
JSON
    ;;
  claude)
    printf '%s\n' \
      'No Claude Desktop, abra Personalizar > Conectores.' \
      'Adicione um conector personalizado chamado siglata com esta URL:' \
      'https://www.siglata.com/v1/mcp' \
      'Conecte o siglata, entre na sua conta, escolha a organização e aprove o acesso.' \
      'No Team ou Enterprise, peça a um proprietário para adicionar o conector primeiro.'
    ;;
  vscode)
    mkdir -p .vscode
    cat > .vscode/mcp.json <<'JSON'
{
  "servers": {
    "siglata": {
      "type": "http",
      "url": "https://www.siglata.com/v1/mcp"
    }
  }
}
JSON
    ;;
  chatgpt)
    codex mcp add siglata --url https://www.siglata.com/v1/mcp
    codex mcp login siglata
    ;;
esac
```

  </div>
  <div data-os-panel="windows" hidden>

```powershell
# Escolha um: codex, cursor, claude, vscode, chatgpt
$Agent = if ($env:AGENT) { $env:AGENT } else { "codex" }

switch ($Agent) {
  "codex" {
    codex plugin marketplace add siglata/agent-plugins
    codex plugin add siglata@siglata-agent-plugins
  }
  "cursor" {
    New-Item -ItemType Directory -Force -Path ".cursor" | Out-Null
    @'
{
  "mcpServers": {
    "siglata": {
      "url": "https://www.siglata.com/v1/mcp"
    }
  }
}
'@ | Set-Content -Encoding UTF8 ".cursor\mcp.json"
  }
  "claude" {
    Write-Output "No Claude Desktop, abra Personalizar > Conectores."
    Write-Output "Adicione um conector personalizado chamado siglata com esta URL:"
    Write-Output "https://www.siglata.com/v1/mcp"
    Write-Output "Conecte o siglata, entre na sua conta, escolha a organização e aprove o acesso."
    Write-Output "No Team ou Enterprise, peça a um proprietário para adicionar o conector primeiro."
  }
  "vscode" {
    New-Item -ItemType Directory -Force -Path ".vscode" | Out-Null
    @'
{
  "servers": {
    "siglata": {
      "type": "http",
      "url": "https://www.siglata.com/v1/mcp"
    }
  }
}
'@ | Set-Content -Encoding UTF8 ".vscode\mcp.json"
  }
  "chatgpt" {
    codex mcp add siglata --url https://www.siglata.com/v1/mcp
    codex mcp login siglata
  }
}
```

  </div>
</div>

<script>
(() => {
  const root = document.querySelector("[data-siglata-install-picker]");
  if (!(root instanceof HTMLElement)) {
    return;
  }

  const labels = {
    mac: "macOS / Linux",
    windows: "Windows",
  };

  const label = root.querySelector("[data-os-label]");
  const choices = Array.from(root.querySelectorAll("[data-os-choice]"));
  const panels = Array.from(root.querySelectorAll("[data-os-panel]"));
  const platform = `${navigator.userAgent} ${navigator.platform}`.toLowerCase();

  const setOs = (os) => {
    if (label !== null) {
      label.textContent = labels[os] ?? labels.mac;
    }

    for (const panel of panels) {
      panel.hidden = panel.getAttribute("data-os-panel") !== os;
    }

    for (const choice of choices) {
      const selected = choice.getAttribute("data-os-choice") === os;
      choice.setAttribute("aria-pressed", selected ? "true" : "false");
    }
  };

  for (const choice of choices) {
    choice.addEventListener("click", () => {
      const os = choice.getAttribute("data-os-choice");

      if (os === "mac" || os === "windows") {
        setOs(os);
      }
    });
  }

  setOs(platform.includes("windows") || platform.includes("win32") ? "windows" : "mac");
})();
</script>

## Escolha seu agente [#agents]

| Agente | Melhor caminho | Status | Observações |
| :-- | :-- | :-- | :-- |
| Codex | Comandos do plugin | Comprovado (v1) | Instala as skills do Siglata e o MCP juntos. Reinicie a sessão do Codex depois. |
| ChatGPT Work no desktop | Configurações ou config compartilhada do Codex | Instalável / compatível com a especificação | Usa a mesma entrada em `~/.codex/config.toml` do Codex. |
| Cursor | `.cursor/mcp.json` ou configurações MCP | Comprovado (v1) | Use config do projeto para um repositório ou global para todos. |
| Claude Desktop | Conector remoto personalizado | Instalável / compatível com a especificação | Adicione o Siglata em Personalizar > Conectores e conecte sua conta. |
| VS Code | Command Palette ou `.vscode/mcp.json` | Instalável / compatível com a especificação | Use o Copilot Chat em modo Agent e ative o servidor no seletor de ferramentas. |

## Depois do script [#after]

1. Inicie ou reinicie o agente.
2. Comece o login do Siglata quando o app oferecer.
3. Abra o link mágico no seu e-mail.
4. Escolha a organização que o agente pode acessar.
5. Aprove as permissões solicitadas.

Você terminou quando o agente lista exatamente duas ferramentas, `execute` e `search`, e consegue listar arquivos da sua organização no Siglata.

## Guias detalhados [#guides]

- [Conectar Codex](/docs/agents/install/codex)
- [Conectar o ChatGPT Work no desktop](/docs/agents/install/chatgpt-desktop)
- [Conectar Cursor](/docs/agents/install/cursor)
- [Conectar Claude Desktop](/docs/agents/install/claude-desktop)
- [Conectar VS Code](/docs/agents/install/vs-code)