On this page
Connect to Colliedesk Cloud with the plugin
The Colliedesk plugin adds the MCP server of Colliedesk Cloud, https://app.colliedesk.com/mcp, and the
agent skills. It signs in with OAuth: no token to create or paste.
Install the plugin:
codex plugin marketplace add colliedesk/colliedesk codex plugin add colliedesk@colliedeskSign in:
codex mcp login colliedeskYour browser opens Colliedesk. Sign in if it asks, choose the workspace and choose Allow.
codex mcp list shows colliedesk as logged in, and Settings → Account → Connected
AI apps in Colliedesk lists Codex. Codex acts as you, with everything you can do in the workspace you
allowed; see Connected AI apps. To use another workspace, run
codex mcp logout colliedesk, then sign in again and choose that workspace. Remove the plugin with
codex plugin remove colliedesk@colliedesk; then choose Disconnect next to Codex in Settings.
Connect with an agent token
For a server you run yourself, or to give Codex fewer permissions than you hold, use an agent token.
Before you start
- Sign in to Colliedesk and open Settings → AI & agents → External AI agents.
- Name the token (for example "Codex on my laptop"), choose what it may do (follow a role, or pick permissions; leaving out sending to customers is a good start) and choose Create token. See Agent tokens.
- Copy the token. It starts with
cdk_agent_and is shown once.
The steps below use https://desk.example.com: put the address you open Colliedesk at in its place.
Under Connect your agent, Settings shows these steps for Codex with your address already in.
Connect
Put the token in your shell profile (
~/.zshrcor~/.bashrc) so every new terminal has it, and open a new terminal:export COLLIEDESK_TOKEN=<your token>Add Colliedesk:
codex mcp add colliedesk --url https://desk.example.com/mcp --bearer-token-env-var COLLIEDESK_TOKEN
codex mcp list shows colliedesk with Bearer token. Codex reads the token from the variable and
never writes it into its configuration. It reads the variable when it
starts, so start it from a terminal that has it. The IDE extension and the desktop app only see it
when they are started from such a terminal.
Try it
Ask Codex: "Who am I in Colliedesk?" It calls colliedesk_whoami, which answers
with your name, your workspace, your roles, the token's permissions and the tools it may use. Then, for example: "Triage the
open conversations nobody owns: tag billing questions with billing and leave a note with a
summary."
What the agent can do
Colliedesk has 250 tools. The agent acts as you, with the permissions you gave the token, never more than you hold now. A tool it has the permissions for runs at once; any other is refused with the permission it lacks. See Roles and permissions.
Every tool and what it needs: Connect an AI agent (MCP).
Remove it
codex mcp remove colliedesk
Delete the export line from your shell profile. Then revoke the token in Settings → AI & agents → External AI agents (its ⋯ menu, Revoke): it stops working at once, wherever it was
copied.
Other hosts
- Claude Code
- Cursor
- VS Code
- Claude Desktop
- Agent skills: triage, draft replies and chase pending conversations
Was this page helpful?
Updated
This page is rendered from the repository. Spot a mistake? Open an issue or a pull request.