Troubleshooting
Every MarStack error says what went wrong. Here is what to do about each one.
MarStack does not appear in my client
- Restart fully. Claude Desktop must be quit from the tray or menu bar, not just closed, before it reads a new config.
- Check the JSON. A missing comma or bracket stops the whole config from loading. Paste it into a JSON checker if in doubt.
- Connecting by address? Check it is exactly
https://mcp.getinlytics.com/mcpand that you clicked Allow on the MarStack page. The connection then shows in Connected apps, under Connections, AI apps. - Using the token config? Claude Desktop needs Node.js 20 or later to start the marstack-mcp package. Run
node --versionto check. - See what the package says. Run
npx -y marstack-mcp --versionin a terminal. For full detail, add"MARSTACK_DEBUG": "1"to the env block and read the Claude Desktop MCP log (Settings, Developer). - In Claude Code, run
/mcp. In Cursor, open Settings, MCP. Both show whether marstack connected and why not.
The assistant answers without using MarStack
Name it in the question: "Use MarStack to check the tracking on example.com". Once a client has seen MarStack work, it usually picks it on its own.
In ChatGPT and Gemini, make sure the MarStack connector is switched on for the chat (in the tools or apps menu of the message box). If the answer comes from a web search instead, start a new chat after connecting, and ask again naming MarStack.
MarStack Intelligence is locked
Intelligence needs a paid plan, or on Free your own AI key. Viewers can read conversations but cannot ask. See MarStack Intelligence.
Error messages
- Couldn’t register with MarStack’s sign-in service (Claude) or the connector will not connect.
- Check the address is exactly https://mcp.getinlytics.com/mcp, then try Connect again. If the MarStack page says the sign-in expired, start again from your AI app: sign-ins wait 10 minutes.
- This connection was revoked. Connect MarStack again in your AI app.
- Someone clicked Disconnect under Connections, AI apps. Remove MarStack from the app and add it again, then sign in.
- The app connects but asks for a Client ID and Client Secret (Gemini).
- Open Connections, AI apps in the MarStack dashboard, Gemini section. Paste the redirect URI Gemini shows, create the client, then copy the Client ID and Secret into Gemini.
- No MarStack token was sent.
- The client config has no Authorization header or token. Paste the config from Connections, AI apps again, then restart the client.
- This is not a MarStack token. Tokens start with msk_live_ or msk_test_.
- Part of the token is missing or extra text was copied. Copy it again, or create a new token if you no longer have it.
- This token is not recognised.
- The token was deleted or mistyped. Create a new one under Connections, AI apps.
- This token was revoked on (date).
- Someone revoked it under Connections, AI apps. Create a new token and update the client config.
- GA4 is not connected.
- Connect Google under Connections, Platforms. Website checks work without it; GA4, GTM and Search Console tools need it.
- The Google connection for (account) needs to be renewed.
- Google stopped accepting the connection, often after a password change or removed access. Click Reconnect under Connections, Platforms.
- None of your connected Google accounts can open GTM-XXXX.
- Ask the container owner to add one of your Google accounts in GTM Admin, User Management, or connect the account that has access. For a site you do not manage, ask for a public GTM audit instead.
- On the Free plan, MarStack Intelligence runs on your own AI key.
- Add an Anthropic, OpenAI or Google Gemini key under Plan and usage, Billing, in Your own AI key (owners only), or choose a paid plan to use MarStack AI. Every tool still works in your AI app.
- You have used the 30 Intelligence questions included with the Free plan.
- Choose Starter, Pro or Agency under Plan and usage, Billing to keep asking in the portal. Every MarStack tool still works in your AI app.
- MarStack Intelligence and the agent are part of the paid plans.
- The agent runs on Starter, Pro and Agency. Choose a plan under Plan and usage, Billing.
- Your (provider) key could not be used (reason), so MarStack’s AI answered the rest at normal credits.
- Your own AI key failed, for example it was revoked or the provider account has no balance. Check it with your provider, then add it again under Plan and usage, Billing. Until then, paid plans use MarStack AI at normal credits.
- Your (provider) key could not be used (reason). On the Free plan Intelligence runs only on your own key.
- Fix the key with your provider (a new key, or add balance), then save it again under Plan and usage, Billing and ask again. No credits were charged for the AI.
- (Workspace) has used its (n) Intelligence credits for today.
- The daily limit resets at midnight UTC. The account owner can raise it for the workspace under Plan and usage, Team.
- The (workspace) workspace has used (n) of its (m) credits this month.
- The account owner set a monthly credit limit for this workspace. They can raise it under Plan and usage, Team.
- The Journeys Explorer needs the GA4 BigQuery export.
- Turn on the export in GA4 (Admin, Product links, BigQuery links); it is free and starts the next day. Then tick the dataset under Connections, Platforms, Access, BigQuery datasets. To try the explorer now, ask for a demo on Google’s public sample store.
- The GA4 export has no tables for (days), so journeys from those days are not included.
- The export started after those days, or a daily table has not arrived. GA4’s own reports will show more for that range. Choose dates the export covers, or check the BigQuery link in GA4 (Admin, Product links, BigQuery links).
- The CRM table is in BigQuery region (x) and the GA4 export in (y).
- BigQuery cannot join across regions. Copy the CRM table into a dataset in the same region as the GA4 export and map that copy, or build with the Full funnel by campaign, which needs no join.
- You already have a question running.
- Wait for the answer to finish, or press Stop, then ask again.
- Stopped at this question’s limit of (n) credits.
- Press Continue to let it carry on, or ask a narrower question. Deep analysis allows a larger limit.
- Not enough credits: (tool) needs (n) and you have (m).
- Top up or move to a bigger plan in the dashboard. Free tools such as listing and reports still work.
- Could not load (url). No credits were charged.
- The site was down, blocked the browser or the address is wrong. Check the URL opens in your own browser and try again.
Still stuck?
Email hello@getinlytics.com with the exact message and the name of your AI client.