Connect an agent

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.

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 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:

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.

~/.cursor/mcp.json

{
  "mcpServers": {
    "contence": { "url": "https://contence.io/mcp" }
  }
}

CLI

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

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.

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.

Start

Guides

MCP

CLI

A few commands