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.

Claude.ai

Go to Settings → Connectors
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 Settings → MCP → Add 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.

ChatGPT

Go to chatgpt.com/#settings/Connectors
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:

Setting	Value
Server URL	`https://app.useomnia.com/mcp`
Transport	Streamable HTTP
Auth	OAuth

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