MCP for PrestaShop

# Troubleshooting

This page provides solutions to common issues you may encounter when using PrestaShop MCP Server.

# OAuth Error: "OAuth not implemented"

Problem: When connecting your AI application to your MCP Server, you receive an error message stating "OAuth not implemented" or a similar OAuth-related error.

Solution:

This error typically occurs when the OAuth authentication flow cannot be completed. Check the following:

# 1. Cloudflare Configuration

If you are using Cloudflare , verify that:

  • Cloudflare allows access to .well-known/* routes
  • These routes are essential for the OAuth discovery process
  • Make sure Cloudflare is not blocking or caching these endpoints

# 2. .htaccess and .htpasswd Configuration

Check your .htaccess file to ensure it allows the Authorization header:

# Allow Authorization header
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

The Authorization header is required for OAuth authentication to work properly.

If you use an .htpasswd, you need to request mcp with basic auth in yur url.

Exemple : https://username:password@your_domain.com/mcp

# 3. PrestaShop Maintenance Mode

Ensure your PrestaShop store is not in maintenance mode:

  • Maintenance mode blocks external access to your store
  • This prevents the OAuth authentication flow from completing
  • Disable maintenance mode before attempting to connect your AI application

Tip: After making these changes, try reconnecting your AI application to your MCP Server.

# Connection Setup Error: "An error occurred during connection setup"

Problem: When attempting to connect your AI application, you receive an error message stating "Une erreur s'est produite lors de la configuration de la connexion" (An error occurred during connection setup).

Solution:

This error typically occurs when you are not logged in with the correct account authorized to access the MCP Server.

# Verify Your Account

  1. Go to accounts.distribution.prestashop.net (opens new window)
  2. Navigate to the "Members" tab
  3. Verify that you are logged in with the email address authorized to connect to the MCP Server

# If You're Using the Wrong Account

If you discover you are logged in with the wrong account:

  1. Disconnect from the current account
  2. Reconnect with the correct authorized email address
  3. Try connecting your AI application again

# if you have and error with Accounts

  1. Need to reset ps_accounts module
  2. Try again the onboarding accounts step

# Need help ?

If you encounter problems that are not covered in this troubleshooting guide, you can contact our support service at the following URL:

https://care-center.prestashop.com/gb/contact-us?form=support&subject=ps_mcp_server (opens new window)

Our support team will be happy to assist you with any issues you may be experiencing.

←