Customer Knowledge Base

MCP Troubleshooting and Limitations

๐Ÿงช MCP integration is currently in closed beta. This feature is available to selected users only. To request access, contact your emax digital account manager.

This page helps you resolve common issues with the emax digital MCP integration and documents known beta limitations. For setup instructions, see Getting Started with MCP (Setup & Supported AI Tools).

Connection Issues

The AI tool cannot connect to the MCP server

  • Confirm the MCP server URL is correctly entered: https://api.production.k8s.emax.digital/mcp

  • Confirm authentication is set to OAuth โ€” not API key or other method

  • Try disconnecting and reconnecting the emax digital MCP connector in your AI tool settings

  • Each user must sign in individually โ€” the connection is not shared. If a colleague set it up, you still need to authorize your own account separately

I am being prompted to sign in every time

  • OAuth tokens may expire periodically during the beta. Sign in again with your emax digital credentials

  • Contact your account manager if re-authentication is happening too frequently

No Data Returned

The query returns empty results or "no data found"

  • Check that your Amazon account is connected in emax digital under Setup โ†’ Administration

  • Confirm you have the correct company or account selected in emax digital

  • Check data availability timing โ€” some sources have a lag (advertising data is typically available the following day; AMC data has a 14-day lag)

  • Verify you are asking about a time period for which data exists in your account

Advertising data is missing

  • Confirm your Amazon Advertising accounts (SPA, DSP) are connected in emax digital

  • DSP and AMC data require separate connections โ€” check with your emax digital account manager

Unexpected or Incomplete Results

Results don't match what I see in the emax digital dashboards

  • Check filter alignment โ€” your prompt may be using a different time period or marketplace than the dashboard you are comparing against

  • Specify the marketplace explicitly in your prompt (e.g. "for Germany" or "for DE")

  • If you have both Vendor and Seller connected, specify the account type in the prompt

The AI returns a partial answer or seems to miss data

  • Break the question into smaller parts โ€” one metric at a time, one marketplace at a time

  • Use exact metric names from emax digital: "Ordered Revenue", "ACOS", "Glance Views" rather than generic terms like "sales" or "performance"

Known Beta Limitations

Limitation

Detail

Not all data sources covered

The beta covers advertising performance (SP/SB/SD/DSP), catalog metadata, and performance trends. Some data types โ€” full inventory data, Monitoring dashboards โ€” may not be accessible via MCP yet.

Individual sign-in required

Every user must authenticate separately with their own emax digital credentials. There is no shared or service-account login.

OAuth tokens may expire

Periodic re-authentication may be required during the beta period.

No scheduled queries

MCP is a real-time query tool โ€” it cannot run reports on a schedule or push data automatically. For recurring workflows, use Emma's Skills feature instead.

Prompt sensitivity

Natural language queries are interpreted by the AI tool. Ambiguous or broad questions may return unexpected results. Specific prompts with named metrics, marketplaces, and time periods reliably produce better outputs.

Beta feature changes

The MCP integration is in active development. Available data sources, supported tools, and behaviour may change during the beta period.

Getting Help

If you encounter an issue not covered here:

  • Contact your emax digital account manager for account-specific connection issues or to report a bug

  • For general support, reach out at support@emax-digital.com

  • When reporting an issue, include: the AI tool you are using, the exact prompt you sent, and the error message or unexpected output you received

๐Ÿ’ก Do you think the content on this page needs improvement? Let us know at support@emax-digital.com