Skip to main content
Connect an MCP client so that an AI assistant can read your workspaces with your account.

Connect this client to the VMS MCP server.

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.
  • 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 instead.

Connect a client

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

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.