Skip to main content

Set up the Omni Analytics MCP server

The Omni Analytics MCP server gives AI agents access to Omni's semantic layer — listing models, picking topics, querying data, and searching Omni documentation. This guide covers enabling Omni's hosted MCP server and connecting it to MintMCP via per-user OAuth.

Prerequisites​

  • A MintMCP admin account
  • An Omni organization with Organization Admin access
  • Personal Access Tokens (PATs) enabled for your Omni org

Enable the Omni MCP server​

Omni hosts its own MCP server, but the feature must be enabled at the organization level before any user can connect.

  1. In Omni, open Settings > AI > General.
  2. Toggle MCP server on.
  3. Open Settings > API Keys > Personal tokens and confirm PATs are enabled.

Add Omni Analytics to MintMCP​

  1. In MintMCP, go to MCP store > Manage store.
  2. Open the Recommended Servers tab and find Omni Analytics.
  3. Click to configure it and click Save.

Omni's authorization endpoint uses the cookie of the most recently logged-in Omni organization. Users who belong to multiple Omni organizations should log into the correct org in their browser immediately before connecting for the first time.

Security considerations​

  • Each user authenticates individually through OAuth, so tool calls are attributed to their Omni identity and limited by their existing Omni permissions and row-level security.
  • Omni creates an MCP OAuth PAT for each user automatically during the OAuth flow — no manual token management is required.
  • MCP OAuth PATs inherit the authenticating user's in-app permissions. Viewers can authenticate but cannot run queries.
  • MCP OAuth PATs are not visible in the Omni UI but can be retrieved via the List API tokens endpoint if needed.

Next steps​