Troubleshooting

OpenAI controls which plans and workspaces can add custom MCP connectors.

• Check that you are using ChatGPT on the web at chatgpt.com.
• Check that your plan supports custom MCP connectors in OpenAI's guide.
• If you are on a Business, Enterprise, or Edu workspace, ask your ChatGPT admin to allow custom MCP connectors for you, or to add Trillet for the workspace. See For ChatGPT workspace admins.
• In some accounts you need to turn on Developer mode first, under Settings > Apps > Advanced settings.

• On the Free plan you can add one custom connector. Remove an unused one first.
• On Team and Enterprise plans, only owners (and Enterprise roles with Manage access to Libraries) can add connectors. Ask an owner to add Trillet in Organization settings > Connectors, then connect it yourself in Customize > Connectors.

The sign-in link is valid for a short time. Close the Trillet tab, go back to ChatGPT or Claude, and start the connection again.

Select Switch account at the top of the consent screen and log in with the account you want to connect.

The connection has lost access. This happens after you disconnect the app in Trillet, or when its sign-in has expired.

• ChatGPT or Claude: reconnect the Trillet connector in ChatGPT's plugin or app settings, or in Claude's Customize > Connectors. Log in and select Allow access again.
• API key clients: check the key is still listed in Settings > Developer > API Keys, and that its user is a member of the workspace id you set. The connection can look healthy while the key is wrong, so ask the assistant to "list my agents" to confirm.

• ChatGPT: type @ and select Trillet in the message box, or name Trillet in your request.
• Claude: select + in the message box, then Connectors, and make sure Trillet is on for this conversation.

Ask the assistant to "list my workspaces". It shows every workspace you belong to and marks the current one. Then ask it to switch, for example "switch to Acme Clinic Northside".

If a workspace is missing from the list, your Trillet account is not a member of it. Ask the workspace owner to invite you.

The call flow probably has an active draft from the dashboard editor. A draft overrides the live version for test calls. Ask the assistant to "check whether this call flow has an active draft", then either publish the draft or deactivate it.

ChatGPT keeps a snapshot of a connector's tools. Refresh the Trillet connector from its details page in ChatGPT's app settings. On Business, Enterprise, and Edu workspaces, an admin needs to refresh and publish the update.

The hosted server can't read files from your computer. Give the assistant a public link to the file (for example https://harbourdental.example/price-list.pdf), or paste the text into the chat and ask it to add the text to the knowledge base.

If the agent greets you and then every reply fails with Required at session_id, you are using an older Trillet extension in Claude Desktop. Versions before 0.8.3 are affected.

Fix it in one of two ways:

• Use the Claude connector instead. See Connect Claude. It is always up to date.
• Reinstall the extension. Get the latest trillet.mcpb from Trillet support and install it again. Claude Desktop never updates extensions on its own. Check your version in Settings > Extensions.

You can run two text test calls at the same time. Ask the assistant to end the calls you have finished with, then start a new one.

Text test calls are real calls. Anything the agent does during the call, such as booking an appointment or calling a webhook, happens for real. Use test calendars and endpoints while you build, and cancel any test bookings afterwards.

The Authorization header is missing or malformed. It must be Authorization: Bearer YOUR_API_KEY: the word Bearer, one space, then the key.

The X-Trillet-Workspace-Id header is missing. Add it, or add ?workspace=YOUR_WORKSPACE_ID to the server URL if your client can set only one header.

You need Node.js 18 or later. Run node --version to check, then run npx -y @trillet-ai/mcp@latest in a terminal to see the full error.