Installed Application Settings

Installed applications can be customized with their own settings.

To edit the settings for an installed application, select the "Edit Settings" button within the application card in Vertesia Studio (Vertesia Studio > Settings > Applications > Installed Apps).

  • Note: If you do not have permission to edit the application, you will not be able to make changes.

OAuth Credentials at Install Time

If an app's manifest declares MCP collections with oauth_config.required_at_install, Vertesia displays a credential form before completing the installation. Required fields may include:

FieldDescription
Client IDYour OAuth client identifier, if each project registers its own client with the provider.
Client SecretYour OAuth client secret. Secrets are encrypted at rest and never stored in the manifest.
ScopesAdditional OAuth scopes to request, added on top of the manifest's default_scopes.

After install, the OAuth provider created from these credentials can be viewed and updated in Project Settings > OAuth Providers. Install-time credentials are associated with each MCP collection by its stable id, not its display name.

App Card Color

You can customize the colors used for the application card's appearance within the Vertesia App Portal. To do so, use the color property in the application settings:

{
  "color": "<color_name>"
}

Available Colors

When configuring application installations, you can choose from a variety of predefined colors to customize your applications's appearance:

redorangeamberyellowlimegreenemeraldtealcyanskyblueindigovioletpurplefuchsiapinkrose

Using Color Gradients

Applications support two different gradient formats for enhanced visual appearance:

Using Gradient Stops

Gradients can be specified using color names with numeric gradient stops:

  • Format: color-number
red-0red-1red-2red-3red-4

Using Two Colors

Create gradients that blend between two different colors:

  • Format: color-color
red-redred-orangered-amberred-yellowred-lime

Was this page helpful?