Connecting to the GoMarble MCP Server

Server URL: https://apps.gomarble.ai/mcp-api/sse

This server requires authentication with your Google account/Email. When connecting, you will be prompted to authorize the application to access your data through OAuth.

Troubleshooting

Common Issues and Solutions

Authentication Fails

• Try logging out of your account and logging back in

• If that doesn't address the issue or you see a "Client not found" error, try removing the MCP integration within your client and adding it back

Connection Issues

• Ensure your MCP client supports SSE-based servers (not Streamable HTTP)

• Check that your client can handle OAuth authentication flows

• Verify you have the necessary permissions in your workspace

Additional Troubleshooting Steps

1. Clear Authentication Cache: Delete the ~/.mcp-auth directory and re-authenticate

2. Check Network Connectivity: Ensure you can reach https://apps.gomarble.ai/mcp-api/sse

3. Verify Account Status: Confirm your account is active and has appropriate permissions

4. Update Client Software: Make sure you're using the latest version of your MCP client

5. Review Logs: Check your client's logs for specific error messages

Security Considerations

• The MCP server uses OAuth 2.0 for secure authentication

• All data transmission is encrypted using HTTPS

• User permissions are strictly enforced

• Access tokens have limited lifetime and scope

• Regular security audits are performed

Best Practices

For Developers

• Always handle authentication errors gracefully

• Implement proper error handling for API calls

• Use appropriate rate limiting in your applications

• Cache responses when appropriate to improve performance

For Users

• Regularly review connected applications

• Use strong, unique passwords for your account

• Enable two-factor authentication when available

• Monitor your account for unusual activity

API Rate Limits

To ensure fair usage and system stability:

• Standard Users: 25 requests per minute

Rate limits are applied per user account and reset every minute.

Support

For additional help with our MCP server:

• Community Forum: Join our developer community for peer support

• Email Support: Contact our support team directly

Getting Help

When contacting support, please include:

• Your account information

• The MCP client you're using

• Error messages or logs

• Steps to reproduce the issue

• Expected vs. Actual behavior