Skip to main content

​
Connection Issues

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

​
Authentication Errors

Problem: 401 Unauthorized responses
  • For an API key, verify the format is Bearer apikey_...
  • Check that the key or OAuth token hasn’t expired or been revoked
  • Ensure the client sends the Authorization header on the initial handshake, tools/list, and every tool call
  • If the client supports OAuth, follow the WWW-Authenticate challenge to discover the sign-in flow
  • Do not rely on a browser cookie; cookies do not authenticate MCP requests
  • Try regenerating your API key in the dashboard

​
ChatGPT: “There was a problem connecting”

If you are having trouble adding a custom Gumnut connector, use the Gumnut plugin in ChatGPT to connect your account. See MCP Setup → ChatGPT for setup instructions. If the plugin connection still fails, contact support.

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