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

# Set up Voiceflow in VS Code

> Add the Voiceflow MCP server to VS Code by creating mcp.json with an http server entry, then sign in when prompted.

VS Code reads MCP servers from a JSON file, and unlike most clients it requires you to declare the transport.

## Add the server

**1. Open the configuration file**

| Scope | Where |
| - | - |
| This workspace | `.vscode/mcp.json` |
| Every workspace | Command Palette, then **MCP: Open User Configuration** |

**2. Add Voiceflow**

```json theme={null}
{
  "servers": {
    "voiceflow": {
      "type": "http",
      "url": "https://mcp.voiceflow.com/mcp"
    }
  }
}
```

Two details differ from other clients and both matter. The wrapper key is `servers`, not `mcpServers`. And `"type": "http"` is required, because VS Code will otherwise treat the entry as a local process to launch.

**3. Sign in**

VS Code prompts you to authenticate and opens your browser. Approve the request, and the tab redirects back.

See [Authentication](/docs/mcp/authentication.md) for what the grant covers.

**4. Confirm it worked**

Ask Copilot Chat in agent mode to **list your Voiceflow projects**. A list means the transport, the grant, and your account access are all working.

## If it does not connect

| Symptom | Likely cause |
| - | - |
| VS Code tries to run a command | `"type": "http"` is missing |
| The server never appears | The entry went in under `mcpServers` rather than `servers` |
| It appears but has no tools | The OAuth flow did not finish. Reconnect and complete the browser step |
| The tools never get called | Copilot Chat is not in agent mode |

To disconnect, remove the `voiceflow` entry. That drops this machine's copy of the token; revoke access in Voiceflow to end every client's session at once.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.