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

# Connect an MCP client

> Connect Claude, Cursor, Visual Studio Code, or another MCP client to your workspaces, and use its tools.

Connect an MCP client so that an AI assistant can read your workspaces with your account.

Connect this client to the VMS MCP server.

Add the VMS MCP server to this client and help me sign in.
Call list\_organizations and ask which workspace to use.
Call get\_workspace for that workspace and summarize it.
Do not change anything.

## Before you start

* You need an account and membership in the workspace that you want to use.
* Your client must support remote MCP with OAuth. See [other clients](https://vms.dev/docs/reference/workspace-mcp.md#other-clients).
* The MCP server URL is `https://vms.dev/api/mcp`.

The client opens sign-in in your browser. You approve its access there. Do not paste a password or an API key into the client.

An agent that cannot open a browser can [register with auth.md](https://vms.dev/docs/api-reference/agent-registration.md) instead.

## Connect a client

> [tab] Claude
>
> **1. Add the connector**
>
> In Claude, open **Settings**, then **Connectors**, and choose **Add custom connector**.
>
> **2. Enter the server**
>
> Name it `VMS` and enter the MCP endpoint as the URL. Leave the OAuth fields empty.
>
> **3. Sign in and allow access**
>
> Choose **Connect**. In the browser, sign in, read the access that the client asks for, and choose **Allow**.
>
> ![The consent screen where claude.ai asks for access to your account, with the list of what it can do as you and the Deny and Allow buttons.](https://mintcdn.com/vms-c6f4e5ac/ik-PVuE4l6A-0My2/images/get-started/mcp/01-allow-access-light.png?fit=max\&auto=format\&n=ik-PVuE4l6A-0My2\&q=85\&s=7334c7550f124c314c960833564a4aa0)

> [tab] Claude Code
>
> Add the server:
>
> ```bash theme={null}
> claude mcp add --transport http vms https://vms.dev/api/mcp
> ```
>
> Then run `/mcp`, choose `vms`, and sign in in the browser.

> [tab] Cursor
>
> Add the server to `.cursor/mcp.json` in your project:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "vms": { "url": "https://vms.dev/api/mcp" }
>   }
> }
> ```
>
> Cursor asks you to sign in the first time.

> [tab] Visual Studio Code
>
> Add the server to `.vscode/mcp.json` in your project:
>
> ```json theme={null}
> {
>   "servers": {
>     "vms": { "type": "http", "url": "https://vms.dev/api/mcp" }
>   }
> }
> ```
>
> Start the server from the file. Visual Studio Code asks you to sign in the first time.

## Check the connection

1. Ask the client to call `list_organizations`.
2. Choose a workspace from the result. Use its slug as the `organization` value in later tool calls.
3. Ask the client to call `get_workspace` for that workspace.

These calls do not change workspace data.

## Disconnect a client

Remove the server in the client. The access token expires after 15 minutes. If you allowed **Stay connected when you are not using the app**, the client can get a new token until you remove it.

Read the [changelog.](https://vms.dev/docs/changelog.md)


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