---
title: "VS Code Extension"
description: "Connect your InsForge projects to AI coding assistants and install MCP with one click."
---

## Overview

The InsForge VS Code extension:

- Logs you in to InsForge (OAuth + PKCE)
- Lets you pick an org/project
- Installs InsForge MCP for your AI client

It launches the MCP installer (`npx @insforge/install`) with your project’s API key and API base URL.

## Links

- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=InsForge.insforge)
- [Open VSX](https://open-vsx.org/extension/InsForge/insforge)

## Install

1. Open VS Code
2. Go to **Extensions**
3. Search for **InsForge**
4. Install the extension published by **insforge**

## Use the extension

<Steps>
  <Step title="Open the InsForge panel">
    Click the **InsForge** icon in the Activity Bar (left sidebar).
  </Step>

  <Step title="Login">
    Click **Login with InsForge** and complete the login flow in your browser.

    <Note>The callback is <code>http://127.0.0.1:54321/callback</code>.</Note>
  </Step>

  <Step title="Select a project">
    Pick an organization and project from the InsForge tree view, or run <code>InsForge: Select Project</code> from the Command Palette.
  </Step>

  <Step title="Install MCP">
    Run <code>InsForge: Install MCP</code> (or right-click a project and choose **Install MCP**), then pick the AI client you want to configure.

    The installer runs in a VS Code terminal.
  </Step>
</Steps>

## Supported AI clients

The extension supports the following MCP “clients” (the value passed to `@insforge/install`):

| Client | Typical config location |
|---|---|
| `cursor` | `~/.cursor/mcp.json` |
| `claude-code` | `.mcp.json` in your workspace (project-local) |
| `copilot` | `.vscode/mcp.json` in your workspace (project-local) |
| `windsurf` | `~/.codeium/windsurf/` |
| `cline` | Cline VS Code extension config |
| `roocode` | Roo Code VS Code extension config |
| `codex` | OpenAI Codex CLI config |
| `trae` | Trae IDE config |
| `qoder` | Qoder IDE config |

If your client isn’t listed, run the installer manually (see <a href="/quickstart">Quickstart</a>).

## Notes

- **Project-local installs**: `claude-code` and `copilot` require an open workspace folder.
- **Port in use**: free up `54321` and retry login.

