OneRange Vero

Connect Vero to Claude with MCP: A Step-by-Step Guide

· 5 min read · OneRange Product Team

Bring your Vero training data, courses, and skills directly into Claude using the Model Context Protocol — set up OAuth or a personal API token in minutes

Claude's Model Context Protocol (MCP) lets you bring outside tools and data directly into your Claude conversations. With Vero's MCP server, you can ask Claude about your courses, assignments, skills, and learner progress without ever leaving the chat. This guide walks through both ways to connect — OAuth (recommended) and a personal API token — and how to troubleshoot the most common setup issues.

Before you start

  • A Claude account on a paid plan (Pro, Team, or Enterprise) — MCP connectors are not available on the free tier
  • Admin access to your Vero workspace (required to authorize the connector)
  • 5 minutes

Connection details

Whichever method you choose, you'll point Claude at the same Vero MCP server:

  • Server URL: https://mcp.onerange.ai
  • Transport: HTTP (Streamable)
  • Auth: OAuth 2.1 or Personal API Token
  • Access: Read-only

Option 1 — Connect with OAuth (recommended)

OAuth is the simplest path. Claude redirects you to Vero, you authorize the connection, and Vero issues a short-lived token that Claude refreshes automatically. No keys to copy or rotate.

  • Sign in to Claude at claude.ai and open Settings → Connectors
  • Click Add connector and choose Custom connector
  • Enter the name "Vero" and the server URL https://mcp.onerange.ai
  • Click Connect — Claude will open a Vero sign-in window
  • Sign in with your Vero admin account and click Authorize
  • Back in Claude, enable the Vero connector for the chats where you want to use it
  • Test it by asking: "List my Vero courses"

Option 2 — Connect with a Personal API Token

If your organization blocks OAuth pop-ups, or you want a token tied to a specific service account, use a Personal API Token instead.

  • In Vero, go to Settings → MCP and click Generate token
  • Copy the token (it starts with vero_pat_) — you won't be able to see it again
  • In Claude, go to Settings → Connectors → Add connector → Custom connector
  • Enter the server URL https://mcp.onerange.ai
  • Under Authentication, choose Custom headers and add: Authorization: Bearer vero_pat_xxxxx and Accept: application/json, text/event-stream
  • Save, then enable the connector in your chat

You can verify the token from a terminal with: curl -H "Authorization: Bearer vero_pat_xxxxx" -H "Accept: application/json, text/event-stream" https://mcp.onerange.ai/health

Troubleshooting

A few issues come up regularly — here's the short list and the fix for each:

  • "Connectors aren't available on your plan" — MCP requires a paid Claude plan. Upgrade and the option reappears in Settings
  • 401 Unauthorized — your token expired or was revoked. Generate a new one in Vero Settings → MCP
  • 406 Not Acceptable — the Accept header is missing. Make sure it includes both application/json and text/event-stream
  • Claude doesn't see the tools — the connector is added but not enabled in the current chat. Open the chat's tool menu and turn Vero on
  • OAuth pop-up blocked — allow pop-ups for claude.ai and onerange.ai, or fall back to the Personal API Token method
  • Connection times out — confirm your network allows outbound HTTPS to mcp.onerange.ai

What you can do once it's connected

Once Vero shows up in Claude's tool list, you can ask things like "Summarize how my team performed on the Discovery Calls course last month," "Which skills do my new hires struggle with most?" or "Draft a coaching plan for reps who scored below 70% on objection handling." Claude pulls live data from Vero, reasons over it, and gives you an answer grounded in your actual training results.

If you hit something not covered here, reach out to your Vero contact or email support — we'll get you connected.

Tags: Product, MCP, Integrations