> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Connect SimplyPrint to Claude (claude.ai and Claude Code) # Connect SimplyPrint to Claude (claude.ai and Claude Code) SimplyPrint has an official MCP server, which means you can plug it straight into Claude and just tell Claude what to do with your printers, queue, files and filament. This guide walks through connecting SimplyPrint to both flavours of Claude: the web app at claude.ai (and the Claude desktop app) and the Claude Code CLI. || You need a Claude account that supports custom connectors. On claude.ai that is currently the Pro, Max, Team and Enterprise plans. Claude Code works on any plan. ## What you can do once connected Once Claude has the SimplyPrint connector, you can ask things like: - "What's printing right now across all my printers?" - "Pause every printer - I need to swap filament." - "Queue five copies of benchy.gcode on the Bambu." - "Show me what went wrong with the last three failed prints." - "Which spools have less than 100 grams left?" Claude picks the right SimplyPrint action, asks you to confirm anything destructive, and reports back in plain English. ## Connect claude.ai (web and desktop app) The steps below use the web app at claude.ai. The Claude desktop app has the same Connectors screen, so the flow is identical. ### 1. Open Claude Head to [claude.ai](https://claude.ai) and sign in. ![Claude home screen with chat box in the middle](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-claude-home_raoqo1.png) ### 2. Open the Customize menu In the left sidebar, click **Customize**. ![Claude left sidebar with the Customize option highlighted](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-customize_1nks3km.png) ### 3. Open Connectors In the Customize menu, select **Connectors**. This is where Claude lists every tool it can connect to, including official connectors and your own custom ones. ![The Connectors screen with a + button for adding a connector](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-connectors_1c1hm9b.png) ### 4. Add a custom connector Click the **+** button, then choose **Add custom connector**. Fill in the form: - **Name:** `SimplyPrint` - **Remote MCP server URL:** `https://simplyprint.io/api/mcp` Leave advanced settings at their defaults and click **Add**. ![The Add custom connector dialog with SimplyPrint name and MCP URL filled in](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-add-custom-_11oynl3.png) | We have submitted SimplyPrint to Anthropic's official plugin directory for Claude Code and Cowork. Once approved you will be able to install it in one click from Claude's plugin store. For claude.ai web and desktop, the custom-connector step above is the supported route for now; we may pursue listing in the Claude.ai Connectors Directory later. ### 5. SimplyPrint appears in your connectors Claude now shows SimplyPrint in the Connectors list, ready to use. ![The Connectors list with SimplyPrint added as a custom connector](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-mcp-added_1cynosj.png) ### 6. Ask Claude something that uses SimplyPrint Start a new conversation and ask something printer-related, like "What's printing right now?". The first time Claude needs to call a SimplyPrint tool, it asks for permission. ![Claude asking for permission to use the SimplyPrint connector](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-ask-mcp-fir_1gmio13.png) ### 7. Approve access in SimplyPrint A SimplyPrint login window opens. Log in (if you are not already) and you land on the SimplyPrint consent screen, showing the scopes Claude is asking for - read printers, manage queue, and so on. Approve the ones you are happy with and click **Authorize**. ![The SimplyPrint authorization screen with the list of scopes Claude is requesting](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-mcp-authori_nbapyb.png) ||| Only grant the scopes you actually want Claude to have. You can leave "Manage" scopes off for a read-only connection, and you can revoke access any time from **Account settings > Connected apps**. ### 8. Claude responds using your SimplyPrint data The window closes and Claude completes its answer using live data from your SimplyPrint account. ![Claude returning a live printer status report from SimplyPrint](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/claude-integration-mcp-respons_1h6wvwl.png) That's it - you are connected. You never need to redo this flow; Claude remembers the connection until you remove it. ## Connect Claude Code (CLI) Claude Code is Anthropic's command-line coding assistant. SimplyPrint ships as a first-party plugin on the Claude Code marketplace. ### Install the plugin From any Claude Code session, run: `/plugin marketplace add simplyprint/simplyprint-claude-plugin` `/plugin install simplyprint@simplyprint` `/reload-plugins` | The first command registers the SimplyPrint marketplace. The second installs the plugin itself. The third picks up the new slash commands and tools in your current session; if you skip it, restart Claude Code instead. You only need to do this once per machine. ### First-time OAuth The first time you invoke any SimplyPrint tool in Claude Code, it opens a browser window for OAuth - the same consent screen shown above. Approve the scopes you want and Claude Code caches the token locally. ### What you get The plugin bundles: - The SimplyPrint MCP server, so tools like `list_printers`, `pause_print`, `home_printer`, `send_gcode`, `list_queue` become available to Claude - Starter slash commands: `/simplyprint:farm-status`, `/simplyprint:queue-print`, `/simplyprint:pause-all`, `/simplyprint:printer-detail` You can ask Claude Code things like *"give me a one-line status for every printer in the shop"* or *"pause all printers, I need to change filament"* and it will drive SimplyPrint for you. ## Claude Desktop Claude Desktop uses the exact same Connectors screen as claude.ai. Follow the eight-step flow above - the screenshots match what you see in the desktop app. ## Scopes Claude asks for When you authorize SimplyPrint from Claude, you get a checklist of scopes. Approve only what you want. | Scope | What it lets Claude do | | ----- | ---------------------- | | View your printers' details | See names, status, current print, bed temperature | | Operate your printers | Pause, resume, cancel, home, send G-code | | View your print queue | List queue items, view details, see pending approvals | | Manage your print queue | Add items, reorder, edit, delete, approve, deny | | View your files and folders | List files, search by name, estimate print cost | | Manage your files and folders | Move, rename, delete, create folders | | View filament spools | See remaining weight, assignments, drying status | | Manage filament spools | Adjust weight, assign to printers, mark dried | | View your print history | See past jobs, success/failure, filament used | | Manage your print history (archive, restore) | Archive and unarchive jobs | | View your print statistics | Success rate, filament totals, cost summaries | | View your custom fields | List field definitions (deadline, order number, etc.) | | Manage your custom fields and their values | Set values across queue items (sort by deadline, etc.) | | View your slicer profiles | Look up which slicer settings were used on a file | ||| Claude cannot change your subscription, delete your account, pay invoices, or do anything outside the scopes you granted. Billing and account-deletion are off-limits to every connected app. ## Revoking access To disconnect Claude, go to **Account settings > Connected apps** in SimplyPrint and click **Revoke** next to the Claude entry. The connection stops working immediately. If you want to use Claude with SimplyPrint again afterwards, you just run through the authorization flow once more. ## Troubleshooting **Claude does not offer SimplyPrint as a tool.** Check that the connector actually appears in **Customize > Connectors**. If it is greyed out, your Claude plan may not support custom connectors - you need Pro, Max, Team or Enterprise. **Authorization window closes without doing anything.** Make sure pop-ups are enabled for claude.ai. Some browsers block the SimplyPrint login window silently. **Claude says it cannot perform an action.** Most likely the scope was not granted. Revoke access in SimplyPrint, trigger a SimplyPrint action in Claude again, and approve the missing scope on the consent screen. **Claude in Claude Code does not see SimplyPrint tools.** Run `/plugin` to open the plugin manager and check the **Installed** tab for `simplyprint@simplyprint`. If it is not listed, re-run the install commands above. If it is listed but the tools are missing, run `/reload-plugins` or restart Claude Code. ## Related articles - [Connect SimplyPrint to any AI assistant via MCP](https://help.simplyprint.io/en/article/connect-simplyprint-to-any-ai-assistant-via-mcp-u5j4bw/) - [Connect SimplyPrint to Gemini CLI](https://help.simplyprint.io/en/article/connect-simplyprint-to-gemini-cli-17tmpns/) - [SimplyPrint API documentation](https://apidocs.simplyprint.io) - [The print queue](https://help.simplyprint.io/en/article/the-print-queue)