Using the MCP Server in Claude Code

​

Requirements

• To install Claude Code
• To have the following enabled in Omni:
  • The MCP Server AI setting. An Organization Admin can enable this setting by navigating to Settings > AI > General.
  • Personal access tokens (PATs). An Organization Admin can activate them by going to Settings > API Keys > Personal tokens.

​

Setup

• Claude Connector (Recommended)
• Manual CLI Setup

The official Omni connector for Claude provides the fastest setup experience with no manual configuration required.

1

Install the connector

Visit the Omni Analytics connector page and click Add to Claude to install the connector. This adds the Omni MCP server to both Claude Desktop and Claude Code.

2

Start a new Claude Code session

Run claude to start a new session. The Omni MCP server will be available automatically.

3

Authorize the connection

1. Claude Code will detect the Omni connector and prompt you to authenticate.
2. Your browser will open and redirect you to an Omni authorization page.
3. Review the requested permissions and click Authorize.

Omni will automatically create a Personal access token and link it to your Omni user account.

4

Verify the connection

At this point, you should be able to use the Omni MCP server in your Claude Code sessions:

You can also add the Omni MCP server manually via the Claude Code CLI.

1

Add the Omni MCP server

In your terminal, run the following command:

Copy

Ask AI

claude mcp add --transport http omni https://callbacks.omniapp.co/callback/mcp

2

Start a new Claude session

Run claude to start a new session.

3

Authenticate with Omni

1. Run /mcp to open the MCP servers list:
2. Navigate to and select the Omni MCP server:
3. Press Enter to select the Authenticate option.
4. Your browser will open and redirect you to an Omni authorization page.
5. Review the requested permissions and click Authorize.

Omni will automatically create a Personal access token and link it to your Omni user account.

4

Verify the connection

At this point, you should be able to use the Omni MCP server in your Claude Code sessions:

​

Troubleshooting

Permission to use mcp__omni__pickModel has been denied because Claude Code is running in don't ask mode