Connecting NautobotGPT MCP Server to Claude Code¶

This guide walks you through connecting the NautobotGPT MCP Server to Claude Code.

Prerequisites¶

Claude Code installed (see Claude Code documentation)
NautobotGPT instance
NautobotGPT MCP Server enabled for your instance
Your NautobotGPT API key (see Getting Your API Key)

Configure Claude Code¶

Claude Code natively supports remote MCP servers over HTTP. You add the server using the claude mcp add command.

claude mcp add --transport http nautobotgpt https://YOUR_NAUTOBOTGPT_INSTANCE.nautobot.cloud/mcp \
  --header "Authorization: Bearer YOUR_NAUTOBOTGPT_API_KEY"

Configuration:

https://YOUR_NAUTOBOTGPT_INSTANCE.nautobot.cloud/mcp - Your NautobotGPT MCP Server's URL
--header - Passes your NautobotGPT API key as a Bearer token

Verify Connection¶

After adding the server, verify it is configured correctly:

# List all configured MCP servers
$ claude mcp list

Checking MCP server health...

nautobotgpt: https://YOUR_NAUTOBOTGPT_INSTANCE.nautobot.cloud/mcp (HTTP) - ✓ Connected

# Get details for the NautobotGPT MCP Server
$ claude mcp get nautobotgpt

Within a Claude Code session, you can also check the server status by typing:

/mcp

Managing the Server¶

# Remove the NautobotGPT MCP Server
$ claude mcp remove nautobotgpt

Troubleshooting¶

Server Not Connecting¶

Verify server is running - Check that NautobotGPT is accessible
Check the endpoint - Ensure the URL ends with /mcp
Verify your API key - An invalid NautobotGPT API key will prevent successful connection
Check server status - Run /mcp within a Claude Code session to see the connection status