Docs menuConnect VS Code

Connect VS Code

Use with AI

Connect GitHub Copilot in VS Code to Colliedesk. VS Code asks for the token once and stores it securely; it never appears in the configuration file.

On this page

Before you start

  1. Sign in to Colliedesk and open Settings → AI & agents → External AI agents.
  2. Name the token (for example "VS Code 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.
  3. 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 VS Code with your address already in.

Connect

  1. In VS Code, run MCP: Open User Configuration from the Command Palette.

  2. Add the inputs entry and the colliedesk server below to the file (keep what is already in it):

    {
      "inputs": [
        {
          "type": "promptString",
          "id": "colliedesk-token",
          "description": "Colliedesk agent token",
          "password": true
        }
      ],
      "servers": {
        "colliedesk": {
          "type": "http",
          "url": "https://desk.example.com/mcp",
          "headers": {
            "Authorization": "Bearer ${input:colliedesk-token}"
          }
        }
      }
    }
    
  3. Start the server from the file or the MCP Servers view. VS Code asks for the Colliedesk agent token once: paste it.

The colliedesk tools then show in the tools picker of Copilot chat in agent mode.

Try it

Ask VS Code: "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

Delete the colliedesk server and the colliedesk-token input from the file. 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

Was this page helpful?

Updated

This page is rendered from the repository. Spot a mistake? Open an issue or a pull request.