Skip to content

Connect Claude, ChatGPT, or Cursor to TaggingDocs

Pick your AI client below. Setup is 30 seconds in every case. If it’s your first time, the OAuth consent screen will ask for Google Tag Manager scopes — that’s what lets the assistant read and edit your containers.

Claude.ai in a browser and the native Claude Desktop app share the same native HTTP MCP flow — same steps, same screens.

  1. Click Customize in the left sidebar, then open the Connectors tab. (Anthropic moved Connectors here out of Settings; older “Settings → Integrations” instructions are stale.)

  2. Scroll to the bottom of the Connectors list and click Add custom connector.

  3. Paste the server URL:

    https://mcp.taggingdocs.com/mcp
  4. Claude opens a browser tab for Google sign-in. Choose the account that has access to your GTM containers, review the requested Tag Manager scopes, and click Continue.

  5. When you see the “Signed in to TaggingDocs MCP” success card, you can close that tab. The connector will flip to Connected in Claude.

  6. Start a new chat and try “List my GTM accounts.” You should get a real list back.

If the UI doesn’t update after auth (more common on Claude Desktop), click the menu next to the connector → Disconnect → then Connect again. Claude sometimes caches the pre-auth state until you nudge it.

Documentation tools (searching and reading TaggingDocs articles) work without any login — connect the server and ask away.

GTM tools need a Google account that has access to the Tag Manager containers you want to work with. The server requests Google’s standard Tag Manager OAuth scopes:

ScopeWhat it lets the AI do
tagmanager.readonlyList accounts, containers, workspaces, tags, triggers, variables
tagmanager.edit.containersCreate and modify tags, triggers, variables, folders
tagmanager.edit.containerversionsCreate container versions for review
tagmanager.publishPublish versions (go live)
tagmanager.manage.accounts / manage.usersRead account-level settings and user permissions

After the first authorization, Google issues a refresh token. The server stores only that refresh token server-side and uses it to mint short-lived access tokens as needed — you don’t have to re-authenticate every session. Revoke any time at myaccount.google.com/permissions.

The URL in your AI client is missing the /mcp path. The connector did OAuth fine but then looked for the MCP endpoint at the server origin (which serves a landing page, not MCP). Remove the connector and re-add it with https://mcp.taggingdocs.com/mcp.

Two causes, in order of likelihood:

  1. Stale session after the client was restarted. Claude Desktop in particular caches an old session ID. Fix: menu → DisconnectConnect again.
  2. OAuth token is bad. Visit myaccount.google.com/permissions, revoke taggingdocs.com, then re-run OAuth from your AI client.

The Google sign-in tab just spins / never closes

Section titled “The Google sign-in tab just spins / never closes”

The OAuth flow completes behind the scenes (you’ll see the connector flip to Connected in your AI client) but the browser tab gets stuck on the Google consent page because the final redirect is a deep link the tab can’t navigate to. After the success toast appears in your AI client, it’s safe to close the tab manually.

The server is open source. Run your own if you want to restrict access to a specific Google Workspace, change the stored scopes, or audit every request.