Skip to main content

Troubleshooting

Common issues and solutions for the AI Copilot extension.

Chat widget does not appear​

The Copilot button is not visible in the bottom-right corner of admin pages.

Check the following:

  1. Extension is enabled: run php -f bin/magento module:status Mirasvit_Copilot and verify it shows as enabled.
  2. Cache is clean: run php -f bin/magento cache:clean.
  3. Static content is deployed: run php -f bin/magento setup:static-content:deploy -f.
  4. Admin user is logged in: the widget only appears for authenticated admin users.

"Access denied" for a tool​

Copilot reports that access is denied when trying to use a tool.

Solution: the admin user's role does not have permission to use the tool. See Configure role permissions for step-by-step instructions on enabling tool access.

"Access to table X is restricted"​

The Database Reader blocks a query because the table is restricted.

Solution: check the Tools Settings:

  • Verify the Table Access Mode (blacklist vs whitelist)
  • Check the Table Patterns list
  • If using whitelist mode, ensure the table is included in the patterns
note

Tables matching mst_mcp_* (the module's own tables) are always blocked and cannot be unblocked.

Copilot responses are slow or time out​

Check the following:

  1. OpenAI API status: verify that OpenAI's API is operational at status.openai.com.
  2. API key validity: ensure your OpenAI API key is still active and has sufficient quota.
  3. Database query timeout: if Copilot is running slow queries, increase the Query Timeout in Tools Settings. The maximum allowed value is 300 seconds.

Invalid or expired API key​

Copilot cannot connect to the AI service.

Solution: go to Stores -> Configuration -> Mirasvit Extensions -> AI Copilot -> General Settings and verify the OpenAI Secret Key is correct and active. Generate a new key at platform.openai.com/account/api-keys if needed.