Connect Claude Code or Codex

In this guide, you connect an AI agent to your org. Then you ask the agent to build a workflow. The agent uses tabletop through MCP. See Agents (MCP and the CLI).

You need Claude Code or Codex on your computer, and a terminal.

Way	For	You need
An API token	Claude Code and Codex	An API token that you make in the app.
Your sign-in	Claude Code	Only your tabletop sign-in.

Connect with an API token

1. Make the token

Click your avatar, then Organization settings.
Open API tokens.
Type a Token name, such as “Claude Code on my laptop”.
In Days, type how many days the token works, such as 90.
Select the scopes. To let the agent build and run workflows, select Read workflows, Change workflows and Start runs.
Click Create token.
The API tokens tab with a token name, 90 days and three scopes
guides/connect-agent-create-token

2. Run the command

tabletop shows the token one time, with a command for Claude Code and a command for Codex.

Click Copy next to the command of your agent.
The new token with the Claude Code and Codex commands
guides/connect-agent-commands
Paste the command in a terminal. Press Enter.
Click Done in tabletop.

The command adds tabletop to your agent. The Claude Code command looks like this:


claude mcp add --transport http tabletop https://app.tt3d.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"

For Codex, the app shows two lines. The first line sets TABLETOP_TOKEN. Put that line in your shell profile too, so that Codex finds the token in each new terminal.

Keep the token secret. Anyone with the token can act in your org with its scopes.

In a terminal, add tabletop to Claude Code with the MCP address https://app.tt3d.ai/mcp:
```
claude mcp add --transport http tabletop https://app.tt3d.ai/mcp
```
Start Claude Code. Type /mcp, pick tabletop, then pick Authenticate.
Your browser opens tabletop. The page says “Claude Code wants to use tabletop for you”.
In In the organization, pick your org.
Click Allow.
The page Claude Code wants to use tabletop for you, with the org list and Allow
guides/connect-agent-allow

Try it

Ask your agent a task in plain words. For example:

“List my tabletop workflows.”
“Make a tabletop workflow that makes a 3D model of a wooden barrel from a prompt. Then run it.”
“How many tokens does my org have?”

Open the workflow in tabletop while the agent works. The agent shows as an avatar at the top right, with the tooltip “Agent of” and your name. You see each node that it adds or changes.

A workflow with the avatar of the agent and a node that the agent adds

guides/connect-agent-live

A run that the agent starts costs tokens. The agent can ask for the estimate before it runs.

Stop an agent that uses a token

Open Organization settings > API tokens.
Click Revoke next to the token.

The agent can no longer use tabletop. See all the tools of the agent in MCP tools.