> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runorion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and solutions for the Orion MCP server

## Connection Issues

### Authentication Fails

* Verify you are using valid Orion login credentials
* Try logging in to Orion directly at your organization's URL to confirm your account is active
* Clear your browser cookies and try authenticating again

### Client Cannot Reach the Server

* Confirm the server URL is `https://g.runorion.com/mcp`
* Check that there are no firewall or VPN restrictions blocking access
* Ensure your MCP client supports the `http` transport

## Tool-Specific Issues

### ask\_orion Returns Only an Acknowledgment

This is expected behavior. Orion's analyses are multi-step operations that take 1-2 minutes. The initial response is an acknowledgment. Your AI assistant should automatically poll `get_conversation_history` to retrieve the final analysis.

If the analysis never completes:

* Check that the `project_id` is valid and has connected data sources
* Verify the user has access to the specified project
* Try a simpler question to confirm the pipeline is working

### list\_artifacts Returns Empty

* Verify the project has published artifacts (dashboards, slides, or reports)
* Check that you are using the correct `project_id`

### Metric or Workflow Execution Fails

* Ensure the metric or workflow has valid data source connections
* Check that the underlying data source is accessible
* Try retrieving the metric or workflow details first with `get_metric` or `get_workflow` to inspect its configuration