Connect VS Code

VS Code’s agent mode runs local processes and can also connect to a remote server directly, so it supports every Moodle and Ed Discussion Model Context Protocol (MCP) surface described in MCP servers. Official reference: Use MCP servers in VS Code, fetched 2026-09-21.

Prerequisites

moodle-cli and edstem-cli installed and signed in. See Install and Install.
VS Code with GitHub Copilot Chat’s agent mode.

VS Code reads MCP servers from a workspace file, .vscode/mcp.json, or from a user-profile file opened with the MCP: Open User Configuration command. Both use a servers key, not mcpServers.

Moodle
Ed Discussion

Preferred: `moodle mcp connect`

moodle mcp connect vscode

This writes a bridge entry to your user-profile mcp.json:

{
  "servers": {
    "moodle-<profile>": {
      "command": "moodle",
      "args": ["mcp", "bridge", "--profile", "<profile>"]
    }
  }
}

Manual: remote, header auth

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<worker-host>/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

Get <your-token> with moodle mcp connect vscode --mode remote --show-token. Avoid hardcoding it in a workspace .vscode/mcp.json you commit — use the user-profile file, or an input variable, instead.

Stdio, local

{
  "servers": {
    "edstem": {
      "command": "edstem-mcp",
      "env": { "EDSTEM_TOKEN": "<your-token>" }
    }
  }
}

Remote, hosted OAuth

{
  "servers": {
    "edstem": { "type": "http", "url": "https://edstem.tuuhub.com/mcp" }
  }
}

Remote, self-deployed Worker

{
  "servers": {
    "edstem": {
      "type": "http",
      "url": "https://<your-worker>/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

You can also add either server through the command palette: run MCP: Add Server, choose Workspace or Global scope, and follow the prompts instead of editing JSON by hand.

Verify the connection

Run MCP: List Servers from the command palette to see each server’s status and its tools. Use MCP: Reset Trust if VS Code is refusing to start a server you’ve already configured correctly.

Connect an AI app

Connect a client

Connect VS Code

Prerequisites

Preferred: `moodle mcp connect`

Manual: remote, header auth

Stdio, local

Remote, hosted OAuth

Remote, self-deployed Worker

Verify the connection

​Prerequisites

​Preferred: moodle mcp connect

​Manual: remote, header auth

​Stdio, local

​Remote, hosted OAuth

​Remote, self-deployed Worker

​Verify the connection

Prerequisites

Preferred: `moodle mcp connect`

Manual: remote, header auth

Stdio, local

Remote, hosted OAuth

Remote, self-deployed Worker

Verify the connection