Set up Turn Zero Tools for AI #

View this page as Markdown

On this page

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 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:

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

Claude Code in a terminal · Claude desktop app · Codex

Claude route Where it works Where you sign in
Custom connector Claude desktop chat and Code tab, and claude.ai Add it in Claude. Claude opens the browser for sign-in.
Terminal command 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. 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 explains the download link and how to renew it.

The address determines which products the connection provides. Use another product explains the routes.

Detailed setup steps #

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:

    turnzero-tools
    

    URL:

    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.

If the app cannot add the server, you can use Claude Code in a terminal or 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 or 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 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 to choose the project's space and start using it. Follow the server's issue-management instructions as you work; Use one space across sessions covers project configuration.

For tzMesh, follow Connect your tool to register your AI's session, choose your handle if needed, and start messaging.

Troubleshooting #

Check the connection #

Ask your AI:

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.

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 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 or restart your AI assistant, then 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.
You want tzTrack but have no issue space. Use the first-use prompt in Use tzTrack to have your AI set one up.

Refusals #

Connection 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. For tzMesh, see Connect a script.