> ## Documentation Index
> Fetch the complete documentation index at: https://explore.airia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Server Management

> Approve which MCP servers your organization can use in Gateways and Deployments.

Server Management is the tenant-wide approval layer for MCP servers. It decides which servers show up when someone builds a [Gateway or Deployment](/mcps/admin-controls/gateway-deployment-creation), for everyone in your organization. Find it at **[https://airia.ai/settings/mcp-servers](https://airia.ai/settings/mcp-servers)**.

The list combines two sources: Airia's built-in server catalogue and any [custom servers](/mcps/admin-controls/custom-mcp-servers) your organization has added.

Server Management controls *availability*, not connection. It decides which servers your org can use. Configuring an individual server's connection details or credentials happens separately, when you add that server to a Gateway or Deployment.

## Default Mode vs. Custom Mode

Your organization is always in one of two modes.

|                      | Default Mode                                   | Custom Mode                                                |
| -------------------- | ---------------------------------------------- | ---------------------------------------------------------- |
| **What's enabled**   | Every catalogue server marked `Available`      | Only the servers you approve, including `Preview` servers  |
| **New GA servers**   | Become usable automatically as Airia adds them | Stay off until you approve them                            |
| **How you enter it** | The starting state                             | Automatically, the moment you approve or revoke any server |

To discard your custom selections and hand the enabled list back to Airia, use **Reset to Default**. This re-enables every `Available` server and drops your custom choices.

<Warning>
  **Reset to Default is not reversible.** It discards every approval and revocation you've made. Confirm your selections before you use it.
</Warning>

## The server list

Each row is a single server, from either the catalogue or your custom servers.

| Column       | What it shows                                                                                                                                                       |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Server**   | Icon, name, status badge, and description. The header also shows how many servers are enabled out of your total, for example "14 of 1200 servers enabled globally." |
| **Category** | The server's category, used for filtering.                                                                                                                          |
| **Featured** | A star that pins an approved server to the top of the picker users see. Available only after a server is approved, and not shown for custom servers.                |
| **Status**   | The **Approve** / **Approved** control. This is the main switch that turns a server on or off for your organization.                                                |

Use the search box and the **Category**, **Featured**, and **Status** filters above the table to narrow a long list. Each row has an actions menu for viewing server details, and for custom servers, editing or deleting them.

## Server status badges

| Status        | Meaning                                                                                                                                             |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Available`   | Production-ready and fully tested. Stable and recommended for all users.                                                                            |
| `Preview`     | Has not gone through thorough quality testing, but initial testing is promising.                                                                    |
| `Coming Soon` | An official third-party server that exists but is in active development by the provider. Potentially usable, but server-side bugs are not uncommon. |
| `Deprecated`  | Being phased out.                                                                                                                                   |
| `Custom`      | A server your organization added itself, rather than one from Airia's catalogue.                                                                    |

## Approve and revoke servers

Approving a server makes it usable in Gateways and Deployments across your organization.

<Steps>
  <Step title="Approve a single server">
    Click **Approve** on the server's row. The control becomes an **Approved** badge with a small remove action next to it.
  </Step>

  <Step title="Revoke a server">
    Click the remove action on the **Approved** badge to make the server unavailable again.
  </Step>

  <Step title="Act on several servers at once">
    Turn on **Bulk Edit** to add a checkbox to each row and a bar at the bottom of the screen with **Approve servers** and **Remove approvals** actions. Select the servers you want, choose an action, then click **Save Changes**.
  </Step>
</Steps>

<Warning>
  A server that a Gateway or Deployment currently uses can't have its approval removed until you take it out of those Gateways and Deployments first. If you try, Airia shows you exactly which Gateways or Deployments are using it.
</Warning>

## Feature servers

Once a server is approved, mark it as **Featured** with the star icon. Featured servers are pinned near the top of the server picker your users see when building Gateways and Deployments, so your organization's most important integrations are easier to find.

A server must be approved before it can be featured, and featuring is not available for custom servers.

## Restricted servers

Some catalogue servers are marked `Restricted` and aren't visible to every organization by default, similar to an early-access or partner integration.

If Airia has granted you access to a `Restricted` server, use **Add Restricted Server** and enter the server's library ID. It then appears in your server list like any other catalogue server. The same dialog removes access when you no longer need it.

## Manage custom servers

Custom servers you've added can be edited or deleted from the row's actions menu, unlike catalogue servers.

Deleting a custom server that one or more Gateways currently use checks that usage first and warns you which Gateways will be affected before you proceed. To add a new custom server, see [Custom MCP Servers](/mcps/admin-controls/custom-mcp-servers).

## Who can access Server Management

Server Management is available to the **Platform Admin**, **Admin**, and **Security Admin** roles. If your organization uses [custom roles](/admin-hub/account_settings/custom-roles), access is controlled instead by the dedicated MCP server management permissions assigned to that role.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can't remove a server's approval">
    **Cause:** A Gateway or Deployment is still using the server. Approval can't be revoked while it's in use.

    **Fix:** Remove the server from the Gateways and Deployments Airia lists, then revoke its approval. The list of affected Gateways and Deployments appears when you attempt the revoke.
  </Accordion>

  <Accordion title="A newly released catalogue server isn't available to my org">
    **Cause:** Your organization is in Custom Mode, so new GA servers stay off until you approve them.

    **Fix:** Approve the server on its row, or use **Reset to Default** to return to letting Airia enable every `Available` server automatically.
  </Accordion>

  <Accordion title="Can't feature a server">
    **Cause:** The server isn't approved yet, or it's a custom server. Featuring is only available for approved catalogue servers.

    **Fix:** Approve the server first. If it's a custom server, featuring isn't supported.
  </Accordion>

  <Accordion title="A server I need isn't in the list at all">
    **Cause:** The server may be `Restricted`, or it isn't in Airia's catalogue.

    **Fix:** If Airia has granted you access to a `Restricted` server, use **Add Restricted Server** with its library ID. Otherwise, add it as a [custom server](/mcps/admin-controls/custom-mcp-servers).
  </Accordion>
</AccordionGroup>

## Related Resources

<CardGroup cols={2}>
  <Card title="Custom MCP Servers" icon="plus" href="/mcps/admin-controls/custom-mcp-servers">
    Add a server that isn't in Airia's catalogue
  </Card>

  <Card title="Gateway/Deployment Creation" icon="plug" href="/mcps/admin-controls/gateway-deployment-creation">
    Put approved servers behind a Gateway or Deployment
  </Card>

  <Card title="Deployments vs. Gateways" icon="code-compare" href="/mcps/admin-controls/deployments-vs-gateways">
    Decide which connection model fits your use case
  </Card>

  <Card title="MCP Monitoring" icon="chart-line" href="/mcps/admin-controls/mcp-monitoring">
    Inspect tool calls, denials, and errors
  </Card>
</CardGroup>