---
title: Connect
description: Pick the app and approve access to Siglata.
sidebar:
  order: 1
---

Siglata connects to an AI agent through one address. Once connected, your agent works with your organization's files, folders, and members under your own membership and role.

```text
https://www.siglata.com/v1/mcp
```

There is no API key to create and nothing to paste into a settings field beyond that address. You sign in with an email magic link, and you pick one organization while you connect.

## Pick Your App [#pick-your-app]

Choose the app you already use. Start with the [OS-aware install hub](/docs/en-US/agents/install) if you want the page to pick Bash or PowerShell for you. Each app page carries the full steps, a copy-paste block, and a way to check the connection worked.

| App | Install page | Status |
| :-- | :-- | :-- |
| Cursor | [Connect Cursor](/docs/en-US/agents/install/cursor) | Proven (v1) |
| Codex | [Connect Codex](/docs/en-US/agents/install/codex) | Proven (v1) |
| ChatGPT Desktop | [Connect ChatGPT Desktop](/docs/en-US/agents/install/chatgpt-desktop) | Installable / spec-compatible |
| Claude Desktop | [Connect Claude Desktop](/docs/en-US/agents/install/claude-desktop) | Installable / spec-compatible |
| VS Code | [Connect VS Code](/docs/en-US/agents/install/vs-code) | Installable / spec-compatible |

**Proven (v1)** means Cursor and Codex are the clients Siglata verified for this release. **Installable / spec-compatible** means the same MCP endpoint works when the app supports remote Streamable HTTP and OAuth. Steps may vary slightly by app version.

These pages are install how-tos only. They do not replace the marketing site or the MCP capability reference.

## Before You Start [#prerequisites]

- A Siglata account. Open the [Siglata Console](https://www.siglata.com/app) and sign in with a magic link. See [Sign in](/docs/en-US/sign-in).
- One of the apps above, installed and up to date.

## What Happens While You Connect [#authorization]

Every app follows the same five moments, whatever its settings screen looks like.

1. You give the app the address `https://www.siglata.com/v1/mcp`.
2. The app opens your browser on Siglata.
3. You sign in with your email magic link if you are not signed in already.
4. You pick the organization this connection may reach. One connection reaches one organization.
5. You approve the permissions the app asked for, and the app stores its access token.

## You're Done When [#done]

- Your app lists Siglata as connected.
- The tool list shows exactly two tools, `execute` and `search`.
- You ask the agent to list the files in your organization, and it answers with your files.

## What the Agent Can Do [#capabilities]

With the usual permissions, your agent can list files and folders, upload new ones, download and read them, rename them, move them between folders, send files to the trash, and restore them within 30 days. It can also read your organization's profile, list members, invite people, and change roles.

Each connection stays inside one organization, and it can never do more than the permissions you approved. For the exact list of operations and the permission each one needs, read [MCP](/docs/en-US/agents/mcp).

## Connecting a Second Organization [#second-organization]

An organization is chosen once per connection. To reach a second organization from the same app, add a second server entry under a different name, such as `siglata-acme`, and pick the other organization while you authorize it.

## For Agents [#for-agents]

- Endpoint `https://www.siglata.com/v1/mcp`, Streamable HTTP, OAuth 2.0 with dynamic client registration at `POST /auth/oauth2/register`.
- `tools/list` returns exactly two tools, `execute` and `search`. There is no `context` tool.
- Management operations are CallScript functions called inside an `execute` script, not MCP tools.
- Call `principal_get` inside an `execute` script to read the organization this grant is bound to, plus the user ID, role, and scopes. Call `organization_get` for the name and slug.
- Install pages: [Cursor](/docs/en-US/agents/install/cursor), [Codex](/docs/en-US/agents/install/codex), [ChatGPT Desktop](/docs/en-US/agents/install/chatgpt-desktop), [Claude Desktop](/docs/en-US/agents/install/claude-desktop), [VS Code](/docs/en-US/agents/install/vs-code).
- OS-aware install hub: [Install](/docs/en-US/agents/install).
- Capability reference: [MCP](/docs/en-US/agents/mcp).