MCP Troubleshooting

Common issues and quick fixes when using MCP with Zuro.

Connection Problems

AI Assistant Can't Connect

Try these steps:

1. Check your MCP key

   • Make sure the key is correct
   • Key should start with zuro_mcp_
   • Verify the key hasn't been deleted

2. Verify your plan

   • MCP requires Professional or Enterprise plan
   • Check your subscription is active

3. Check configuration

   • Verify the server URL: https://api.zuro.me/api/mcp
   • Make sure the key is in the URL as a query parameter: ?key=YOUR_KEY
   • Check JSON syntax if using config files

4. Restart your AI assistant

   • Fully quit and restart the application
   • Some assistants need a restart after config changes

"Invalid MCP Key" Error

• Verify the key starts with zuro_mcp_
• Check you copied the complete key
• Try creating a new key if needed

"Permission Denied" Error

• Check your key has the required permissions
• Update key permissions in Settings → API → MCP Keys
• Create a new key with correct permissions if needed

Rate Limit Issues

"Rate Limit Exceeded" Error

Your limits:

• Professional: 1,000 requests/hour per key
• Enterprise: 5,000 requests/hour per key

Solutions:

• Wait for the limit to reset (usually within an hour)
• Check your usage in Settings → API → MCP Keys
• Upgrade to Enterprise for higher limits
• Use multiple keys to distribute load

Configuration Issues

"Command Not Found" Error

You need Node.js installed:

1. Download from nodejs.org
2. Install it on your computer
3. Restart your AI assistant

Configuration Not Working

• Restart your AI assistant - Fully quit and restart
• Check file location - Make sure config file is in the right place
• Validate JSON - Use a JSON validator to check syntax
• Check file permissions - Ensure the file is readable

Tool Issues

"Tool Not Available" Error

• Check your key has the required permission
• Verify the tool name is correct
• Make sure the knowledge base exists

"Knowledge Base Not Found" Error

• List your knowledge bases to verify the ID
• Check if the knowledge base was deleted
• Ensure you have access to the knowledge base

Performance Issues

Slow Responses

• Check your internet connection
• Break large operations into smaller ones
• Check Zuro service status

Timeout Errors

• Increase timeout settings in your AI assistant if possible
• Simplify operations
• Break complex tasks into steps

Still Having Issues?

1. Check the documentation

   • Review MCP Setup Guide
   • Check your AI assistant's documentation

2. Review error messages

   • Note the exact error message
   • Check error codes

3. Contact support

   • Email: support@zuro.me
   • Include error messages
   • Describe what you were trying to do
   • Don't include your MCP key in emails