API Overview
MCP Integration

Connect Claude to MoveRight

Use Claude (Desktop or claude.ai) to look up jobs, run reports, check event status, and manage moves — all through the Model Context Protocol (MCP). Setup takes about 2 minutes.

Contents

What is MCP? Prerequisites claude.ai / Cowork Setup Claude Desktop Setup Troubleshooting

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude securely connect to external tools and data sources. When you connect Claude to MoveRight via MCP, Claude can:

  • Look up jobs by code, customer name, or status
  • Run and view operational reports
  • Check calendar event details and statuses
  • View charges, invoices, and transactions
  • Switch between zones (if you have access to multiple)

Authentication uses OAuth 2.0 with PKCE — you'll log in with your MoveRight credentials in a browser window. No API keys or tokens to manage.

Prerequisites

  • You must have logged in to MoveRight at least once. If you've never logged in to moveright.app, your account won't be linked to the authentication system and Claude won't be able to connect. Log in at moveright.app first, then come back here.
  • A MoveRight account with an employee or admin role (customers cannot use MCP)
  • Claude Desktop (Mac or Windows) or a Claude Pro/Max/Team plan on claude.ai

Need the credentials? Log in to MoveRight → click your avatar → Account → scroll to Connected Applications → click New Connection → choose Claude. The setup wizard will give you the exact config with copy buttons.

claude.ai / Cowork Setup

Step 1 — Open Settings

Go to claude.ai (or your Claude Cowork instance), click your name in the bottom-left corner, then choose Settings.

Step 2 — Add a custom connector

Click the + icon at the bottom of the window, then choose Connectors → Add Connector → Add custom connector.

Step 3 — Enter the connector details

Fill in the following fields:

Name 
Move Right
MCP Server URL 
https://moveright.app/api/mcp
OAuth Client ID 
c68f594d-6651-4da9-ab83-f4cb2ba86961
OAuth Client Secret 
BKi701asW-Ju9TX1lLNm0tDrKObGg4iPppJcPWw5kbQ

Step 4 — Authorize

Click Add. A browser window will open for OAuth authorization. Log in with your MoveRight credentials.

Step 5 — Start chatting

In a new chat, look for the hammer icon (🔨) in the chat input to confirm MoveRight tools are active.

Claude Desktop Setup

Step 1 — Open the config file

Open Claude Desktop and go to Settings → Developer → Edit Config. This opens the claude_desktop_config.json file in your text editor.

Step 2 — Add the MoveRight MCP server

Add the MoveRight server to the mcpServers section. Copy and paste this config:

claude_desktop_config.json
{
  "mcpServers": {
    "moveright": {
      "type": "url",
      "url": "https://moveright.app/api/mcp",
      "clientId": "c68f594d-6651-4da9-ab83-f4cb2ba86961",
      "clientSecret": "BKi701asW-Ju9TX1lLNm0tDrKObGg4iPppJcPWw5kbQ"
    }
  }
}

Note: If you already have other MCP servers in the config, add the "moveright" entry inside the existing "mcpServers" object — don't create a second "mcpServers" key.

Step 3 — Restart Claude Desktop

Save the config file and fully quit Claude Desktop (not just close the window — quit from the menu bar / system tray). Reopen Claude Desktop.

Step 4 — Authorize with MoveRight

When you start a new chat, Claude will detect the MoveRight MCP server and open a browser window for OAuth authorization. Log in with your MoveRight email and password. If you have 2FA enabled, enter your authenticator code when prompted.

After you log in, the browser will redirect back to Claude and the connection is established.

Step 5 — Start chatting

Look for the hammer icon (🔨) in the chat input to confirm MoveRight tools are active. Try asking:

  • "Look up job MOV-1234"
  • "What events are booked for tomorrow in Kansas City?"
  • "Show me the ops readiness report for this week"

Troubleshooting

"Automatic client registration isn't supported"

This means Claude tried to auto-register but MoveRight doesn't support it. Make sure you've included both the clientId and clientSecret in the config. The values are in the setup steps above.

"Authorization with Move Right failed"

This usually means your MoveRight account doesn't have an employee or admin role, or your account hasn't been linked to FusionAuth yet. Make sure you've logged in to MoveRight at least once, and contact your MoveRight administrator to verify your account has the correct role and permissions.

"Role required" or "Current zone not set"

Your MoveRight user may have duplicate accounts (e.g. a customer profile and an employee profile with the same email). Contact support to have the accounts consolidated.

"Invalid redirect_uri"

The redirect URI Claude uses (https://claude.ai/api/mcp/auth_callback) must be registered in FusionAuth. This is already configured — if you see this error, it may be a temporary issue. Try again, and if it persists, contact support.

Tools aren't showing up

Quit Claude Desktop completely and reopen it. If tools still don't appear, check that the JSON config is valid (no trailing commas, proper brackets).

Need more help?

Contact MoveRight support at support@moveright.app or through the in-app chat.