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.
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.

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.

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