🎯 Overview
Website Studio occasionally encounters import resolution errors, particularly with the ErrorBoundary component, and MCP (Model Context Protocol) connection issues that can block your project from loading. This guide walks you through diagnosing and resolving these problems quickly.
🔍 What Causes These Errors?
Import resolution errors typically occur when Website Studio cannot locate or properly load component dependencies. MCP connection issues arise when the platform loses communication with the backend services that power your project's functionality. Both can prevent your editor from loading or cause projects to break unexpectedly.
⚙️ How to Fix Import Resolution Errors
Step 1: Clear Your Browser Cache
Start by clearing your browser's cache and cookies for Search Atlas. This resolves many import errors caused by outdated cached files:
- Open your browser settings
- Navigate to Cache and Cookies
- Clear data for the Search Atlas domain
- Close and reopen Website Studio
Step 2: Force a Hard Refresh
After clearing cache, perform a hard refresh of the Website Studio page:
- Windows/Linux: Press Ctrl + Shift + R
- Mac: Press Cmd + Shift + R
This ensures Website Studio loads the latest component files and dependencies from the server.
Step 3: Check Your Project State
Navigate to Website Studio from the left sidebar and open your project. If the ErrorBoundary error persists, try these actions:
- Wait 30 seconds for the project to fully load
- Refresh the page again if the error appears immediately
- Check that your project was saved successfully in your last session
🌐 Resolving MCP Connection Issues
Step 1: Verify Your Internet Connection
MCP errors often stem from connectivity problems. Ensure your internet connection is stable and not being blocked by a firewall or VPN.
Step 2: Check Service Status
MCP connection failures can occur if backend services are temporarily unavailable. Wait a few minutes and try reconnecting. If the issue persists beyond 15 minutes, contact support.
Step 3: Reconnect MCP
If Website Studio shows an MCP connection error:
- Close the Website Studio editor tab
- Return to the main Search Atlas dashboard
- Re-open Website Studio from the left sidebar
- Allow 30-45 seconds for the MCP connection to re-establish
Step 4: Check for Authentication Issues
MCP connection errors can also indicate an authentication problem. If reconnecting doesn't work:
- Log out of Search Atlas completely
- Clear your browser cache again
- Log back in and return to Website Studio
🚀 Preventing Future Errors
To minimize import and MCP issues, follow these best practices:
- Save regularly: Save your projects frequently to avoid losing work during unexpected errors
- Monitor your connection: Keep your internet connection stable while working in Website Studio
- Update your browser: Use the latest version of your browser for compatibility
- Avoid multiple tabs: Don't open the same project in multiple browser tabs simultaneously
- Check browser extensions: Some extensions can interfere with Website Studio; disable them if errors occur
💡 If These Steps Don't Work
If you've followed all the steps above and your import or MCP error persists, the issue may require deeper investigation. If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team. When you contact support, include:
- The exact error message you're seeing
- Your project name
- Steps you've already tried
- Your browser type and version
- Whether the error occurs for all projects or just one
📋 Quick Reference Checklist
Use this checklist to resolve issues quickly:
- Clear browser cache and cookies
- Perform a hard refresh (Ctrl+Shift+R or Cmd+Shift+R)
- Wait 30 seconds for Website Studio to load
- Check your internet connection
- Close and reopen Website Studio
- Log out and log back in
- Contact support if errors persist