Get started

Connect Modula to GitHub Copilot

GitHub Copilot in VS Code supports MCP servers natively from version 1.99 (April 2025). Once Modula is connected, you can use Copilot Chat in Agent mode to generate interactive educational content directly from your editor.

What you’ll need

Steps

1. Open the MCP configuration file

You can configure MCP servers at user level (applies to all projects) or at workspace level.

User-level — open your VS Code settings.json (press ⌘ Shift P / Ctrl Shift P, search for Open User Settings JSON) and add:

{
  "mcp": {
    "servers": {
      "modula": {
        "type": "http",
        "url": "https://mcp.modula.dev/mcp"
      }
    }
  }
}

Workspace-level — create or edit .vscode/mcp.json in your project root:

{
  "servers": {
    "modula": {
      "type": "http",
      "url": "https://mcp.modula.dev/mcp"
    }
  }
}

2. Enable MCP support in Copilot Chat

Open the Copilot Chat panel (⌘ Shift I / Ctrl Shift I) and switch to Agent mode using the dropdown at the top of the chat input. MCP servers are only available in Agent mode.

3. Authenticate with Modula

The first time Copilot invokes a Modula tool, VS Code will open a browser window to complete the Modula login flow. Sign in with your Modula account and grant permission. Once confirmed, the connection is established and Copilot can use Modula tools for the rest of the session.

4. Use Modula in Agent mode

With the Modula server connected, try a prompt like:

Using Modula, create a lesson on the water cycle: an introductory section, an interactive diagram, and a short comprehension quiz at the end.

Copilot will call the Modula tools automatically to search, select, and assemble the components into a ready-to-use HTML artifact.

Tips

  • You can verify which MCP servers are active by clicking the Tools icon (wrench) in the Copilot Chat input bar — Modula tools should appear in the list.
  • If you need to restart the authentication flow, open the Command Palette and run MCP: List Servers, then select Modula and choose Restart Server.
  • The workspace-level .vscode/mcp.json can be committed to your repository so all team members get the Modula server automatically.
  • To remove the connection, delete the "modula" entry from your settings or .vscode/mcp.json.