Connect Codex to Show3D

Before you start

Have these three things ready. You do not need to configure an MCP server URL manually.

Codex desktop is open and signed in
You are signed in to Show3D in your browser
A Show3D modeling scene is created or open

Run the one-line installer

Keep Codex desktop open, choose your system, then paste and run the one-line command below in your terminal.

Open Terminal, paste the command, and press Return.

macOS / Linux

curl -fsSL https://www.show3d.com/codex/show3d/install.sh | sh

When the terminal says the marketplace has been registered, return to Codex and choose Install or Connect on the Show3D plugin page. If it does not appear, fully quit and reopen Codex, then find Show3D in Plugins.

Click Install in Codex

The installer attempts to open the Show3D plugin page. Choose Install or Connect, then complete the authorization prompts. Restart Codex if the installed plugin is not yet available.

Authorize your Show3D account

After clicking Install, follow the connection prompt in Codex to authorize your Show3D account in the browser.

1Your browser opens Show3D authorization. Sign in first if needed.
2Confirm the Show3D account and choose Allow connection.
3After the browser says Authentication complete, return to Codex and confirm authorization succeeded.

A 127.0.0.1 address is expected

This is a temporary local OAuth callback created by Codex. Close the tab after it says Authentication complete, and never share the code in the address bar.

Make the current scene available

After account authorization, Codex can connect only to a scene page that you actively have open.

1Open the scene you want to model in Show3D.
2Open AI workspace, choose Codex under Agent, and expand Connection and setup.
3Enable Allow scene access and check that the status says Connected.
4Keep this page open while Codex is modeling.

Codex → Connection and setup; scene access is off in this screenshot

Closing the page, signing out, or switching scenes invalidates the old scene connection. This is scene-scoped access and does not revoke your Show3D account authorization.

Test the connection in Codex

Start by listing the open scenes. Choose the intended scene, then ask Codex to inspect it before requesting an edit.

Send this to Codex

List my currently open Show3D scenes and let me choose the scene to connect. Do not modify any scene.

Codex successfully finds the current scene

The connection is ready when

Codex lists the intended scene and you select it for the task
Connection and setup for Codex still shows Connected in Show3D
The read-only test does not change the scene

Troubleshooting

Setup complete

Keep the Show3D scene page open. You can now return to Codex and start modeling.

Open Show3D modeling

Before you start

Have these three things ready. You do not need to configure an MCP server URL manually.

Codex desktop is open and signed in
You are signed in to Show3D in your browser
A Show3D modeling scene is created or open

Run the one-line installer

Keep Codex desktop open, choose your system, then paste and run the one-line command below in your terminal.

Open Terminal, paste the command, and press Return.

macOS / Linux

curl -fsSL https://www.show3d.com/codex/show3d/install.sh | sh

Click Install in Codex

The installer attempts to open the Show3D plugin page. Choose Install or Connect, then complete the authorization prompts. Restart Codex if the installed plugin is not yet available.

Authorize your Show3D account

After clicking Install, follow the connection prompt in Codex to authorize your Show3D account in the browser.

1Your browser opens Show3D authorization. Sign in first if needed.
2Confirm the Show3D account and choose Allow connection.
3After the browser says Authentication complete, return to Codex and confirm authorization succeeded.

A 127.0.0.1 address is expected

This is a temporary local OAuth callback created by Codex. Close the tab after it says Authentication complete, and never share the code in the address bar.

Make the current scene available

After account authorization, Codex can connect only to a scene page that you actively have open.

1Open the scene you want to model in Show3D.
2Open AI workspace, choose Codex under Agent, and expand Connection and setup.
3Enable Allow scene access and check that the status says Connected.
4Keep this page open while Codex is modeling.

Closing the page, signing out, or switching scenes invalidates the old scene connection. This is scene-scoped access and does not revoke your Show3D account authorization.

Test the connection in Codex

Start by listing the open scenes. Choose the intended scene, then ask Codex to inspect it before requesting an edit.

Send this to Codex

List my currently open Show3D scenes and let me choose the scene to connect. Do not modify any scene.

The connection is ready when

Codex lists the intended scene and you select it for the task
Connection and setup for Codex still shows Connected in Show3D
The read-only test does not change the scene

Troubleshooting

Setup complete

Keep the Show3D scene page open. You can now return to Codex and start modeling.

Open Show3D modeling

Before you start

The connection is ready when

Troubleshooting

The plugin page did not open after the command

The authorization page keeps waiting or asks me to sign in

OAuth succeeded, but Codex cannot see a scene

Why must I select the scene again after refreshing?

How do I update Show3D later?

Setup complete

Before you start

The connection is ready when

Troubleshooting

The plugin page did not open after the command

The authorization page keeps waiting or asks me to sign in

OAuth succeeded, but Codex cannot see a scene

Why must I select the scene again after refreshing?

How do I update Show3D later?

Setup complete