MCP Bridge

Prev Next

Configuration Options

From the Applications page, create an MCP Bridge App by clicking the Create button and selecting MCP Bridge App from the Create a new Application menu.

Field Name

Description

Example

Name

A friendly name for your OIDC application.

ExampleApp

App Icon

Upload an image for your application to display in Maverics.

Maverics supports JPEG, PNG, or SVG, up to 2MB maximum.

OpenAPI Spec File Path

Specify the OpenAPI definition using YAML, JSON, or the file path in the orchestrator host environment. The file path field supports file:// URIs for local files.

Base URL Override

Optional. Overrides the URL of where the are actually published if they are different than what is defined in the OpenAPI spec.

OPA Policy Definition

The Inbound Request Policy section specifies authorization rules that govern who or what can call the MCP Bridge. You can define Open Policy Agent (OPA) rules to enforce fine-grained access control for incoming requests. For instance, policy authors may want to craft policies that restrict requests to a certain network zone. The OPA Policy Definition is the Open Policy Agent driven authorization policy.
Click Edit to define a OPA policy in the Rego format.
Learn More About OPA Authorization

Outbound Policy Authorization Type

Unprotected (not recommended)

Token Exchange (Default)

OIDC Identity Provider

Specifies the OIDC identity provider used for token exchange.

Audience

The audience (aud) claim requested during token exchange, specifying the intended recipient of the issued token.

Tool Mappings

Defines the relationship between MCP tools and the OAuth scopes required to use them. Each tool exposed by the MCP Bridge can be mapped to one or more scopes that must be requested in order to interact with the backend API.

E.g.:

getTicketsPrice: tickets:read

postTicketsPrice: tickets:write

Deploying the application

Deployments in Maverics are how you bundle and publish your orchestration configurations — including applications, user flows, identity services, and policy logic — to your orchestrators for enforcement. Before deploying, review the Deployment Overview to understand how environments, services, and storage work together in Maverics.

Add your application to a deployment

Once your storage is configured, you can deploy your application using the Deployment Manager:

  1. Navigate to Deployments in the Maverics UI.

  2. Create a new deployment or select an existing one.

  3. Add your application(s) to the deployment.

  4. Click Publish Preview to review and validate the deployment configuration.

  5. After confirming the preview looks correct, click Publish to push the configuration to your orchestrators.