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