# MCP Connectors

MCP Connectors let you connect external [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) servers to your AirOps workspace. Once connected, you can select these connectors as tools in LLM steps, allowing the model to call external tools during execution.

{% hint style="info" %}
**Looking for AirOps as an MCP server?** MCP Connectors let you bring *external* MCP servers into AirOps. If you want to connect AirOps data to tools like Claude Desktop or Cursor, see the [AirOps MCP Server](/mcp/mcp-server.md) docs instead.
{% endhint %}

## Adding an MCP Connector

To add a new connector, navigate to **Settings > MCP Connectors** and click **Add Connector**.

<figure><img src="/files/ZS2olyNa0UAL0f9GG4ct" alt=""><figcaption><p>Add MCP Connector form</p></figcaption></figure>

Fill in the following fields:

| Field         | Description                                                              |
| ------------- | ------------------------------------------------------------------------ |
| **Name**      | A display name for the connector (e.g. "GitHub MCP", "Linear MCP").      |
| **URL**       | The MCP server endpoint URL.                                             |
| **Auth Type** | How AirOps authenticates with the server: **Access Token** or **OAuth**. |

### Access Token Authentication

1. Select **Access Token** as the auth type.
2. Enter the token provided by your MCP server.
3. Click **Save**. AirOps will test the connection before saving.

### OAuth Authentication

1. Select **OAuth** as the auth type.
2. Click **Authorize**. You will be redirected to the MCP server's OAuth flow.
3. Complete the authorization and you will be returned to AirOps.
4. The connector is saved automatically after successful authorization.

## Managing Connectors

The MCP Connectors settings page lists all connectors in your workspace along with their connection status.

<figure><img src="/files/JMmUqejfvfzFxWJc5RnU" alt=""><figcaption><p>MCP Connectors list</p></figcaption></figure>

From this page you can:

* **Edit** a connector's name, URL, or credentials.
* **Re-authenticate** an OAuth connector if the token has expired.
* **Delete** a connector that is no longer needed.
* **View connection status** to confirm the server is reachable.

{% hint style="info" %}
After adding or updating a connector, use it in an LLM step to verify it works end-to-end. See [Using MCP Connectors in LLM Steps](/actions/workflow-concepts/workflow-steps/ai-steps/llm.md#mcp-connectors) for details.
{% endhint %}

## Security

* All connector credentials are encrypted at rest using **AES 256-bit encryption**.
* Credentials are scoped to the workspace that created them and are not accessible by other workspaces.
* OAuth tokens are stored securely and refreshed automatically when supported by the MCP server.

## Troubleshooting

| Issue                               | Resolution                                                                                                                                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Connection test fails on save       | Verify the URL is correct and the MCP server is running. Check that any required auth credentials are valid.                                                                                           |
| OAuth redirect fails                | Ensure your browser allows popups from AirOps. Try authorizing in an incognito window to rule out extension conflicts.                                                                                 |
| Connector shows "Disconnected"      | The MCP server may be down or the credentials may have expired. Try re-authenticating or updating the access token.                                                                                    |
| Connector not appearing in LLM step | Make sure you have selected a [compatible model](/actions/workflow-concepts/workflow-steps/ai-steps/llm.md#mcp-connectors). The MCP Connectors dropdown only appears when a supported model is chosen. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.airops.com/your-workspace/mcp-connectors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.