Troubleshooting

data-slots=heading, image, text, text, text, text

"Authorization with the MCP server failed. You can check your credentials and permissions."

This issue can manifest itself in several ways, including:

• Authorization failed
• 403 forbidden
• Omni.Tools.MCPAccess permission error

Cause: Your account does not belong to a product profile that includes the MCP Read-only Access or MCP Full Access permission item.

Fix: Contact a system administrator or product administrator within your organization to add you to a product profile containing one of these permission items. The contact within your organization is typically the individual or team that granted you initial access to Adobe Analytics or Customer Journey Analytics. See Request access for the details to include in your request.

data-slots=heading, text, text

Creating or updating a component fails with a permission error

Cause: Your account has MCP Read-only Access instead of MCP Full Access, or your product profile does not allow creating that type of component in Adobe Analytics or Customer Journey Analytics.

Fix: Ask a system administrator or product administrator to add you to a product profile that includes MCP Full Access and the product permissions required to create the component. See Set up permissions for details.

data-slots=heading, text, text

Permission error after switching companies in Adobe Analytics

Cause: Adobe Analytics permissions apply per login company. Your account has an MCP permission item in one company, but not in the company that the tool is using.

Fix: Ask a system administrator or product administrator to add you to a product profile in that company that includes MCP Read-only Access or MCP Full Access. Alternatively, use setSessionDefaults to switch back to a company where you have access.

data-slots=heading, text, text

"Your organization does not allow access to third-party applications"

Cause: Your account belongs to an IMS organization that blocks third-party app access by default.

Fix: Contact your Adobe Account Team.

data-slots=heading, text, text

Wrong IMS org is active, or all results are null

Cause: The MCP inherits whichever org your browser was last logged into. If you were already authenticated, the org chooser is skipped automatically.

Fix: Log out of CX Enterprise, disconnect the MCP connector in your client, then reconnect. During reconnection you are prompted to choose your org.

data-slots=heading, text, text, text

TLS handshake failure or "Connection reset by peer" errors

Cause: A firewall or network proxy is potentially blocking traffic to Adobe authentication or analytics endpoints.

Fix: Work with your network team to allow the required Adobe IP addresses or domains:

• Adobe Analytics IP addresses
• Adobe Analytics domains
• Customer Journey Analytics IP addresses
• Customer Journey Analytics domains
• CX Enterprise IP addresses
• CX Enterprise domains

data-slots=heading, text, text

Agent uses a past year or incorrect date

Cause: Some AI models might default to their training cutoff date rather than the current date when interpreting relative date terms.

Fix: Explicitly state the full date or date range in your prompt before using relative terms like "this month" or "last quarter". Once the agent has the current date in context, relative terms typically return desired results.

data-slots=heading, text, text

Agent returns "Resource not found" for runReport, findDimensions, or findMetrics

Possible cause: Having both Adobe Analytics and Customer Journey Analytics connected simultaneously can cause some models to send requests to the wrong MCP server.

Fix: Disconnect both connectors and reconnect only the one you need for the current session.

data-slots=heading, text, text

upsertProject fails with JSON validation errors

Cause: The project definition schema is complex, and some models might produce malformed JSON (especially in deeply nested structures).

Workaround: Provide the LLM with an existing valid project as a reference before prompting it to create a new one. Ask the LLM to compare its output against the reference before calling upsertProject.

data-slots=heading, text, text

Project is created but shows an error banner when opened in Customer Journey Analytics

Common causes include malformed date ranges or incorrect grid position values on subpanels.

Workaround: Reference an existing project in the same data view when prompting. Include explicit examples of date range format and panel position values in your prompt.