Skip to main content

Claude Code with VMCP

This guide walks you through connecting Claude Code CLI to your Virtual MCP (VMCP) servers through MintMCP.

Prerequisites​

Before starting, ensure you have:

  • Claude Code CLI installed on your machine
  • A MintMCP account with at least one configured VMCP

Step 1: Get Your VMCP Connection URL​

  1. Navigate to your VMCP in the MintMCP dashboard
  2. Click on the VMCP you want to connect
  3. Navigate to the "MCP Client Setup" tab
  4. Copy the MCP URL displayed
MCP Connector success state

Step 2: Add MintMCP Server to Claude Code​

Use the claude mcp add command to configure your VMCP:

claude mcp add -t http MCP_NAME VMCP_URL_HERE

Replace VMCP_URL_HERE with the MCP URL you copied in Step 1.

Method 2: Direct Configuration File​

Alternatively, you can directly edit the Claude Code configuration file:

Location: ~/.claude.json

Add this configuration:

{
  "mcpServers": {
    "MCP_NAME": {
      "type": "http",
      "url": "VMCP_URL_HERE"
    }
  }
}

Step 3: Verify Claude Code has access to the VMCP server​

  1. Start Claude Code and use the /mcp command
  2. You should see the newly added MCP server.

Step 4: Authenticate​

  1. Start Claude Code and login to the MCP using /mcp command
MCP Connector success state
  1. When you authenticate, a browser window will open for MintMCP authentication.
MCP Connector success state
  1. Log in with your MintMCP account.
  2. Once authenticated, return to Claude Code.

Step 5: Test Your VMCP​

  1. In Claude Code, use the /mcp command - you should see that the VMCP is "✔ connected":
MCP Connector success state
  1. Test the VMCP tool by asking: 
    What emails have I received today?
  2. Verify Claude's response matches your expectation.