MCP Troubleshooting
Common issues and quick fixes when using MCP with Dedox.
Connection Problems
AI Assistant Can't Connect
Try these steps:
-
Check your MCP key
-
Make sure the key is correct
-
Key should start with
dedox_mcp_ -
Verify the key hasn't been deleted
-
-
Verify your plan
-
MCP is available only on Professional or Enterprise plans. Starter and Team plans don't include MCP.
-
Check your subscription is active
-
-
Check configuration
-
Verify the server URL:
https://api.dedox.ai/mcp(no key in the URL) -
Send the key in the
X-MCP-Keyheader or asAuthorization: Bearer YOUR_KEY -
A key in the URL query string is rejected with HTTP 401
MCP_QUERY_KEY_DISABLED; move it into a header -
Check JSON syntax if using config files
-
-
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
dedox_mcp_. Keys created before October 2026 may use an older prefix and still work. -
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 Account Settings, Security tab
-
Create a new key with correct permissions if needed
Rate Limit Issues
"Rate Limit Exceeded" Error
Your limits:
-
Professional: 1,000 requests an hour per key
-
Enterprise: unlimited
Solutions:
-
Wait for the limit to reset (usually within an hour)
-
Check your usage in Account Settings, Security tab
-
Upgrade to Enterprise for unlimited MCP requests
-
Use multiple keys to distribute load on Professional
Configuration Issues
"Command Not Found" Error
You need Node.js installed:
-
Download from nodejs.org
-
Install it on your computer
-
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 help centre exists
"Help centre Not Found" Error
-
List your help centres to verify the ID
-
Check if the help centre was deleted
-
Ensure you have access to the help centre
Performance Issues
Slow Responses
-
Check your internet connection
-
Break large operations into smaller ones
-
Check Dedox service status
Timeout Errors
-
Increase timeout settings in your AI assistant if possible
-
Simplify operations
-
Break complex tasks into steps
Still Having Issues?
-
Check the documentation
-
Review MCP Setup Guide
-
Check your AI assistant's documentation
-
-
Review error messages
-
Note the exact error message
-
Check error codes
-
-
Contact support
-
Email: support@dedox.ai
-
Include error messages
-
Describe what you were trying to do
-
Don't include your MCP key in emails
-