Troubleshooting

Solutions to common issues when connecting to or using the Obris MCP server.

Authentication errors

OAuth popup blocked

Your browser may block the Obris authorization popup during setup. Allow popups for your AI platform's domain, then try connecting again.

Token expired or revoked

If your AI assistant stops being able to access Obris, your OAuth token may have expired or been revoked. Disconnect and reconnect Obris from your AI platform's MCP settings, or re-authorize from the Integrations page.

"Not authenticated" error

This means the MCP client did not send a valid access token. Make sure you completed the OAuth authorization flow and that your connection is still active.

Tools not returning data

"No projects found"

Your account has no projects yet. Create a project and save at least one reference in the Obris app before using MCP tools.

"Project not found"

The project_id passed to get_project_references doesn't match any project in your account. Call list_projects first to get valid project IDs.

"No references in this project"

The project exists but has no saved references. Use the Obris browser extension to save content into this project.

Connection issues

Wrong server URL

The Obris MCP server URL is https://mcp.obris.ai. Make sure there are no trailing slashes or extra path segments.

MCP connector not showing in AI platform

Not all AI platforms support remote MCP servers. Check the MCP Connectors guide for the list of supported platforms and setup instructions.

AI assistant not invoking Obris tools

AI platforms decide when to call MCP tools based on your prompt. Try mentioning Obris explicitly — for example:

Using Obris, what projects do I have?

Contact support

If you're still experiencing issues, reach out to us at support@obris.ai.