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

# Connect an agent

> Use Contence from Claude, ChatGPT, Cursor or any MCP client, or from the contence CLI.

There are two ways in, and both create a key for one workspace. You can see and revoke every key on the Agents page in the app.

> [!NOTE]
>
> The full CLI and MCP reference, every tool with its inputs and the access it needs, is in the app at [app.contence.io/app/docs](https://app.contence.io/app/docs) after you sign in. It shows what your own agent can call.

## MCP

Contence is a remote MCP server. Nothing is installed. The server URL is:

```text theme={null}
https://contence.io/mcp
```

* **Claude**: Customize, Connectors, Add, then Custom and Web. Name it Contence, paste the URL and choose Sign in now. Team and Enterprise owners add it under Organization settings.
* **ChatGPT** on the web: Plugins, the plus button, Add custom MCP server. Name it Contence, paste the URL, choose OAuth, then Create as a plugin. Needs a Business, Enterprise or Edu workspace.
* **Cursor**: add the server to `~/.cursor/mcp.json`, restart Cursor, then click Connect next to Contence in Settings, MCP.

```json ~/.cursor/mcp.json theme={null}
{
  "mcpServers": {
    "contence": { "url": "https://contence.io/mcp" }
  }
}
```

## CLI

The CLI needs Node.js 18 or later. Install it, or prefix any command with `npx`:

```bash theme={null}
npm install -g contence
contence auth login
```

`contence auth login` prints a code and opens app.contence.io/app/cli. Check that the code matches, then approve. The key has read access unless you ask for more with `--scope media` or `--scope write`, up to what your role allows. `contence auth status` shows the workspace and scope, and `contence auth logout` revokes the key.

For scripts and CI, set `CONTENCE_API_KEY` to a key an admin made under Settings, API keys, and `CONTENCE_WORKSPACE` when a login can open more than one workspace. `contence mcp` serves the same tools to a local MCP client over stdio.

## A few commands

Every workspace tool is also a CLI command. Add `--json` for output an agent can parse.

```bash theme={null}
contence project-list --json                 # the workspace's projects
contence project-files PROJECT_ID --json     # its videos and versions
contence review-comments CONTENT_ID --json   # review comments on a version
contence upload cut.mp4 --project PROJECT_ID # a new video, or the next version of one
contence diff FILE_A FILE_B                  # what changed between two versions
contence link https://youtu.be/...           # record where content went out
contence skills install                      # install Contence's agent skills
```

Tools that change something outside Contence print a dry run until you add `--yes`, and name the person who approved the change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.