> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# VS Code extension

> Sign in to InsForge from VS Code, pick an org and project, and install the InsForge MCP server into your AI coding assistant 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](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.