> ## 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.