Setup: Claude Code

Connect the Central MCP Server to Claude Code, Anthropic's terminal-based AI assistant, to query your Central network from the terminal using natural language.

Before You Begin

Complete Find Your Base URL & API Credentials from the main setup guide first.

Register the Server

Run this command once to register the Central MCP Server with Claude Code:

claude mcp add central-mcp \
  -e CENTRAL_BASE_URL=your-central-base-url \
  -e CENTRAL_CLIENT_ID=your-client-id \
  -e CENTRAL_CLIENT_SECRET=your-client-secret \
  -- uvx --prerelease=allow central-mcp-server

Replace all placeholder values with your actual credentials.

📘

Credential security

See How credentials stay secure.

Configuration Scope

By default, claude mcp add registers the server at the user level. This means that the Central MCP server will be available across all your projects. To scope it to a single project only, add -s project to the command before the server name:

claude mcp add -s project central-mcp \
  -e CENTRAL_BASE_URL=your-central-base-url \
 -e CENTRAL_CLIENT_ID=your-client-id \
 -e CENTRAL_CLIENT_SECRET=your-client-secret \
 -- uvx --prerelease=allow central-mcp-server

Verify the Registration

claude mcp list

The output should include central-mcp with a Connected status if the server is correctly configured & connected to Central.

Run Your First Query

One-shot query:

claude -p "Which sites have poor health scores right now?"

Or start an interactive session:

A successful response retrieves live site data from your Central instance. You'll see tool call activity in the terminal as the AI searches available tools to find and call the appropriate Central APIs & provide a response.