The integration is not available

Check the status on Administration → Grok & MCP. A disabled environment cannot accept connections. If Grok cannot reach the MCP URL or receives an HTML page instead of connector metadata, the endpoint needs to be checked by the ShopFlare operator. Do not work around this by pasting a private API key or dashboard cookie.

Sign-in or authorization does not finish

Use your verified ShopFlare customer account and a current browser session. Select at least one shop you can view. Administrator impersonation is not a customer authorization flow. Retry from a newly initiated Grok connection rather than reusing an old authorization URL. If Grok lacks the custom connector option, check the availability for your Grok account.

Authorization is active but Grok is not connected

ShopFlare records the access grant; Grok must independently reach the endpoint and discover the tools. Verify tool discovery in Grok. A last-used timestamp indicates an authenticated MCP request, not successful completion of an answer. Report the time, visible error category and environment to support without copying credentials or private tool responses.

A shop or module is missing

The connector only returns workspaces selected during consent and still accessible to the authorizing customer. Reconnect to change the selection. Removed membership or revoked access denies subsequent calls. An active plan alone does not create source data; the module must also be configured and have saved results.

Grok asks to reconnect

Access tokens expire after one hour and this release does not advertise refresh-token access. Reauthorize when requested. If access was revoked, a new authorization is required; old tokens do not become valid again after a new grant.

Numbers differ from the dashboard

Compare the same workspace, project, source, measurement method, period, eligible sample and metric definition. Some tools return current saved summaries rather than a complete historical export. AI recommendation rates, catalogue coverage, scores and sales metrics have different meanings. Ask Grok to show the source period, counts and dashboard evidence link.

A request is limited or a source is slow

The connector has request, response-size, pagination and execution-time limits. Ask for one store and one module at a time. Reduce the requested page size, wait before retrying repeated requests, and open the dashboard evidence for detail. A timeout does not start a new analysis.

Disconnect safely

Revoke the relevant authorization in ShopFlare. Confirm that a subsequent Grok tool call requires authorization again. Removing a connector from Grok and revoking ShopFlare access are separate controls.

Connect ShopFlare to GrokTechnical methodology: sources, formulas, and evidence