MCP Connection Troubleshooting

This guide covers common issues when connecting to Eyevinn Open Source Cloud via MCP (Model Context Protocol) in Claude Desktop or other MCP clients.

Auth Window Doesn't Open

When you add the OSC MCP server to Claude Desktop and the OAuth authentication window doesn't appear:

Windows

  1. Check default browser: Ensure a default browser is set in Windows Settings → Apps → Default apps
  2. Try opening the auth URL manually: Copy and paste https://mcp.osaas.io/auth into your browser
  3. Check firewall/proxy: Corporate firewalls or VPNs may block the OAuth redirect. Try disconnecting from VPN temporarily
  4. Restart Claude Desktop: Close Claude Desktop completely (check system tray) and reopen it
  5. Update Claude Desktop: Ensure you're running the latest version — older versions may have OAuth compatibility issues

macOS

  1. Check default browser: System Settings → Desktop & Dock → Default web browser
  2. Try opening the auth URL manually: Visit https://mcp.osaas.io/auth in your browser
  3. Check if browser handles https:// links: Open Terminal and run open https://mcp.osaas.io/auth
  4. Restart Claude Desktop: Quit from the menu bar and reopen

Manual Auth Fallback

If the automatic OAuth flow doesn't work, you can authenticate manually: 1. Open https://mcp.osaas.io/auth directly in your browser 2. Complete the sign-in process 3. After successful authentication, return to Claude Desktop 4. The MCP connection should now be established

Connected But No Tools Appear

If Claude Desktop shows the MCP server as connected but no tools are available: 1. Verify the MCP URL: Use https://mcp.osaas.io/mcp (not /sse or other paths) 2. Re-open Claude Desktop: Close and reopen Claude Desktop after connecting 3. Check your plan: Some tools require a paid plan. Use the chat to ask about your current plan

Authentication Expired

MCP authentication tokens expire periodically. If tools stop working: 1. Remove the MCP server from Claude Desktop settings 2. Re-add it with the URL https://mcp.osaas.io/mcp 3. Complete the OAuth flow again

Still Having Issues?

Join the community Slack at https://slack.osaas.io for help from the OSC team.