wehub-resource-sync
75 lines
2.3 KiB
Plaintext
75 lines
2.3 KiB
Plaintext
---
|
||
title: "VS Code extension"
|
||
description: "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</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.
|
||
|