---
title: Turn Zero Tools
description: Connect Turn Zero Tools for AI to track issues, exchange messages and generate images from your AI assistant or coding agent.
slug: /
order: 0
visibility: public
redirects_from: []
---
# Turn Zero Tools
Turn Zero Tools for AI brings tzTrack, tzMesh and Image Gen to your AI through one connection. Use tzTools to keep track of work, exchange messages, and make pictures in your conversations.
## Start here
[Set up your AI](/tztools/getting-started/set-up/). Your first sign-in creates a free Turn Zero account. Reuse a signed-in connection that already provides the tools you need.
Choose the instructions for [Claude Code](/tztools/getting-started/set-up-claude-code/), [Claude desktop](/tztools/getting-started/set-up-claude-desktop/), or [Codex](/tztools/getting-started/set-up-codex/).
## Choose what to do
| You want to… | Read |
| --- | --- |
| Keep issues and follow-ups across conversations | [Use tzTrack](https://turnzero.ai/tztrack/getting-started/use-tztrack/) |
| Send messages between people and AI sessions | [Connect to tzMesh](https://turnzero.ai/tzmesh/getting-started/connect-your-tool/), where your account holds tzMesh |
| Make and download a picture | [Generate images](/tztools/guides/generate-images/) |
| Check the account or end a tool's connection | [Your account and connected tools](/tztools/guides/account-and-connected-tools/) |
| Fix a connection that does not work | [Troubleshoot the connection](/tztools/guides/troubleshooting/) |
The [tzTrack manual](https://turnzero.ai/tztrack/) and [tzMesh manual](https://turnzero.ai/tzmesh/) explain those products in full. Each product's tools are available only within your account's access.
## The connection
[The address and its tools](/tztools/reference/address-and-tools/) explains which connection to use. For hosting applications, follow [Connect your AI coding agent](https://turnzero.ai/cloud/getting-started/connect-your-tool/).
Image generation needs no application or provider key. [Pricing](https://turnzero.ai/pricing) gives the current rates; the image guide explains what counts.
## Machine surfaces
The [page index](https://turnzero.ai/tztools/llms.txt) lists this manual's pages; [the full text](https://turnzero.ai/tztools/llms-full.txt) combines them. The [page manifest](https://turnzero.ai/tztools/docs.json) lists their addresses. Each page has a Markdown copy, such as [this home page](https://turnzero.ai/tztools/index.md), at its address followed by `index.md`.
[Connection refusals](/tztools/reference/refusals/) covers sign-in, missing product tools and the wrong address. Product terms are defined in the [tzTrack glossary](https://turnzero.ai/tztrack/concepts/glossary/) and [tzMesh glossary](https://turnzero.ai/tzmesh/concepts/glossary/). Read [what tzTrack does without asking](https://turnzero.ai/tztrack/concepts/what-happens-without-asking/) before delegating work.
---
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
- [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.
### 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.
---
title: Set up Turn Zero Tools in terminal Claude Code
description: Add Turn Zero in terminal Claude Code, sign in, and verify the connection.
slug: /getting-started/set-up-claude-code
order: 1
visibility: public
redirects_from: []
---
# Set up Turn Zero Tools in terminal Claude Code
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. If the person uses the Claude desktop app or hasn't named a Claude surface, offer both routes in that message. This route starts sign-in in terminal Claude Code. The [custom connector](/tztools/getting-started/set-up-claude-desktop/) starts sign-in from Claude settings and covers desktop chat, the Code tab and claude.ai.
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.
1. After approval, you or the person can add `turnzero` from a terminal. The user scope makes it available across project folders.
```text
claude mcp add --transport http --scope user turnzero "https://turnzero.ai/mcp"
```
2. The person opens a new interactive terminal session with `claude`, types `/mcp`, and chooses `turnzero`. The person completes browser sign-in and chooses **Allow access** if asked. Keep tokens and callback URLs out of chat.
3. Run `claude mcp get turnzero` after sign-in. Look for **Connected**. Check that the saved address is `https://turnzero.ai/mcp`.
The session that added the server cannot load the new tools. Report the tool check as pending and give the person the prompt below. In a Claude Code 2.1.316 macOS test, a new desktop Code tab session loaded the user-scoped tools after terminal sign-in, even though the desktop app's `/mcp` settings did not list the server.
To switch to the custom connector, first remove the terminal entry with `claude mcp remove turnzero`. Keep one connection.
## Check in a new session
Open a new terminal or desktop Code tab session and 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.
```
---
title: Set up Turn Zero Tools in the Claude desktop app
description: Add the Turn Zero connector to Claude desktop chat and the Code tab.
slug: /getting-started/set-up-claude-desktop
order: 2
visibility: public
redirects_from: []
---
# Set up Turn Zero Tools in the Claude desktop app
Use a custom connector for Claude desktop chat and the Code tab. The same connector is available on claude.ai. Before adding or changing a connection, check whether `start` works and the tzTrack or tzMesh tools you need are available. Reuse a working connection with the tools you need; a Code tab that shares the terminal configuration reuses `turnzero`.
Ask once before changing the setup. If the person uses the desktop app or hasn't named a Claude surface, offer both routes in the same approval message. The connector starts sign-in from Claude settings. [Terminal setup](/tztools/getting-started/set-up-claude-code/) starts sign-in in terminal Claude Code and can serve new Code tab sessions.
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.
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.
The person follows these steps in the Claude desktop app.
1. Open **Settings** → **Customize** → **Connectors** → **Add** → **Add custom connector**.
2. Enter `turnzero-tools` and paste the address into **MCP server URL**. Choose **Continue**.
3. Keep **Sign in now**, choose **Register automatically** under **OAuth client**, and leave **Request headers** empty.
4. Choose **Add**. The person completes browser sign-in and chooses **Allow access** if asked. Keep tokens and callback URLs out of chat.
5. In desktop chat, open **+** → **Connectors** and turn on **turnzero-tools**. In the Code tab, look for the connector by name or ID. Its instructions identify it as Turn Zero. If it doesn't appear in the current Code tab session, open a new one and check there.
If you already added `turnzero` from a terminal and want to switch to the connector, run `claude mcp remove turnzero` before adding it. Keep one connection. If you picked the wrong authentication option, remove the connector and add it again.
On a Team or Enterprise plan, an owner adds the connector under **Organization settings** → **Connectors**, then each member chooses **Connect**.
## Check the connection
Paste this into the chat or Code tab where you enabled the connector:
```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.
```
---
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.
```
---
title: Generate images
description: Ask your AI tool for a picture, download the result and keep a copy before its account storage expires.
slug: /guides/generate-images
order: 0
visibility: public
redirects_from: []
---
# Generate images
Prompt:
> Make a cover picture for my project and give me a link to download it.
Use Turn Zero Tools to make a picture in your conversation. You need a signed-in AI tool with `generate_image` available; no application, provider account or provider key is needed.
Read the [rates and counting guidance](https://turnzero.ai/cloud/guides/generate-an-image-from-your-ai-tool/#4-know-what-counts) before asking your AI to generate a picture.
## Steps
1. [Connect your AI tool](/tztools/getting-started/set-up/) if it is not already connected.
2. Describe the picture you want. Your AI tool calls `generate_image` with your prompt and no application.
3. Open the download link in the result and save the picture. Anyone holding that link can read the picture until the link expires.
4. Keep your own copy. A picture saved in your account stays for seven days, until the result's `kept_until`.
## Expected result
The answer gives the saved picture's name and normally a download link. If the picture cannot be shown in your conversation, download it using that link.
## If the link does not work
Before `kept_until`, ask your AI tool to call `renew_image_link` with the picture's name. Use the new link; renewing it ends the old link and does not extend the picture's keep time.
A result that says no link could be made can still have saved the picture. The same renewal call gets its link. An expired picture cannot be restored; use your downloaded copy or generate a new one.
## Rates, options and refusals
The [full image guide](https://turnzero.ai/cloud/guides/generate-an-image-from-your-ai-tool/) explains resolution, inline results, application storage, counting and every refusal. Read its rates and counting section before asking for more images.
---
title: Your account and connected tools
description: Check which Turn Zero account your AI tool uses and disconnect a tool you no longer want to have access.
slug: /guides/account-and-connected-tools
order: 1
visibility: public
redirects_from: []
---
# Your account and connected tools
Prompt:
> Check which account this tool uses and show me how to disconnect my old tool.
Your Turn Zero Tools connection acts for the Turn Zero account you signed in with. You use that same account on the Turn Zero dashboard.
## Check the account
Ask your AI tool to call `read_account`. It reports the account's sign-in identities, standing and products. Check that it is the account you intended to use. [Your account](https://turnzero.ai/cloud/guides/your-account/) explains the answer.
## End one tool's connection
1. Sign in at [the Turn Zero dashboard](https://turnzero.ai/dashboard).
2. Open [Connected AI tools](https://turnzero.ai/dashboard/ai-tools). Find the connection you want to end.
3. Choose **Disconnect** beside that connection. Its access and renewal end; your other connections stay open.
Removing a connection from the AI app's settings removes its local configuration. That alone does not necessarily end its sign-in on Turn Zero. Disconnect it on the dashboard when you want to end its access.
## Expected result
The disconnected tool must sign in again before it can act for your account. To remove the tool's saved configuration too, follow the steps for [your AI tool](/tztools/getting-started/set-up/).
## Sign-in and product access
If the dashboard asks you to sign in again before a change, follow that link, then repeat the change. Keep tokens and sign-in callback URLs out of chat.
Where your account holds tzMesh, [Connect to tzMesh](https://turnzero.ai/tzmesh/getting-started/connect-your-tool/) explains account handles and registering an AI session. Signing in and calling `start` do not register a messaging session.
For sign-in methods, ending every connection, and account refusals, read [Your account](https://turnzero.ai/cloud/guides/your-account/).
---
title: Troubleshoot the connection
description: Find why your AI cannot use Turn Zero Tools after setup, then check its connection, sign-in and available tools.
slug: /guides/troubleshooting
order: 2
visibility: public
redirects_from: []
---
# Troubleshoot the connection
Use this page when Turn Zero Tools is configured but your AI cannot use the tools you need. [Set up your AI](/tztools/getting-started/set-up/) has the complete setup steps.
## No tools appear after setup
**Cause:** The current chat has not loaded the connection, or the connector is not enabled.
**Check:** Ask your AI to check its available tools, including tools it can discover on demand. A Codex desktop connection may not appear in `codex mcp list`.
**Remedy:** On claude.ai, enable **turnzero-tools** under **+** → **Connectors** and refresh its tools list. Keep that conversation. In ChatGPT, refresh the connector and start a new chat. In another tool, start a new session.
## Sign-in did not open or is still waiting
**Cause:** The tool has not completed browser sign-in.
**Check:** In terminal Claude Code, open `/mcp` interactively and choose `turnzero`. In Codex, check whether the sign-in command is still waiting.
**Remedy:** Complete sign-in in the browser and choose **Allow access** if asked. Keep a waiting Codex command running for at least five minutes. If the browser cannot open, use its authorization link. Never paste a token or callback URL into chat.
## A listed tool answers “Unknown tool”
**Cause:** The tool's saved list may be out of date.
**Check:** Compare the connection's address with [The address and its tools](/tztools/reference/address-and-tools/).
**Remedy:** Refresh the connector as above and ask your AI to reload its tools if it can. Check again before adding another connection.
## The connection works, but a product's tools are missing
**Cause:** The address and your account's access both determine the available tools.
**Check:** Ask your AI to call `start` and check for the tools of the product you want. A successful `start` alone does not establish that those tools are available.
**Remedy:** Use the address for your host and product in [Set up your AI](/tztools/getting-started/set-up/). Where your account does not hold the product, a different sign-in or the product's access is needed. Keep company restrictions in place; ask your administrator if they prevent adding the connection.
## A call refuses the sign-in
[Connection refusals](/tztools/reference/refusals/) gives sign-in errors and remedies, and links the product references for their own errors.
## Check after a correction
Ask your AI to call `start` and check that the tools you need are available. If it cannot load them in the current session, start a new one and repeat the check. Report setup as pending until that check succeeds.
---
title: The address and its tools
description: Choose the Turn Zero Tools connection for your AI app and find the references for issue tracking, messaging and images.
slug: /reference/address-and-tools
order: 0
visibility: public
redirects_from: []
---
# The address and its tools
Turn Zero Tools uses an MCP connection: your AI app connects to a server address and you sign in through a browser. The address and your account's access determine which tools it provides.
## Choose the connection
| Where you use it | Server address | Connection name |
| --- | --- | --- |
| A chat app | `https://tztools.turnzero.ai/mcp` | `turnzero-tools` |
| Claude Code or Codex | `https://turnzero.ai/mcp` | `turnzero` |
Follow [Set up your AI tool](/tztools/getting-started/set-up/) for your host's steps. Reuse an existing connection that supplies the tools you need. Each address has its own sign-in; signing in to one does not connect the other.
The tools-only address provides tzTools. The `turnzero.ai/mcp` address also provides the hosting tools. To connect for application hosting, use [the Cloud connection guide](https://turnzero.ai/cloud/getting-started/connect-your-tool/).
## Find a tool's instructions
| Group | What you use it for | Full reference |
| --- | --- | --- |
| `tztrack_*` | Record issues, follow work, and manage issue spaces within your access | [tzTrack tools](https://turnzero.ai/tztrack/reference/the-tools/) |
| `tzmesh_*` | Register AI sessions and exchange messages, where your account holds tzMesh | [tzMesh MCP tools](https://turnzero.ai/tzmesh/reference/mcp-tools/) |
| `generate_image`, `renew_image_link` | Make a picture and renew the download link for one saved without an application | [Image generation](https://turnzero.ai/cloud/guides/generate-an-image-from-your-ai-tool/) |
| Account and help | Read the signed-in account, check usage and rates, read documentation, or send feedback | [Your account](https://turnzero.ai/cloud/guides/your-account/) |
Your host may discover tools on demand. Ask your AI to check for the tools you need after signing in. Product tools appear only where your account holds that product.
The tools-only address does not list the hosting tools with the `tzcloud_` prefix. It also does not list `mint_token`, `revoke_token` or `list_tokens`. To end a signed-in tool's connection without those calls, use [Connected AI tools](/tztools/guides/account-and-connected-tools/).
## Refusals and connection problems
[Troubleshoot the connection](/tztools/guides/troubleshooting/) covers missing tools and incomplete sign-in. [Connection refusals](/tztools/reference/refusals/) gives shared connection errors and links each product's causes and remedies.
---
title: Refusals
description: Resolve sign-in refusals, missing product tools and calls made through the wrong connection.
slug: /reference/refusals
order: 3
visibility: public
redirects_from: []
---
# Refusals
Use this page for the shared connection. Read a refusal's detail before retrying; each product's reference gives the refusals of its own calls.
## Sign-in
| Code | Status | Cause | Remedy |
| --- | --- | --- | --- |
| `authentication_required` | 401 | Sign-in is absent, expired, revoked, unrecognized, or for the other server address. | Sign in again through the intended connection; each address has its own sign-in. |
| `account_suspended` | 403 | The account is suspended. | Wait for Turn Zero to reinstate the account, then sign in again. |
[Set up](/tztools/getting-started/set-up/) gives the host's sign-in steps.
## Wrong address or missing tools
A tool can be absent because the connection's address does not provide it or the account does not hold its product. Check both in [The address and its tools](/tztools/reference/address-and-tools/). A successful `start` alone does not prove that a product's tools are available.
A call answering “Unknown tool” can also mean the host kept an old tools list. Refresh or restart the connection as [Troubleshoot the connection](/tztools/guides/troubleshooting/) describes, then check again. This message is not a product refusal code.
## Refusals from each product
- [tzTrack refusals](https://turnzero.ai/tztrack/reference/refusals/).
- [tzMesh errors](https://turnzero.ai/tzmesh/reference/errors/).
- [Image generation refusals](https://turnzero.ai/cloud/guides/generate-an-image-from-your-ai-tool/#refusals).
- [Account refusals](https://turnzero.ai/cloud/guides/your-account/#refusals).
These references hold each product's causes and remedies. [Your account and connected tools](/tztools/guides/account-and-connected-tools/) explains how to end a connection from the dashboard.