Claude

Claude Code, Claude.ai, and Claude Desktop can connect to remote HTTP MCP servers. The Claude Messages API can also connect to remote MCP servers through the MCP connector.

Use the full MCP URL from Setup:

https://mcp.vrplatform.app/

If you want a default team for the session, append ?team_id=<team-id>. Name the local MCP server vrplatform.

Claude Code

Add the server with the Claude Code CLI:

claude mcp add --transport http vrplatform "https://mcp.vrplatform.app/"

You can also use JSON configuration:

claude mcp add-json vrplatform '{
  "type": "http",
  "url": "https://mcp.vrplatform.app/"
}'

Inside Claude Code, run /mcp to confirm that the server connected and to complete the OAuth sign-in if the server shows as needing authentication.

Claude.ai And Claude Desktop

In Claude.ai or Claude Desktop, go to Settings > Connectors, add a custom connector with the MCP URL https://mcp.vrplatform.app/, and complete the OAuth prompt to sign in with your VRPlatform account.

Claude API

The Claude Messages API MCP connector currently exposes MCP tools to the model. It does not replace a full MCP client for MCP prompts or resources.

The Messages API cannot open a browser to sign in, so a bare MCP URL fails with an authentication error. Pass an OAuth access token as authorization_token on the mcp_servers entry, or use the ?api_key=<api-token> fallback URL instead.

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic();

const response = await anthropic.beta.messages.create({
  model: 'claude-sonnet-5',
  max_tokens: 1000,
  betas: ['mcp-client-2025-11-20'],
  messages: [
    {
      role: 'user',
      content: 'Use VRT MCP to check the server status.',
    },
  ],
  mcp_servers: [
    {
      type: 'url',
      name: 'vrplatform',
      url: 'https://mcp.vrplatform.app/',
      authorization_token: '<oauth-access-token>',
    },
  ],
  tools: [
    {
      type: 'mcp_toolset',
      mcp_server_name: 'vrplatform',
    },
  ],
});

console.log(response);

name and mcp_server_name must match. The server name is separate from the vrplatform:// MCP resource URIs returned by the VRPlatform MCP server.

API Token Fallback

If your Claude environment cannot complete OAuth, use an API-token URL from Setup:

claude mcp add --transport http vrplatform "https://mcp.vrplatform.app/?api_key=<api-token>"

References

• Claude Code MCP configuration
• Claude API MCP connector