> ## Documentation Index
> Fetch the complete documentation index at: https://docs.studiograph.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect AI tools (MCP)

> Point Claude Code, Claude Desktop, Cursor, and other MCP clients at your Studiograph workspace.

Studiograph exposes an MCP (Model Context Protocol) server, so AI tools like Claude Code, Claude Desktop, and Cursor can search, read, and edit your workspace. There are two ways to connect.

## Hosted workspace (HTTP)

<Steps>
  <Step title="Mint a personal token">
    In the web app, open **Settings → Connectors → Studiograph MCP** and mint a token. It starts with `sg_` and is shown once — copy it immediately.
  </Step>

  <Step title="Add the server to your client's config">
    ```json theme={null}
    {
      "mcpServers": {
        "studiograph": {
          "type": "streamable-http",
          "url": "https://<your-workspace>/mcp",
          "headers": {
            "Authorization": "Bearer sg_your_token_here"
          }
        }
      }
    }
    ```
  </Step>
</Steps>

<Info>
  The token acts as you. The connected tool sees exactly the folders you can see — nothing more.
</Info>

## Local workspace (stdio)

For clients that spawn a subprocess instead of calling a URL, run the CLI as a stdio MCP server:

```json theme={null}
{
  "mcpServers": {
    "studiograph": {
      "command": "studiograph",
      "args": ["mcp"],
      "env": {
        "STUDIOGRAPH_MCP_TOKEN": "sg_your_token_here"
      }
    }
  }
}
```

`studiograph mcp` requires `STUDIOGRAPH_MCP_TOKEN` and proxies to the local server, so the same per-user folder access applies.

## What connected tools can do

Around 53 tools are available, covering most of what you can do in the app:

| Area              | Tools cover                                                                                  |
| ----------------- | -------------------------------------------------------------------------------------------- |
| Search & read     | Search across folders, list and read entries, find related entries, validate links           |
| Entries           | Create, update, patch, copy, move, and delete entries                                        |
| Folders           | Create folders and subfolders, archive folders — never permanent deletion                    |
| Datasets          | Query data; add, insert, and delete rows and columns; set cells, filters, sorts, and formats |
| Artifacts         | Create and edit artifacts frame by frame, inspect them, export them                          |
| Uploads           | List library assets, attach them to entries, upload new files                                |
| History & restore | Browse file and folder history, list recent deletions, read past versions, restore           |
| Comments          | List comment threads on an entry, reply, resolve                                             |
| Skills            | List and load your saved workflow skills                                                     |

<Note>
  Permanently deleting a folder is a human-only action in the web app; no MCP tool can do it.
</Note>

## Revoking a token

Your minted tokens are listed in the same place they're created — **Settings → Connectors → Studiograph MCP**. Open a token and revoke it there; the connected tool loses access immediately.