---
title: Set up Turn Zero Tools in Codex
description: Connect Turn Zero to Codex in a terminal, editor, or the desktop app.
slug: /getting-started/set-up-codex
order: 3
visibility: public
redirects_from: []
---

# Set up Turn Zero Tools in Codex

Before adding or changing a connection, check whether `start` works and the tzTrack or tzMesh tools you need are available. Reuse a working `turnzero` connection. Ask once before changing the setup. In a managed workspace, give the person the host's connector steps. A command run inside the workspace does not configure the host.

Use `https://turnzero.ai/mcp`, named `turnzero`, for Claude Code and Codex. This connection provides tzCloud, tzTrack and tzMesh tools within your account’s access. A desktop or editor that shares the CLI configuration reuses it; add no second connection there.

Reuse an existing connection that provides the tools you need. Before changing it, check its address and whether your current session can load its tools.

For a picture, call `generate_image` with a prompt. You need no application. The picture stays in your account for seven days; download it before then. [Generate an image with your AI assistant](https://turnzero.ai/cloud/guides/generate-an-image-from-your-ai-tool/) explains the download link and how to renew it.

## Codex CLI or editor extension

After approval, add `turnzero` from a terminal. Use this address:

```text
codex mcp add turnzero --url "https://turnzero.ai/mcp"
```

The person completes browser sign-in while the command waits. If it finishes without signing them in, run `codex mcp login turnzero`. If you're the AI, keep a waiting sign-in running and poll it. Give it at least five minutes before treating silence as a problem. If the browser cannot open, give the person the authorization link. Keep tokens and callback URLs out of chat.

## Codex desktop app

If the desktop app shares your CLI configuration, reuse `turnzero` and start a new conversation. Otherwise, follow the [desktop connector steps](/tztools/getting-started/set-up/#chatgpt-desktop). A separately configured desktop connection may be absent from `codex mcp list`.

## Check in a new conversation

Start a new Codex conversation so it loads the tools, then paste:

```text
Check my Turn Zero connection. Call start, then check that tzTrack and tzMesh tools are available. If a call fails or a tool is unavailable, tell me what happened.
```
