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 Mintive via per-user OAuth.

Prerequisites​

  • A Mintive 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 Mintive​

  1. In Mintive, go to MCP store > Manage store.
  2. Open the Catalog 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​