Ctrlk
Book a demo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

MCP Integration Using OAuth

This guide explains how to connect your IDE or AI coding tool to OX Security by using the OX MCP server and your OX Security account.

The first time your tool connects, sign in to your OX Security account in your browser instead of creating an MCP Integration Key.

You can use this guide to configure:

The OX MCP server URL is: https://mcp.app.ox.security/

Note: Browser sign-in is available only with the SaaS OX MCP server. If you use an on-premises deployment, authenticate by using an MCP Integration Key instead. For instructions, see MCP Integration Guide using an MCP Integration Key.

Log into OX Security

The following login process is applicable to any tool used with this integration method.

  1. Log in to OX if you are not already signed in.

Note: If your organization requires SSO, sign in using your enterprise email address.

  1. Select the OX organization to authorize MCP access for.

Note: If you belong to a single OX organization only, it is selected automatically, and this step is skipped.

The Authorization Complete message appears, and you are redirected back to your IDE or AI coding tool; OX Security now appears as a connected MCP server.

Integrating Cursor with OX MCP

By integrating with OX's MCP, Cursor becomes a security-aware development assistant, able to query live security data, suggest actions, and triage issues directly from your IDE.

To integrate Cursor with OX MCP:

  1. Click here to open Cursor in the relevant location where you can start working.

  2. Select Install. No token or header configuration is required.

In the Cursor MCP settings, the ox-security server appears with a Needs authentication indication.

  1. Select Connect.

The browser opens the OX Security authorization page.

  1. Complete the login as described in Logging in to OX Security.

After logging in, the OX Security logo appears in the Cursor tools menu with the list of available tools. For more info, refer to Cursor Documentation.

Integrating Claude Desktop with OX MCP

Claude Desktop connects to the OX MCP server as a custom connector, providing teams with robust security capabilities directly from their desktop environment. No local configuration file is required.

To integrate Claude Desktop with OX MCP:

  1. In Claude Desktop, go to Settings > Connectors.

  2. Select Add custom connector.

  3. Set a name (for example, OX Security) and the URL:

  1. Select Add.

  1. Open the new OX Security connector and select Connect.

The browser opens the OX Security authorization page.

  1. Complete the login as described in Log into OX Security.

After authorization, OX Security tools are available in Claude Desktop conversations through the tools menu.

  1. Review and adjust what Claude is allowed to do with each OX Security tool under Settings > Connectors > OX Security > Tool permissions.

Integrating Claude Code with OX MCP

Claude Code, Anthropic's agentic coding tool for the terminal, connects to the OX MCP server directly from the command line, allowing developers to query live security data, triage issues, and get remediation guidance without leaving their coding session.

Note: Ensure Claude Code is installed and up to date. To check your version, run claude --version; to update, run claude update.

To integrate Claude Code with OX MCP:

  1. Open a terminal and run the following command:

  1. Start Claude Code:

  1. Run the /mcp command, select ox-security (shown with a needs authentication status), and choose Authenticate.

The browser opens the OX Security authorization page.

  1. Complete the login as described in Log into OX Security.

  1. Return to the terminal. The /mcp menu now shows ox-security with a connected status, along with the OX Security tools available to Claude Code.

By default, the server is added only for the current project directory. To make it available in all of your projects, add --scope user to the command in step 1.

Integrating Visual Studio Code with OX MCP

Visual Studio Code provides versatile options to connect with OX Security's MCP, enabling developers to streamline their security workflows within the VS Code ecosystem.

To integrate VS Code with OX MCP:

  1. Open VS Code Settings.

  2. Open MCP User Configuration, see VS Code MCP Docs for details.

  1. Add the JSON MCP server configuration for OX Security in mcp.json:

  1. Save the configuration and start the server. When VS Code prompts that the MCP server requires authentication, select Allow.

The browser opens the OX Security authorization page. complete the login as described in Log into OX Security.

  1. In the VS Code chat, click Add Context.

  1. Select the desired tools.

OX Security appears as an available MCP server.

Last updated