Skip to main content

Users: Connect Cursor to the AI Gateway

To securely access your company's enterprise applications directly from Cursor, you must connect it to the JumpCloud AI Gateway. Connecting through JumpCloud ensures your enterprise data remains secure and your access is verified.

You can connect from the Cursor desktop app or Cursor Web (Agents). Both use the same AI Gateway URL for your JumpCloud datacenter region.

Important

Use the AI Gateway MCP server URL for your JumpCloud datacenter region. See JumpCloud Data Centers: Login URLs and Service Endpoints.

Configuring Cursor Desktop​

You can connect Cursor Desktop to the AI Gateway using Cursor's built-in MCP interface:

  1. Open the Cursor application.
  2. Go to Cursor Settings > Tools & MCPs and scroll down to Installed MCP Servers.
  3. Under New MCP Server, click + Add a Custom MCP Server.
  4. Copy the following and paste it into the mcp.json file. Use the URL for your datacenter region:
  • US: https://ai.jumpcloud.com/mcp
  • EU: https://ai.eu.jumpcloud.com/mcp
  • IN: https://ai.in.jumpcloud.com/mcp
{
  "mcpServers": {
    "jumpcloud-ai-gateway": {
      "url": "https://ai.jumpcloud.com/mcp"
    }
  }
}

The example uses the US URL.

  1. Click Save.
  2. In the list of Installed MCP Servers, click Connect next to jumpcloud-ai-gateway.
  3. Proceed to Authenticating Your Tools.

Configuring Cursor Web​

You can also connect Cursor Web (Agents) to the AI Gateway from the browser. See Cursor’s Model Context Protocol (MCP) to learn more.

  1. Open Cursor in your browser and sign in.
  2. On the Agents page, under the chat box, click + to expand the dropdown.
  3. Click MCP Servers > + Add MCP.
  4. In the Browse MCPs window, click Custom MCP.
  5. In the Add a Custom MCP window, click Edit JSON.
  6. Configure the JumpCloud AI Gateway using the same JSON as Cursor Desktop. Use the URL for your datacenter region:
  • US: https://ai.jumpcloud.com/mcp
  • EU: https://ai.eu.jumpcloud.com/mcp
  • IN: https://ai.in.jumpcloud.com/mcp
{
  "mcpServers": {
    "jumpcloud-ai-gateway": {
      "url": "https://ai.jumpcloud.com/mcp"
    }
  }
}

The example uses the US URL.

  1. Click Add MCP.
  2. Connect jumpcloud-ai-gateway, then proceed to Authenticating Your Tools.
note

Cursor uses different OAuth callback URLs for desktop and web. If your admin registers static OAuth redirect URLs for Cursor, both of the following may be required: http://localhost:8787/callback (desktop) and https://www.cursor.com/agents/mcp/oauth/callback (web/Agents).

Authenticating Your Tools​

Once Cursor is connected to the gateway, you must authorize and authenticate to the specific enterprise tools (such as Atlassian) before the AI can access them.

  1. You'll be redirected to the JumpCloud AI Gateway authorization page.

  2. Review the list of available enterprise tools and select the checkbox next to each tool you want your AI client to access.

  3. Authenticate to the selected tools based on their required connection method:

    • OAuth: Click Connect via OAuth. You'll be redirected to the application to securely sign in, and then returned to this page.
    • API Key: Enter your API key for the application in the text field and click Save. Click the documentation link provided in the UI if you need help finding your API token.

  4. Once all required tools display a green Connected status, click Authorize tools at the bottom of the page.

  5. You are redirected back to Cursor. Your AI client can now use the tools authorized through the gateway.

Was this information helpful?