Skip to main content

​
Connection Issues

Problem: MCP client can’t connect
  • Verify the server URL is exactly https://mcp.gumnut.ai/mcp
  • Check your internet connection
  • Ensure your API key is valid
  • Try the health endpoint: curl https://mcp.gumnut.ai/health

​
Authentication Errors

Problem: 401 Unauthorized responses
  • Verify API key format: Bearer apikey_...
  • Check the key hasn’t been revoked
  • Ensure proper Authorization header
  • Try regenerating your API key in the dashboard

​
Rate Limiting

Problem: 429 Too Many Requests
  • Check the retry-after header
  • Implement exponential backoff
  • Consider request batching
  • Monitor your usage in the dashboard

​
CORS Issues

Problem: Browser-based client CORS errors
  • Ensure using HTTPS
  • Check browser console for details
  • Verify client sends proper headers
  • Contact support if the issue persists

​
Tool Not Appearing

Problem: Gumnut tools don’t show up in your AI assistant
  • Restart your AI tool after configuration
  • Check configuration file syntax (valid JSON)
  • Verify the server name matches in your config
  • In Claude Code, run claude mcp list to verify registration
  • In Cursor, check Settings > MCP and click refresh

​
Support

Need help with the MCP server?