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

# MCP Servers

> Register MCP servers, connect SaaS apps via OAuth, and manage active connections.

The **MCP Servers** screen is where you give agents tools from the outside world — Model Context Protocol servers you host, and SaaS apps you connect over OAuth. For what MCP is and how agents consume it, see [MCP integration](/concepts/mcp-integration).

The screen has three tabs.

<CardGroup cols={3}>
  <Card title="Servers">
    Your reusable MCP catalog entries.
  </Card>

  <Card title="Connected Apps">
    OAuth into 250+ SaaS apps via Composio.
  </Card>

  <Card title="Connections">
    Active and in-flight OAuth connections.
  </Card>
</CardGroup>

## Servers

This tab is your catalog of reusable MCP servers. Each entry can be attached to any agent, so you register a server once and reuse it everywhere.

<Frame caption="MCP — reusable server definitions, plus Connected Apps and live Connections tabs.">
  <img src="https://mintcdn.com/orcapods/QvGbh1ZeFOhKP6Fs/images/dashboard/mcp-servers.jpg?fit=max&auto=format&n=QvGbh1ZeFOhKP6Fs&q=85&s=91b67d5f74c9ca0fb01df3838c61bc1d" alt="MCP Servers page with Servers, Connected Apps, and Connections tabs" width="1440" height="688" data-path="images/dashboard/mcp-servers.jpg" />
</Frame>

### Add or edit a server

<Steps>
  <Step title="Open the dialog">
    Click **New server** (or **Edit** on a row) to open the server dialog.
  </Step>

  <Step title="Fill in the details">
    | Field              | Notes                                          |
    | ------------------ | ---------------------------------------------- |
    | **Name**           | Display name in your catalog.                  |
    | **Description**    | Optional summary of what the server provides.  |
    | **URL**            | The server endpoint.                           |
    | **Transport**      | `http` or `sse`.                               |
    | **Custom headers** | A headers editor for auth and routing headers. |
  </Step>

  <Step title="Reference secrets in headers">
    Header values can reference the secret vault with `secret://<name>` (for example an `Authorization` header set to `secret://my-mcp-token`). The plaintext is resolved at request time and never stored in the header itself. See [Secrets](/concepts/secrets).
  </Step>

  <Step title="Test the connection">
    Click **Test connection** to reach the server. On success it shows the round-trip **latency** and the server's **tool list**, so you can confirm the URL, transport, and headers before saving.
  </Step>
</Steps>

You can **create**, **edit**, and **delete** catalog entries from this tab.

<Note>
  Rows that are **owned by a Connected App** are managed for you and shown read-only — edit or remove them from the **Connected Apps** or **Connections** tab instead.
</Note>

## Connected Apps

This tab connects agents to SaaS apps through **Composio**, which brokers OAuth to 250+ providers (Gmail, Slack, Notion, GitHub, and more). See [Connected apps](/concepts/connected-apps).

The tab is an **app-card gallery** with a **search** box and a **category filter**.

<Steps>
  <Step title="Find an app">
    Search or filter by category, then pick the app card.
  </Step>

  <Step title="Connect">
    Click **Connect**. An **OAuth popup** opens for you to authorize. Orca **polls** the connection until it reaches **ACTIVE**.
  </Step>

  <Step title="Auto-registration">
    On success Orca **auto-registers** an MCP server for the app — it appears (read-only) under **Servers** and is ready to attach to agents.
  </Step>
</Steps>

Use **Disconnect** on a connected app to revoke it.

<Info>
  If the Composio integration isn't configured for your deployment, this tab shows a setup hint instead of the gallery.
</Info>

## Connections

This tab is a table of every active and in-flight OAuth connection, so you can audit what's linked and clean up stale entries.

| Column         | Meaning                                             |
| -------------- | --------------------------------------------------- |
| **App**        | The SaaS app that was connected.                    |
| **Provider**   | The underlying OAuth provider.                      |
| **Status**     | `ACTIVE`, `INITIATED`, `FAILED`, or `EXPIRED`.      |
| **MCP server** | The auto-registered server backing this connection. |
| **Agents**     | Which agents have access.                           |
| **Connected**  | When the connection was established.                |

Click **Disconnect** on a row to revoke the OAuth grant and tear down its connection.

## Related

<CardGroup cols={2}>
  <Card title="MCP integration" href="/concepts/mcp-integration">
    How agents discover and call MCP tools.
  </Card>

  <Card title="Connected apps" href="/concepts/connected-apps">
    OAuth-based SaaS integrations via Composio.
  </Card>

  <Card title="Secrets" href="/concepts/secrets">
    Store tokens referenced as `secret://`.
  </Card>

  <Card title="Agents" href="/dashboard/agents">
    Attach MCP servers to an agent.
  </Card>
</CardGroup>