---
title: Install
description: Copy the steps for your operating system and app.
sidebar:
  order: 0
---

Use this page when you want the fastest safe path from “I have an agent” to “it can use my Siglata workspace.” The page checks your operating system in the browser, then shows Bash for macOS and Linux or PowerShell for Windows. You can override the choice at any time.

For Claude Desktop, follow the [remote connector guide](/docs/en-US/agents/install/claude-desktop). The Claude option below prints the connector instructions. For ChatGPT Work, these local commands apply to the desktop app. [Hosted Work uses plugins](https://learn.chatgpt.com/docs/en-US/extend/mcp?surface=cli).

<div data-siglata-install-picker data-locale="en-US" style="border: 1px solid var(--blume-border); border-radius: 8px; padding: 1rem; margin: 1.5rem 0;">
  <p style="margin: 0 0 0.75rem;"><strong>Detected operating system:</strong> <span data-os-label>Checking...</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
# Pick one: 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' \
      'In Claude Desktop, open Customize > Connectors.' \
      'Add a custom connector named siglata with this URL:' \
      'https://www.siglata.com/v1/mcp' \
      'Connect siglata, sign in, choose your organization, and approve access.' \
      'For Team or Enterprise, ask an Owner to add the connector first.'
    ;;
  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
# Pick one: 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 "In Claude Desktop, open Customize > Connectors."
    Write-Output "Add a custom connector named siglata with this URL:"
    Write-Output "https://www.siglata.com/v1/mcp"
    Write-Output "Connect siglata, sign in, choose your organization, and approve access."
    Write-Output "For Team or Enterprise, ask an Owner to add the connector first."
  }
  "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>

## Choose Your Agent [#agents]

| Agent | Best path | Status | Notes |
| :-- | :-- | :-- | :-- |
| Codex | Plugin commands | Proven (v1) | Installs Siglata skills and MCP together. Restart the Codex session after install. |
| ChatGPT Work on desktop | Settings or shared Codex config | Installable / spec-compatible | Uses the same `~/.codex/config.toml` entry as Codex. |
| Cursor | `.cursor/mcp.json` or MCP settings | Proven (v1) | Use project config for one repository or global config for every project. |
| Claude Desktop | Custom remote connector | Installable / spec-compatible | Add Siglata in Customize > Connectors, then connect your account. |
| VS Code | Command Palette or `.vscode/mcp.json` | Installable / spec-compatible | Use Copilot Chat in Agent mode and enable the server in the tools picker. |

## After the Script [#after]

1. Start or restart the agent.
2. Begin the Siglata sign-in when the app offers it.
3. Open the magic link in your email.
4. Pick the organization this agent may reach.
5. Approve the requested permissions.

You are done when the agent lists exactly two tools, `execute` and `search`, and can list files in your Siglata organization.

## Detailed Guides [#guides]

- [Connect Codex](/docs/en-US/agents/install/codex)
- [Connect ChatGPT Work on desktop](/docs/en-US/agents/install/chatgpt-desktop)
- [Connect Cursor](/docs/en-US/agents/install/cursor)
- [Connect Claude Desktop](/docs/en-US/agents/install/claude-desktop)
- [Connect VS Code](/docs/en-US/agents/install/vs-code)