Omnia docs

Connecting to Omnia MCP

The Omnia MCP server is hosted at:

https://app.useomnia.com/mcp

Authentication is handled via OAuth, you'll be prompted to log in to your Omnia account the first time you connect.

A single connection gives you both data and discovery tools — no separate connector required.


Claude.ai

Go to SettingsConnectors

Click Add Connector and enter the server URL: https://app.useomnia.com/mcp

Complete the OAuth flow to connect your Omnia account

Once connected, Omnia tools will be available in any conversation


Claude Code

Run this command in your terminal:

claude mcp add --transport http omnia https://app.useomnia.com/mcp

Then authenticate:

claude /mcp

Select omnia from the list, choose Authenticate, and complete the OAuth flow in your browser. You'll see a confirmation that the connection was successful.


Cursor

Open Cursor SettingsMCPAdd new global MCP server

Paste the following configuration:

{
  "mcpServers": {
    "omnia": {
      "url": "https://app.useomnia.com/mcp"
    }
  }
}
Save and restart Cursor

When you use an Omnia tool for the first time, complete the OAuth flow to connect your account

Want to share the config with your team? Add a .cursor/mcp.json file to your project root with the same configuration above.


VS Code

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run MCP: Open User Configuration

Add the following to your mcp.json file:

{
  "servers": {
    "omnia": {
      "type": "http",
      "url": "https://app.useomnia.com/mcp"
    }
  }
}

Run MCP: List Servers from the Command Palette, start the Omnia server, and complete the OAuth flow when prompted


Windsurf

Open Windsurf Settings and search for MCP

Click View raw config to open mcp_config.json

Add the Omnia server:

{
  "mcpServers": {
    "omnia": {
      "serverUrl": "https://app.useomnia.com/mcp"
    }
  }
}

Save and restart Windsurf. Complete the OAuth flow when prompted.


Microsoft Copilot (VS Code)

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run MCP: Open User Configuration

Add the following to your mcp.json file:

{
  "servers": {
    "omnia": {
      "type": "http",
      "url": "https://app.useomnia.com/mcp"
    }
  }
}

Run MCP: List Servers from the Command Palette, start the Omnia server, and complete the OAuth flow when prompted


ChatGPT

Click Add Connector and enter the server URL: https://app.useomnia.com/mcp

Select OAuth as the connection mechanism and complete the login flow


Other MCP clients

If your client isn't listed above but supports MCP, use the following:

SettingValue
Server URLhttps://app.useomnia.com/mcp
TransportStreamable HTTP
AuthOAuth

Troubleshooting

My client doesn't support remote MCP servers

If your client only supports local stdio servers, you can bridge the connection using mcp-remote:

{
  "mcpServers": {
    "omnia": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.useomnia.com/mcp"]
    }
  }
}

Authentication issues

  • Make sure you complete the OAuth flow all the way through
  • If you're stuck, try disconnecting and reconnecting via your client's MCP settings
  • You must have an active Omnia account to authenticate. Sign up here

Tools aren't appearing

  • Restart your AI client after adding the server
  • Confirm the server URL is exactly https://app.useomnia.com/mcp (no trailing slash issues)
  • Run the server list command in your client to verify the connection status

On this page