Cursor Setup

Connect Cursor to your print farm by adding a JSON config file. Once connected, Cursor's AI can control printers, check job status, and manage your fleet while you code.

Prerequisites

• Cursor IDE installed
• A PrintHive API key (generate one in Settings → API Keys)

Configuration

Create a .cursor/mcp.json file in your project root (or home directory for global access):

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

Replace YOUR_API_KEY with your actual API key.

Enable in Cursor

1. Open Cursor Settings (Cmd+, / Ctrl+,)
2. Navigate to Features → MCP Servers
3. Verify that hive-mcp appears in the server list
4. Toggle it on if it's not already enabled

Usage

Open Cursor's AI chat (Cmd+L) and ask about your printers. Cursor will automatically use the MCP tools when relevant:

> List all my printers

Example Prompts

• Show the status of all my printers
• Pause the print running on my X1C
• What filaments are loaded in the AMS?
• Set fan speed to 80% on Alphonse
• Show me recent print jobs

Troubleshooting

• Server not appearing — Make sure the .cursor/mcp.json file is in your project root or ~/.cursor/mcp.json for global config. Restart Cursor after adding the file.
• Authentication errors — Double-check your API key. Generate a new one in Settings if the current one is invalid.
• Tools not available — Ensure the MCP server is enabled in Cursor Settings → Features → MCP Servers.