Cursor is an AI-powered code editor that can connect with other tools—like Omni!—with MCP. Once successfully connected, you can interact with your Omni data right in Cursor’s interface.
Requirements
Every person who wants to use the MCP Server must complete the setup.
- A version of Cursor that supports MCP
- To have the following enabled in Omni:
Setup
Choose your authentication method. See the MCP authentication guide if you need help selecting a method.
OAuth (Recommended)
API Key
OAuth provides streamlined setup without manually managing API keys.Open MCP settings
In Cursor, click Cursor > Settings > Cursor settings.
Add a new MCP server
Click Tools & Integrations in the settings navigation, then click New MCP Server under MCP Tools.
Configure the server
Cursor will create an mcp.json file. Paste the following:{
"mcpServers": {
"Omni": {
"url": "https://callbacks.omniapp.co/callback/mcp"
}
}
}
Authorize the connection
Before you can use the MCP, you’ll need to authorize the connection.
- Click the Connect button next to the MCP.
- Your browser will open and redirect you to an Omni authorization page.
- Review the requested permissions and click Authorize.
Omni will automatically create a Personal access token and link it to your Omni user account. Verify the connection
At this point, you should be able to use the Omni MCP server in Cursor chats.
API key authentication gives you direct control over key management.Create an API key
If you don’t have an Omni API key, create one before continuing. Open MCP settings
Open the Command Palette (⌘ + Shift + P on Mac, Ctrl + Shift + P on Windows), search for MCP, and select View: Open MCP Settings.
Add a new MCP server
Click Tools & Integrations in the settings navigation, then click New MCP Server under MCP Tools.
Configure the server
Cursor creates an mcp.json file. Paste the following:{
"mcpServers": {
"Omni": {
"url": "https://<YOUR-OMNI-INSTANCE>/mcp/https",
"headers": {
"Authorization": "Bearer <OMNI_API_KEY>",
"X-MCP-Model-ID": "<OPTIONAL_OMNI_MODEL_ID>",
"X-MCP-Topic-Name": "<OPTIONAL_TOPIC_NAME>",
"X-MCP-User-Required": "<true/false>",
"X-MCP-User-ID": "<OPTIONAL_OMNI_USER_ID>"
}
}
}
}
Replace placeholder values
<YOUR_OMNI_INSTANCE> - Required. Your Omni URL (e.g., acme.omniapp.co)<OMNI_API_KEY> - Required. Your Omni API key. Cursor also supports environment variables for the key.<OPTIONAL_OMNI_MODEL_ID> - Optional. Scope the MCP to a specific model. Find the model ID in the URL when viewing the model:
https://acme.omniapp.co/models/9d9440e5-8522-4507-b092-1ac26ba26673/ide/model
<OPTIONAL_TOPIC_NAME> - Optional. Scope the MCP to a specific topic<true/false> - Optional. Require a User ID to execute queries with that user’s permissions (default: false)<USER_ID> - Optional. Execute queries as this user. Get IDs from the List Users API
Save the file.Verify the connection
Check the server’s status in Settings:
Using the MCP
Once the MCP Server is connected, Cursor automatically uses it when you ask questions about your data. You can prompt Cursor to use Omni by referring to it by name or description.
Open the AI pane/chat panel and select Agent mode:
Enter a prompt, such as Hey Omni, tell me how many users have been sourced by search and email.
Each time Cursor uses an MCP tool, you’ll be prompted to approve its usage. Click Run tool to proceed.
You can also use Cursor’s Yolo mode to automatically run MCP tools without requiring approval. The MCP Server will pick a model (if not configured) and topic, then run a query to retrieve the data:
