> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/developers/codex-plugin.md).

# Codex Plugin

Set up the AirOps MCP plugin in Codex with Interactive Apps

The AirOps MCP plugin connects Codex to your AirOps workspace. It provides one-click setup and support for Interactive Apps, including charts and Brand Kit review interfaces rendered directly in your task.

## Quick Setup

1. Open the [AirOps MCP plugin](https://chatgpt.com/plugins/plugin_asdk_app_6a8774407d4081919100aae8d18bba79).
2. Select **Install plugin**.
3. Complete the AirOps sign-in flow when prompted.

After installation and authentication, AirOps is available as a plugin source in supported Codex task views.

{% hint style="info" %}
Plugin availability depends on your Codex plan, workspace settings, role, and region. In a managed workspace, an administrator may need to make the plugin available before you can install or use it.
{% endhint %}

## Interactive Apps

The Codex plugin supports **Interactive Apps**, live interfaces rendered directly in your task instead of text descriptions.

### What You'll See

| Interactive App    | Use Case                                                |
| ------------------ | ------------------------------------------------------- |
| Line charts        | Trends over time, including mention rate and citations  |
| Bar and pie charts | Comparisons across competitors, providers, and topics   |
| KPI cards          | Current metrics with period changes                     |
| Data tables        | Pages, prompts, citations, and other detailed results   |
| Brand Kit review   | Review and accept or reject suggested Brand Kit changes |

### Example

```
You: "Show me how our mention rate changed over the last two months."
Codex: [Displays an interactive trend chart]
       Your mention rate increased from 9% to 18%.
```

### Using Interactive Apps

* **View inline:** Charts and review interfaces appear directly in the task.
* **Interact:** Hover over chart data or use the controls provided by the app.
* **Refine:** Ask Codex to change the date range, metrics, grouping, or chart type.
* **Review changes:** Accept or reject suggested Brand Kit edits before applying them.

Interactive Apps appear automatically when Codex calls a supported AirOps tool.

### Troubleshooting Interactive Apps

If an Interactive App does not appear:

1. Confirm that the AirOps plugin is selected under **Sources → Use plugins**.
2. Ask explicitly for a chart or Brand Kit review, such as "Show me a chart of my mention rate trend."
3. Check that your AirOps account can access the requested Brand Kit and data.
4. Start a new task after reconnecting the plugin.

## Use AirOps in Codex

In a supported Codex task view:

1. Open **Sources**.
2. Select **Use plugins**.
3. Search for and select the installed AirOps plugin.
4. Ask Codex to work with your AirOps data.

For example:

```
Review our AI search performance for the last 30 days and identify the biggest opportunities.
```

## Manage the Plugin

### Reconnect

If AirOps needs authentication again, open the plugin from **Sources → Use plugins** and complete the sign-in flow when prompted.

### Workspace Access

Workspace administrators can manage plugin availability from **Workspace settings → Plugins**. They can review the plugin's included capabilities and choose whether it is available for members to install or installed automatically for eligible roles.

Plugin access does not bypass the permissions of the connected AirOps account.

## Troubleshooting

### Plugin Not Found

Check that:

1. You are using a supported Codex task view.
2. The plugin is installed for your account or role.
3. Your workspace administrator has enabled access if you use a managed workspace.

Directory changes in Codex can take time to refresh. If the plugin was recently published or enabled, try again later.

### Authentication Required

Open **Sources → Use plugins**, select AirOps, and complete the authentication flow. If the issue continues, sign out of AirOps in your browser and authenticate again.

### Tools or Data Are Not Available

Confirm that:

* The AirOps plugin is selected for the task.
* Your AirOps account can access the requested workspace data.
* You are asking for a capability supported by the plugin.

## Codex Plugin vs Direct MCP Setup

| Feature          | AirOps MCP plugin                        | Direct MCP setup                                              |
| ---------------- | ---------------------------------------- | ------------------------------------------------------------- |
| Setup            | Install from the Codex Plugins directory | Configure the MCP server manually                             |
| Interactive Apps | Yes                                      | Depends on the MCP client                                     |
| Authentication   | Complete the plugin setup flow           | Authenticate in your MCP client                               |
| Best for         | Codex tasks                              | Claude Code, Cursor, VS Code, Windsurf, and other MCP clients |

The plugin uses the AirOps MCP server at `https://app.airops.com/mcp`.

## What You Can Do

* **Review AI search intelligence:** Track mention rate, citation rate, and share of voice
* **Analyze competitors:** Compare performance across AI platforms
* **Find opportunities:** Discover pages losing citations or close to ranking
* **Create reports:** Generate saved dashboards for stakeholders
* **Track by provider:** Compare ChatGPT, Perplexity, Gemini, and Claude
* **Manage brand identity:** Update brand name, description, writing tone, and persona
* **Configure brand entities:** Manage product lines, audiences, regions, content types, writing rules, and competitors
* **Search Knowledge Bases:** Find relevant content across your documents using semantic search


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.airops.com/developers/codex-plugin.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.