PrintHive

Print Hive for Codex

Codex connects to the production MCP server at https://api.printhiv3d.com/v1/mcp through OAuth. The real install path is codex mcp add or ~/.codex/config.toml — not a webpage button.

Prerequisites

  • A current Codex CLI or Codex desktop installation
  • A Print Hive account with access to the organization you want to manage
  • HiveLink online for any printer you want to inspect or control

Add the remote MCP server

codex mcp add print-hive --url https://api.printhiv3d.com/v1/mcp
codex mcp login print-hive

Equivalent ~/.codex/config.toml entry:

[mcp_servers.print-hive]
url = "https://api.printhiv3d.com/v1/mcp"

Codex discovers OAuth from the MCP endpoint. Do not add an API key.

Authorize Print Hive

  1. Run codex mcp login print-hive if the add step did not already open a browser.
  2. Sign in to Print Hive, review the requested permissions, select the correct organization, and approve the connection.
  3. Start a new Codex thread. Open /mcp and confirm print-hive is connected.

Verify the installation

codex mcp list
codex mcp get print-hive

Start with a read-only prompt:

List my printers and separate connectivity from print activity.

Optional: official plugin marketplace

If you also want bundled skills, the marketplace is published from PrintHive/print-hive-plugins:

codex plugin marketplace add PrintHive/print-hive-plugins
codex plugin add print-hive@print-hive

Update or remove

codex mcp logout print-hive
codex mcp remove print-hive

Security boundaries

  • OAuth access is bound to your selected Print Hive organization and granted scopes.
  • Printer access codes and local host credentials are entered only in the Print Hive web app.
  • Write and printer-control tools resolve an explicit target and may require confirmation before execution.
  • Raw G-code, direct temperature control, and emergency actions are not implicitly granted by the OAuth connection.

Troubleshooting

  • Server is missing — run codex mcp list and confirm the [mcp_servers.print-hive] table in ~/.codex/config.toml.
  • OAuth is disconnected — run codex mcp login print-hive again.
  • Printer is offline — verify HiveLink and network health before retrying a control action.