Skip to main contentSkip to navigation
API and Integrations

MCP Troubleshooting

Published 8 Jan 2026
3 mins read
Topics (5)

Common issues and quick fixes when using MCP with Dedox.

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 dedox_mcp_

    • Verify the key hasn't been deleted

  2. 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

  3. Check configuration

    • Verify the server URL: https://api.dedox.ai/mcp (no key in the URL)

    • Send the key in the X-MCP-Key header or as Authorization: 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

  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 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:

  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 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?

  1. Check the documentation

  2. Review error messages

    • Note the exact error message

    • Check error codes

  3. Contact support

    • Email: support@dedox.ai

    • Include error messages

    • Describe what you were trying to do

    • Don't include your MCP key in emails