Set up the Okta Managed MCP Server from the OIN catalog

Add the Okta Managed MCP Server app from the Okta Integration Network (OIN) and connect it to an Agent Gateway to secure AI agent tool calls.

About this task

Early Access release

If you have the Okta for AI Agents license, you can add the Okta Managed MCP Server app from the OIN catalog and pair it with an Agent Gateway. The Agent Gateway acts as a runtime enforcement layer. It extends identity policies and continuous auditing to every tool call that an AI agent makes.

This method requires the Okta for AI Agents license. If you don't have the Okta for AI Agents license, connect your MCP client directly with an OIDC app instead. See Set up the Okta Managed MCP Server with an OIDC app. For a comparison of the two methods, see Getting started.

Before you begin

  • Confirm that your org has the Okta for AI Agents license.
  • Create a separate OIDC web app in Okta with the scopes that your use cases require. See Scope-based tool loading.

Procedure

  • Register the AI agent

    1. Register or import the AI agent, assign it to the target user, and activate it.
    2. Add the redirect URI of your AI agent client to the OIDC app of the agent.

      When you register an AI agent, Okta creates an OIDC app for it and generates its client ID. In the Admin Console, go to Applications and resources > Applications, open the app of the agent, and enter the callback URI that your AI agent provider specifies in the Sign-in redirect URIs field. This is the same process as for any other OIDC app. See OpenID Connect (OIDC) with Proof Key for Code Exchange (PKCE). For client identity methods and platform guidance, see Configure an AI agent for Agent Gateway.

  • Configure the Okta Managed MCP Server from the OIN catalog

    1. In the Admin Console, go to Applications and Resources > MCP Servers.

      For the general steps to add an MCP server from the catalog, see Add an MCP server from the OIN catalog.

    2. Click Add from Catalog.
      The Okta Integration Network catalog opens.
    3. Find Okta Managed MCP Server and click its tile.
    4. Click Add MCP Server.
      The Add MCP Server page opens, with the name, description, and resource URL prefilled from the catalog.
    5. Click Save.
    6. To configure the access method, find the authorization server and click Configure.
      The configuration page opens, with the authorization server settings prefilled.
    7. Add credentials for the Okta Managed MCP Server.

      You can't edit authorization server details that are populated automatically from the OIN catalog.

      1. Enter a Client credentials name.
      2. Enter the Client ID and Client secret of the OIDC web app that you created before you began.
      3. Select Customize scopes and choose the scopes that you need.

        The scopes that you select determine which tools the Okta Managed MCP Server makes available. See Scope-based tool loading.

      4. Click Save.
    8. Click Test credentials and discover tools to validate your credentials and view the available tools.
    9. Click Done and close.
      The Okta Managed MCP Server appears on the MCP Servers page.
  • Configure the Agent Gateway

    1. Create an Agent Gateway and assign the registered agents to it.

      See Add an Agent Gateway. To create the Agent Gateway with the API, see Configure an Agent Gateway.

    2. Connect the Okta Managed MCP Server to the Agent Gateway. You can also connect other MCP servers to the same gateway.

      See the Add resource connections section of Add an Agent Gateway.

    3. Define the tool-level authorization policies. Specify which connected agents can call which tools.

      See the Customize your tools section of Add an Agent Gateway.

    4. Activate the Agent Gateway.

      See the Activate the Agent Gateway section of Add an Agent Gateway.

    5. On your agent provider platform, register the Agent Gateway URL as an MCP server endpoint.

      Use the Agent Gateway URL, the agent's client ID, and the configured callback port. For client-specific guidance, see AI agent client configurations. The Agent Gateway URL is on the Agent Gateway page, as described in Add an Agent Gateway.

    The agent calls the Okta Managed MCP Server tools through the Agent Gateway, and the Agent Gateway enforces your tool-level policies on every call.