# VS Code

Connect VS Code to GoRunner, then ask it to build, run and check your workflows.

## You need

- **VS Code**: On your computer.

## Connect VS Code

*Cloud and Self-hosted only:*

1. In GoRunner, open **MCP** in the sidebar. If an app is already connected, press **Connect an AI app**. Choose **VS Code**; if it isn’t shown, press **All 13 apps**.

   ![The Connect an AI app panel with VS Code chosen. The ringed key is the one to press.](https://docs.gorunner.io/img/ai-apps/ai-vscode-light.jpg)

2. Press **Add to VS Code**. VS Code opens. Press **Install**.

3. Sign in to GoRunner when VS Code asks.

4. On **Allow “VS Code” to use GoRunner?**, choose the workspace and what it may do, then press **Allow access**.

*Embed only:*

[Since v2026.10.23](https://docs.gorunner.io/changelog/v2026.10.23)

1. In the product you use, open **MCP**, press **Connect an AI app** and choose **VS Code**.
2. Press **Add to VS Code**. VS Code opens. Press **Install**.
3. Sign in with the account you use here when VS Code asks.
4. Choose what it may do, then press **Allow access**.

You should see “**Connected** · VS Code · Acme · 12 tools” in the panel.

It stays connected for up to 180 days, or until you disconnect it.

*Embed only:*

Without sign-in for AI apps, the panel shows VS Code with a token instead: make or paste one, and copy the setting it fills in. If the product lets apps run your workflows but not build them, the address ends in `/tools`. VS Code can then only call your published workflows. See [Turn your workflows into tools](https://docs.gorunner.io/mcp/workflows-as-tools).

**Can I use an API token instead?**

Yes, for an app that can’t sign in. In the panel, press **Use an API token instead**. [Connect with an API token](https://docs.gorunner.io/mcp/api-token) shows each step.

**How do I disconnect VS Code?**

*Cloud and Self-hosted only:*

On the **MCP** page, under **Connected apps**, press **Disconnect** next to the app. Revoke a token in **Settings › Workspace › API tokens**.

*Embed only:*

On the product’s **MCP** page, press **Disconnect** next to the app.

It stops on its next request. Remove it in VS Code too.

## What you can ask

*Cloud and Self-hosted only:* 13 tools: it reads, drafts and runs in the workspaces you choose. It publishes only if you allow it. *Embed only:* What it can do depends on what the product allows: building, or only your published workflows. If VS Code lists the server’s commands, try one:

- Build a workflow (when it may write drafts)
- Diagnose a failed run
- Explain a workflow

It can also call your own published workflows.

## For developers

AI apps connect through MCP (Model Context Protocol). VS Code adds the server `https://api.gorunner.io/mcp/build` under the name `gorunner` and signs in with [OAuth](https://docs.gorunner.io/mcp/oauth). Self-hosted: your installation’s address, ending in `/mcp/build`.

Or run **MCP: Add Server** → **HTTP** and paste the address.

## Related

- [Choose what an AI app may do](https://docs.gorunner.io/mcp/permissions): Read only, Draft and run, or publish too · 3 min
- [Turn your workflows into tools](https://docs.gorunner.io/mcp/workflows-as-tools): Let an AI app run a workflow you made · 4 min
- [See and disconnect AI apps](https://docs.gorunner.io/mcp/disconnect): Connected apps, on the MCP page · 2 min

Source: https://docs.gorunner.io/mcp/vscode