Profiles

Introduction

If you want to restrict the servers available in your gateway for a certain circumstance, you can use a profile. A profile allows you to select only a subset of the your available servers. This profile can then by applied by:

• assigning it to your personal access token (PAT) and using this PAT to connect to the gateway
• setting a querystring parameter on your Gatana MCP URL: https://YOUR_ORG_ID.gatana.ai/mcp?p=PROFILE_ID
• sending a special header: x-gatana-profile-id: PROFILE_ID

Managing Profiles

You can create a profile by going to Profiles in the right menu in Gatana Web App. In this view you can see all your existing profiles, and a button to create new profiles. In the detail view of a profile you can assign the servers which this profile has access to. You should add at least one server to the profile, otherwise it will not be possible to call any tools when this profile is applied.

You can also manage profiles using the Gatana Public API.

Credential Scope

If you wish your profile to have their own credentials for the servers in your gateway, you can enable this setting by going into the details of your profile, clicking on Edit and enabling Credential Scoping.

When this is enabled and the profile is applied, any calls to a tool belonging to a server which requires user-scoped credentials will require credentials to be provided. This is the case even if your user already has user-scoped credentials.

If credential scoping is disabled for a profile, Gatana will use the the credentials belonging to the user.

For more information, see the documentation for Credentials.