Claude Code Setup

Connect Claude Code to your print farm with a single CLI command. Once connected, you can control printers, check status, and manage jobs directly from your terminal.

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
A PrintHive API key (generate one in Settings → API Keys)

CLI Setup

Run this command to add the Hive MCP server:

claude mcp add hive-mcp \
  --transport http \
  --url https://api.printhiv3d.com/v1/mcp \
  --header "x-api-key: YOUR_API_KEY"

Replace YOUR_API_KEY with your actual API key.

Manual Configuration

Alternatively, add this to your .claude/settings.json:

{
  "mcpServers": {
    "hive-mcp": {
      "type": "streamable-http",
      "url": "https://api.printhiv3d.com/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Verify Connection

Start Claude Code and ask it to list your printers. If the connection is working, you'll see your printer fleet:

> List all my printers

Example Prompts

Once connected, try these:

List all my printers and their current status
What's the live status of my printer named "Alphonse"?
Pause the print on Alphonse
Set the speed to ludicrous on all printers
Show me the AMS filament info for my X1C
What files are on my printer?
Turn on the chamber light on Alphonse
Show me temperature data for job #42

Troubleshooting

Authentication errors — Verify your API key is correct and hasn't been revoked. Generate a new one in Settings if needed.
Printer offline — Live status and control tools require the printer to be online and connected via HiveLink. Check that HiveLink is running.
Tools not showing — Run claude mcp list to verify the server is registered. Remove and re-add if needed.