Skip to main content
Community Hub

Troubleshoot ChatGPT with Atlan

TL;DR

Resolve common ChatGPT issues with the Atlan app, including empty query results, OAuth permission loops, and authentication failures when connecting ChatGPT to Atlan.

Your AI can read this via Docs MCPcurl -fsSL "https://docs.atlan.com/install-docs-mcp" | bashConnect

When connecting ChatGPT to Atlan, you may encounter issues related to permissions, OAuth token state, or session configuration. This page covers the most common issues and how to fix them.

ChatGPT returns empty results after connecting​

warning

The Atlan app is connected but returned no results. This may indicate a permissions issue with your account.

Cause​

Atlan MCP results are scoped to the authenticated user's persona. If no persona is assigned, or if an admin completed OAuth on behalf of the user, the session lacks data access.

Solution​

  1. Confirm the querying user has an assigned persona in Atlan with access to the assets being queried.
  2. Test with a broad query, such as "how many tables exist in Atlan?", to rule out a full access block.
  3. If using a shared app set up by an admin, confirm OAuth completed for your own account, not just the admin's.

ChatGPT OAuth loops with repeated permission requests​

warning

ChatGPT keeps redirecting to re-authorize after you've already approved.

Cause​

Stale or conflicting OAuth tokens between ChatGPT and Atlan block the authorization flow from completing. Removing and re-adding the app without clearing the previous token state causes this loop.

Solution​

  1. In ChatGPT, go to Settings → Apps and remove the Atlan app entirely.
  2. In Atlan, go to Admin Settings → API Keys / Tokens and revoke any OAuth tokens previously issued to ChatGPT.
  3. Add the Atlan app again and complete a fresh OAuth flow.

ChatGPT OAuth fails on first attempt​

warning

We couldn't connect to this service. Authorization failed — please try again.

Cause​

An expired or inconsistent ChatGPT session causes the OAuth redirect to fail before authentication completes.

Solution​

Log out of ChatGPT, log back in to refresh your session, then add the Atlan app again from Settings → Apps.

Atlan app sign-in fails with invalid domain​

warning

Sign-in fails or returns an error after you enter your Atlan domain.

Cause​

The Allow ChatGPT to access Atlan screen expects only your tenant name, because the .atlan.com suffix is added automatically. Entering the full URL or an incorrect tenant name causes sign-in to fail.

Solution​

Re-enter your Atlan domain using only the tenant name. For example, enter your-tenant, not your-tenant.atlan.com or https://your-tenant.atlan.com.

See also​

Need help​

If you need assistance after trying these steps, contact Atlan Support.