Add an MCP server manually

Add a Model Context Protocol (MCP) server by manually entering its connection details, and then choose how to secure it.

Before you begin

  • You have the super admin role or a custom role with the Manage third-party MCP Servers permission and resource type. See Use custom admin roles.
  • If you're securing your MCP server with an Okta custom authorization server, you've already created one. See Create an authorization server.

Procedure

  1. In the Admin Console, go to Applications and Resources > MCP Servers.
  2. Click Add custom MCP.
    The Add MCP server page opens.
  3. Enter a name, description, and resource identifier URL for the MCP server.
  4. Click Save.
  5. Add an authorization server.

    If Okta discovers an authorization server from the resource identifier URL, it appears on the page. Click Configure to review its details and skip the substeps that add a server.

    1. Click Add authorization server.
    2. Select an authorization server type: Okta custom authorization server or External server.
  6. To add more authorization servers, click Add authorization server and repeat the previous step.

What to do next

Choose how AI agents access the MCP server. See Configure Cross App Access for an MCP server and Configure Brokered Consent for an MCP server.