Home

Documentation

Connect an AI Assistant (MCP)

3D Print Log can connect to AI assistants such as Claude and ChatGPT using the Model Context Protocol (MCP). Once connected, the assistant can read your prints, printers, and material inventory. With your permission, it can also log and update prints and manage your projects, printers, and materials. That lets you ask things like “how much PLA do I have left?” or say “log the print I just finished.”

What the assistant can and can’t do

  • Reads and writes your print data. The assistant can view your prints, printers, and materials. With your permission, it can also log new prints, edit them, and manage your projects, printers, and material inventory.
  • It can’t delete anything. There is no way for the assistant to delete a print, project, or spool. Its changes are limited to creating and editing.
  • Your data only. It can only ever see or change records you created, never another user’s prints, even public ones.
  • No photos, comments, or files. Only structured data (titles, statuses, material usage, dates, and stats) is shared.
  • It won’t touch the machine itself. The assistant works on your records, not your hardware: it can’t start, stop, or send anything to a printer. Logging a print records what happened, and it never changes which filament is currently loaded on a printer. You still load and unload spools yourself.
  • Print settings only where you saved them. Layer height, speeds, and temperatures aren’t separate fields; they live in a print’s notes. If you imported the print through a slicer integration, that summary is saved for you and the assistant can read it back. For a print logged by hand with no such notes, the assistant has nothing to read and can’t answer.

Questions you can ask

You don’t need to learn any commands; just ask in your own words. These are only examples to give you a feel for it. Anything you could work out from your own prints, printers, and inventory is fair game.

  • Your prints. “How many prints did I finish last year, and how many failed?” You can search by name or project (“what was that soap dish I printed?”), and ask what a print used, including each color of a multi-color print.
  • Your materials. “What blue PLA do I have, and where is each spool stored?” Searches match whole words, so PLA also finds PLA+ and PLA (Polylactic Acid), and blue also finds Light Blue.
  • Enough for a print. “I have a 300 g model. Do I have blue PLA for it?” The assistant reports whether a single spool covers it, or only several spools combined, which would mean swapping filament mid-print.
  • Your printers. “What’s loaded on my Bambu right now?” and per-printer stats such as success rates and total print time.
  • The settings you used. “What layer height and speeds did I use on the soap dish?” This is answerable for prints whose notes hold a slicer summary (see the limitation above).

Changes it can make for you

With your permission, the assistant can also make changes for you. It always acts as you, on your own data. Again, the list below is a starting point rather than a menu. If it fits within the limits above, it’s worth asking for.

  • Log a finished print. “Log that Benchy I just finished on the Bambu. It used about 12 g of the gray PLA.” It records the status, print time, notes, and material used, and can file the print under a project. A multi-color print can list what each material contributed, and you can give either the amount you measured or the slicer’s estimate.
  • Edit a print. “Mark that print a partial success and note that the top layer lifted.” You can update the status, notes, time, material usage, or which project a print belongs to.
  • Set who can see a print. “Make that print public.” New prints follow your account default unless you say otherwise, and you can change a print to private, unlisted, or public later.
  • Organize projects. “Start a project called Desk Organizer” or “mark the planter project complete.” Create and rename projects and set whether each one is private, unlisted, or public.
  • Add a printer. “Add my new Bambu Lab X1 Carbon.” It can also fill in the details you mention (nozzle size, bed dimensions, heated bed or chamber), edit them later, or retire a printer you no longer use.
  • Add material. “Add a new 1 kg spool of Prusament Galaxy Black PLA.” New material goes straight into your inventory. This isn’t just filament: resin and powder work too, along with details like brand, color, finish, price, and where you store it.
  • Update material details. “Move the blue PLA to Dry Box B” or “mark the Galaxy Black as a favorite.” Storage location, color, temperatures, and purchase details can all be corrected after the fact.
  • Correct what’s left. “I weighed the gray PLA. It’s actually 640 g now.” Adjust a spool’s remaining amount up or down. It can’t go below empty or above what the spool started with, so if a correction is refused, check the starting amount on the spool itself.
  • Retire or restore a spool. “Retire the empty black roll” hides a finished spool from your inventory; you can bring it back later.

Most of the value comes from combining these in one go, rather than doing them one at a time. “Log the three prints I finished this weekend, file them under a new Desk Organizer project, and tell me how much filament they used between them” is a single request, and the assistant works out the steps. If you’re not sure whether something is possible, just ask for it and see.

Logging is safe to repeat: asking twice for the same print won’t create a duplicate. Because a slicer integration may already have imported a print for you, the assistant will usually check before logging one itself.

What you’ll need

Two values. Your AI client asks for both.

MCP endpoint URL
https://api.3dprintlog.com/mcp
OAuth Client ID
uzxvtpefYIrWoYbaJteoRzZtIYw4wP7j

The Client ID is the same for everyone and is safe to share. It identifies the 3D Print Log connector, not you. There is no client secret. You still sign in yourself, and the assistant only ever sees your own data.

Connect to Claude

  1. In Claude (web or desktop), open Settings → Connectors and choose Add custom connector.
  2. Paste the MCP endpoint URL above.
  3. Open Advanced settings and paste the OAuth Client ID. Leave the client secret blank.
  4. When prompted, sign in to 3D Print Log and authorize access to your print data.
  5. Start a chat and ask about your prints, printers, or filament, or ask Claude to log or update a print. Claude will use the connector when relevant.

Connect to Claude Code

Run this, then use /mcp to sign in:

claude mcp add --transport http printlog https://api.3dprintlog.com/mcp --client-id uzxvtpefYIrWoYbaJteoRzZtIYw4wP7j --callback-port 8400

If port 8400 is already in use on your machine, any port from 8400 to 8405 will work.

Connect to ChatGPT

  1. In ChatGPT, open the custom connector / app setup and choose to add an MCP server.
  2. Enter the MCP endpoint URL, and the OAuth Client ID where prompted.
  3. Complete the sign-in and consent prompt to grant access to your print data.

Managing connected assistants

You can review and disconnect connected AI assistants at any time from your Settings page under Connected AI Agents. Disconnecting immediately revokes access for all connected assistants.