---
title: Set up Turn Zero Tools for AI
description: Connect the Turn Zero MCP server to your AI assistant, sign in, and check that the connection works.
slug: /getting-started/set-up
order: 0
visibility: public
redirects_from: []
---

# Set up Turn Zero Tools for AI

tzTrack and tzMesh share one Turn Zero connection. You need an AI assistant that supports custom MCP servers and a browser for sign-in. Your first sign-in creates a free Turn Zero account.

## Quick setup for your AI

1. **Check your tools.** Look for `start` and the tzTrack or tzMesh tools you need, including tools your host discovers on demand. Reuse a signed-in connection that provides them.
2. **Ask once.** Say what you would add or change, which connection you will use, and where the person will sign in. If the person uses the Claude desktop app or hasn't named a Claude surface, offer both routes below in that same message. Wait for approval.
3. **Add the connection.** Use the steps for the host that supplies your tools. In a chat app or managed workspace, give the person the connector steps.
4. **Have the person sign in.** They complete browser sign-in and choose **Allow access** if asked.
5. **Verify.** Call `start` and check that the tools you need are available. If your current session cannot load the new tools, give the person the [check prompt](#check-the-connection) for a new session and report the check as pending.
6. **Offer a next step.** After verification succeeds, tell the person which products are connected. Offer these three optional starts once, then wait for their choice:

   - **tzTrack for AI:** give their AI a [shared to-do list](https://turnzero.ai/tztrack/getting-started/use-tztrack/).
   - **Image Gen:** [make their first image](/tztools/guides/generate-images/).
   - **tzMesh for AI:** see their sessions and conversations at [tzmesh.ai](https://tzmesh.ai/), or [try Claude Code and Codex together](https://turnzero.ai/dashboard/prompts#two-ai-project).

   Start none of them until the person chooses. If verification is pending, give its next step instead.

[Claude Code in a terminal](/tztools/getting-started/set-up-claude-code/) · [Claude desktop app](/tztools/getting-started/set-up-claude-desktop/) · [Codex](/tztools/getting-started/set-up-codex/)

| Claude route | Where it works | Where you sign in |
| --- | --- | --- |
| [Custom connector](/tztools/getting-started/set-up-claude-desktop/) | Claude desktop chat and Code tab, and claude.ai | Add it in Claude. Claude opens the browser for sign-in. |
| [Terminal command](/tztools/getting-started/set-up-claude-code/) | Claude Code in a terminal. A new desktop Code tab session can use the same connection. | Start from `/mcp` in terminal Claude Code. It opens the browser for sign-in. |

For desktop chat, use the custom connector. A Code tab session that shares the terminal configuration can reuse `turnzero`.

## Connect your MCP server

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.

Use `https://tztools.turnzero.ai/mcp`, named `turnzero-tools`, for tzTrack and tzMesh in a chat app. For hosting, follow [Connect your AI assistant](https://turnzero.ai/cloud/getting-started/connect-your-tool/). Each address has its own sign-in; a sign-in to one does not connect the other.

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.

The address determines which products the connection provides. [Use another product](#use-another-product) explains the routes.

## Detailed setup steps

<a id="claude-code-cli-including-the-desktop-code-tab"></a>

- [Already connected to Turn Zero](#already-connected-to-turn-zero)
- [Claude Code in a terminal](/tztools/getting-started/set-up-claude-code/)
- [Claude desktop app](/tztools/getting-started/set-up-claude-desktop/)
- [Codex CLI, editor or desktop](/tztools/getting-started/set-up-codex/)
- [Claude chat or Claude Code on the web](#claude-chat-or-claude-code-on-the-web)
- [ChatGPT desktop](#chatgpt-desktop)
- [ChatGPT or Codex on the web](#chatgpt-or-codex-on-the-web)
- [Another AI assistant](#another-ai-assistant)

### Already connected to Turn Zero?

Call `start` and check that the tzTrack or tzMesh tools you need are available. Reuse a connection that provides them. Otherwise follow the route for your AI assistant above.

### Claude chat or Claude Code on the web

1. On claude.ai, open **Settings** → **Customize** → **Add** → **Add custom connector**.
2. Enter the name and URL below. The URL field is **MCP Server URL**.

   Name:

   ```text
   turnzero-tools
   ```

   URL:

   ```text
   https://tztools.turnzero.ai/mcp
   ```

   Choose **Continue**.
3. Keep **Sign in now**, choose **Register automatically** under **OAuth client**, and leave **Request headers** empty.
4. Choose **Add**, sign in on the Turn Zero page that opens, and choose **Allow access**. If you recently signed in, the sign-in page may be skipped; choose **Allow access** if the access page appears.
5. In your chat, open **+** → **Connectors** and check that **turnzero-tools** is on. On claude.ai, keep the same conversation. Then ask your AI to check the connection.

On a Team or Enterprise plan, an owner adds the connector under **Organization settings** → **Connectors**, then each member chooses **Connect**.

Claude's desktop chat and claude.ai share the connector. If it was added with the wrong authentication choice, remove it and add it again with the settings above.

### ChatGPT desktop

If the desktop app shares your Codex CLI configuration, reuse `turnzero` and add no second connection. Otherwise, follow the steps below.

Your account and the app's settings must allow adding a custom MCP server. If your company manages this app, ask your administrator about any restriction that prevents you from adding Turn Zero.

1. Open **Settings** → **Plugins** → **Add** → **Add MCP server**.
2. Enter `turnzero-tools` as the name and select **Streamable HTTP** as the type.
3. Enter `https://tztools.turnzero.ai/mcp` as the server URL, add the server, and complete the browser sign-in when prompted.
4. Start a new chat to load the connection, then [check it](#check-the-connection).

If the app cannot add the server, you can use [Claude Code in a terminal](/tztools/getting-started/set-up-claude-code/) or [Codex](/tztools/getting-started/set-up-codex/) on your computer, where your company's policy permits it.

### ChatGPT or Codex on the web

Your ChatGPT account must allow adding and using a custom MCP server. In a company workspace, your administrator controls the permissions that may be required.

1. Open **Settings → Plugins → Browse directory → Add (+) → Add custom MCP server**.
2. Enter `turnzero-tools` as the name and `https://tztools.turnzero.ai/mcp` as the server URL.
3. Use OAuth sign-in. Check the server address in the warning, choose **I understand and want to continue**, and select **Create as a plugin**. Complete the browser sign-in and choose **Allow access** when prompted.
4. Install the resulting plugin. In ChatGPT, switch to **Work**, start a chat, type `@`, and select **turnzero-tools**. In Codex, start a new session and ask to use tzTrack or tzMesh, whichever you want.

If **Add custom MCP server** is missing or blocked, ask your workspace administrator whether you can add Turn Zero. You can instead use [Claude Code in a terminal](/tztools/getting-started/set-up-claude-code/) or [Codex](/tztools/getting-started/set-up-codex/) on your computer, where your company's policy permits it.

<a id="another-ai-tool"></a>

### Another AI assistant

Add `https://tztools.turnzero.ai/mcp`, named `turnzero-tools`, as an HTTP MCP server with OAuth sign-in. Complete the browser sign-in, then load or enable its tools as your app requires.

## Use another product

A Claude Code or Codex CLI connection at `https://turnzero.ai/mcp` provides all three products within your account’s access. Reuse it in a desktop or editor that shares the CLI configuration. In a chat app, `turnzero-tools` provides tzTrack and tzMesh. For hosting, add the separate connection described in [Connect your AI assistant](https://turnzero.ai/cloud/getting-started/connect-your-tool/) and sign in to it.

If a connection lists a tool but a call returns "Unknown tool", refresh its tool list:


- On claude.ai, open the connector's **…** menu and choose **Refresh tools list**. Keep the same conversation. After the refresh finishes, ask your AI to reload its tool list if it can and check the connection.
- In ChatGPT, use the connector's **Refresh**, then start a new chat.
- In another AI assistant, start a new session.

If tools are still missing, check the configured address against the route above and check your account’s access.

## Try it

After connecting and signing in, paste this prompt into your AI assistant. Your AI sets up issue tracking and records an issue you can work on together.

> Set up Turn Zero Track for me, then raise an issue: the sign-up page's error message is unclear.

## Tips for your AI

- Check the tools available to your session, including tools your host discovers on demand, before adding a connection. Reuse a working Turn Zero connection. A Codex desktop connection may not appear in `codex mcp list`.
- Ask once before changing setup. In one message, ask the person to approve the specific changes to their connection and the browser sign-in, then wait. Keep any earlier approval of these specific changes; ask again only if a later step goes beyond it.
- An instruction to work unattended does not approve adding an MCP server or changing its settings. Without approval, leave those changes pending and continue work that needs no approval. If your host blocks a settings change, report the block rather than bypassing it.
- Configure the host that supplies your tools. In a chat or managed cloud workspace, give the person the connector steps and wait for sign-in. Running a local MCP install command in that workspace does not configure the host's connection.
- Confirm access with `start` before reporting that setup succeeded. If tzTrack's line reports `setup_needed`, follow its next step when the person wants to set up a space.
- While a Codex sign-in command waits for the browser, keep it running and poll its session handle. Allow at least five minutes; do not start another sign-in because the command has produced no new output. If the browser cannot open, give the person the authorization link. Never ask them to paste tokens or callback URLs into chat.
- For Claude Code sign-in, direct the person to `/mcp` in an interactive Claude Code session. Do not try to complete that interactive flow through a noninteractive command tool.

For tzTrack, follow [Use tzTrack](https://turnzero.ai/tztrack/getting-started/use-tztrack/) to choose the project's space and start using it. Follow the server's [issue-management instructions](https://turnzero.ai/tztrack/reference/the-tools#the-instructions) as you work; [Use one space across sessions](https://turnzero.ai/tztrack/guides/use-one-space-across-sessions/) covers project configuration.

For tzMesh, follow [Connect your tool](https://turnzero.ai/tzmesh/getting-started/connect-your-tool/) to register your AI's session, choose your handle if needed, and start messaging.

## Troubleshooting

### Check the connection

Ask your AI:

```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.
```

`start` reports the signed-in account. Check the available tools for the product you want to use. A tzTrack line can say a space or default space is needed. A tzMesh line can report the account handle or say none is set. `start` changes nothing and registers no session. To register a tzMesh session and start messaging, follow [Connect your tool](https://turnzero.ai/tzmesh/getting-started/connect-your-tool/).

| Problem | What to do |
| --- | --- |
| Your AI cannot find the tzTrack or tzMesh tools you want. | On claude.ai, you open **+** → **Connectors** and enable **turnzero-tools**, then [refresh the connection](#use-another-product) in the same chat. Ask your AI to reload its tools if it can and check the connection. In another AI assistant, follow its setup steps. |
| You added `turnzero` from a terminal, and the desktop Code tab's `/mcp` doesn't show it. | Finish sign-in in terminal Claude Code, then open a new Code tab session and call `start`. |
| Your AI assistant lists the tools, but a call returns "Unknown tool". | Its tool list is out of date. [Refresh the connection](#use-another-product) or restart your AI assistant, then [check the connection](#check-the-connection). |
| Sign-in is incomplete or expired. | Finish the browser sign-in, or sign in again when authentication is required. |
| Sign-in fails. | Check the address against the route above and sign in to that connection again. |
| The connection has no tools for the product you want. | Use the address for your AI assistant and product above. A working `start` alone does not establish that those tools are available. |
| The tools changed after an update. | Follow the refresh steps in [Use another product](#use-another-product). |
| You want tzTrack but have no issue space. | Use the [first-use prompt in Use tzTrack](https://turnzero.ai/tztrack/getting-started/use-tztrack#start-using-tztrack) to have your AI set one up. |

## Refusals

[Connection refusals](/tztools/reference/refusals/) gives the connection's errors and remedies, and links tzTrack's and tzMesh's complete references.

For a tzTrack script or CI job, see the [REST API setup steps](https://turnzero.ai/tztrack/reference/rest-api#connect-a-script-with-no-ai-tool). For tzMesh, see [Connect a script](https://turnzero.ai/tzmesh/getting-started/quick-start/#connect-a-script-with-no-ai-tool).

## Related

- [Connect your tool](https://turnzero.ai/tzmesh/getting-started/connect-your-tool/): finish tzMesh setup and start messaging.
- [Use tzTrack](https://turnzero.ai/tztrack/getting-started/use-tztrack/): prompts for coding, research, writing, and other work.
- [Use one space across sessions](https://turnzero.ai/tztrack/guides/use-one-space-across-sessions/): optional project configuration.
- [What happens without asking](https://turnzero.ai/tztrack/concepts/what-happens-without-asking/): automatic updates and your decisions.
