FAQ

Frequently asked questions about AirOps MCP and Claude Connector

Getting Started

What is the AirOps Claude Connector?

The AirOps Claude Connector lets you access your AEO (AI Engine Optimization) data directly from Claude conversations. Instead of switching between Claude and the AirOps dashboard, ask Claude questions like "How is my brand performing in AI search?" and get instant insights.

Find it in Claude's Connectors Directory: click "Search and tools" in your chat and select "Add connectors", or go to Settings → Connectors → Browse connectors. Search for "AirOps," click Connect, and authenticate with your AirOps account.

What can I do with AirOps in Claude?

• Monitor AI visibility — Check mention rate, citation rate, 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

• Explore prompts — Find AI questions where you are or aren't mentioned

• Manage brand identity — Update brand name, writing tone, persona, and style

• Configure brand entities — Manage product lines, audiences, regions, content types, writing rules, and competitors

• Search Knowledge Bases — Find relevant content across your documents

What's the difference between Claude Connector and MCP?

Claude Connector is the native integration in Claude's Connectors Directory:

• One-click setup

• Interactive Apps (charts rendered in conversation)

• Automatic OAuth

MCP is the underlying protocol. Use it for Cursor, VS Code, Windsurf, or Claude Code:

• Manual configuration

• Same tools, different setup

Feature	Claude Connector	MCP
Setup	One-click	Manual
Interactive Apps	Yes	Depends on client
Best for	Claude Web & Desktop	Cursor, VS Code, Windsurf

Which Claude apps support AirOps?

App	Connection Method	Interactive Apps
Claude Web	Claude Connector	Yes
Claude Desktop	Claude Connector	Yes
Claude Code	MCP	No

What plans do I need?

AirOps: Any plan with AEO enabled and at least one Brand Kit configured.

Claude: Pro, Team, or Enterprise. The free plan doesn't support connectors.

---

Interactive Apps

What are Interactive Apps?

Some connectors render live, interactive interfaces in your conversation—not just text. Instead of Claude describing a chart, you see the actual chart.

Connectors with this capability show an "Interactive" badge in Claude's directory.

Does AirOps support Interactive Apps?

Yes. When you ask about trends or metrics, AirOps can display:

• Line charts for trends over time

• Bar charts for comparisons

• KPI cards for current metrics

• Data tables for detailed data

Why don't I see visualizations?

1. Check your app — Interactive Apps work on web and desktop only

2. Check your plan — Requires Claude Pro or higher

3. Check connection — Verify AirOps is connected in Settings → Connectors

4. Be explicit — Try "Show me a chart of my mention rate trend"

---

Connection

How do I connect Claude (web/desktop)?

1. Go to Settings → Connectors

2. Search for "AirOps"

3. Click Connect

4. Sign in with your AirOps account

How do I connect Claude Code?

claude mcp add --transport http airops https://app.airops.com/mcp

Then authenticate:

1. Run /mcp in Claude Code

2. Select the AirOps server

3. Choose Authenticate

4. Complete OAuth in your browser

Do I need an API key?

No. The connector uses OAuth—you sign in with your AirOps account and Claude handles the rest. No API keys or tokens to manage.

How do I know if I'm connected?

In Claude web/desktop:

• Go to Settings → Connectors

• AirOps should show as "Connected"

You can also test by asking Claude:

"What brand kits do I have access to in AirOps?"

If Claude returns your Brand Kit list, you're connected.

How do I disconnect or reconnect?

To disconnect:

1. Go to Settings → Connectors

2. Find AirOps

3. Click Disconnect

To reconnect: Follow the connection steps again. If you're having issues, disconnect first to clear cached authentication.

How is authentication handled?

1. You click Connect in Claude

2. Claude redirects you to AirOps

3. You sign in with your AirOps credentials

4. AirOps issues an OAuth token to Claude

5. Claude uses this token for requests

6. Tokens auto-refresh—no need to re-authenticate

No passwords or API keys are stored in Claude. You can revoke access anytime by disconnecting.

---

Use Cases

How do I check my AI visibility?

"How is my brand performing in AI search?"
"What's my mention rate over the last 30 days?"
"Show me AI visibility trends for the past 2 months"

How do I compare against competitors?

"How do I compare to competitors?"
"What's my share of voice vs Clari?"
"Which competitors are getting more citations?"

How do I track by AI provider?

"How do I perform on ChatGPT vs Perplexity vs Gemini?"
"Which AI provider mentions my brand the most?"

How do I find optimization opportunities?

"Which pages are losing AI citations?"
"Find pages close to ranking in AI answers"
"Show me high-volume prompts where I'm not mentioned"

How do I create reports?

"Create a report summarizing AI visibility performance"
"Save a report I can share with my team"

Reports are saved to AirOps and Claude returns a shareable link.

How do I create action grids?

"Create an action grid for pages losing visibility"
"Set up a grid to optimize these pages"

Claude creates a grid in AirOps with your pages, ready for power agents.

See Use Cases for more examples and best practices.

---

Best Practices

What are the best questions to ask?

Be specific about scope:

• Good: "Show me pages losing citations in the last 30 days"

• Less good: "Show me all my data"

Build progressively:

1. "How am I performing overall?"

2. "Which topics am I strongest in?"

3. "Show me the top pages in that topic"

Specify time ranges:

• "Compare this month to last month"

• "Show me the trend over the past 8 weeks"

Use outcome-oriented questions:

• "What should I optimize first?"

• "Where am I losing to competitors?"

• "What are my biggest opportunities?"

How do I select a Brand Kit?

If you have multiple Brand Kits, specify by name:

"How is Gong performing in AI search?"
"Use the Acme Corp brand kit"

Or ask: "What brand kits do I have access to?"

Claude remembers your selection for the conversation.

Can I take actions or just read data?

Both. You can:

• Create reports — Saved to AirOps with shareable links

• Create action grids — Pages organized for optimization

• Get direct links — Jump to pages, reports, and grids in AirOps

---

Tools

What tools are available?

Workspace & Brand Kit:

Tool	Description
list_workspaces	List workspaces you have access to
list_brand_kits	List Brand Kits with AEO and brand management flags
get_brand_kit	Get brand identity, writing style, and related entities
get_insights_settings	Get AEO configuration (competitors, personas, prompt count)
update_brand_kit	Update brand name, URL, writing tone, persona
publish_brand_kit	Publish draft changes to make them active
get_legacy_brand_kit	Get legacy Brand Kit for migration workflows

Brand Kit Management:

Tool	Description
manage_brand_kit_product_line	Create or update product lines
manage_brand_kit_competitor	Create or update competitors
manage_brand_kit_audience	Create or update audiences
manage_brand_kit_region	Create or update regions
manage_brand_kit_content_type	Create or update content types
manage_brand_kit_content_sample	Create or update content samples
manage_brand_kit_writing_rule	Create or update writing rules
manage_brand_kit_custom_variable	Create or update custom variables
suggest_brand_kit_edits	Suggest edits with interactive review UI (Claude Web & Desktop only)

AEO Analytics:

Tool	Description
list_aeo_prompts	Tracked AI prompts for a Brand Kit
get_prompt_answers	AI answers for a specific prompt
get_answer	Full AI answer with citations and mentions
list_aeo_citations	URLs being cited in AI answers
get_aeo_citation	Details for a specific cited URL
list_aeo_domains	Domains being cited in AI answers
list_pages	Pages with AEO, GSC, and GA4 metrics
get_page_details	Detailed metrics for a specific page
get_page_prompts	AI prompts citing a specific page
list_topics	Topics configured for a Brand Kit
list_personas	Personas configured for a Brand Kit
query_analytics	Custom metrics queries with flexible dimensions
analytics_chart	Interactive chart visualization (Claude Web & Desktop only)
create_report	Create saved analytics reports
list_reports	List saved reports
get_report	Get a specific report
create_action_grid	Create optimization grids with power agents

Knowledge Bases:

Tool	Description
list_knowledge_bases	List available Knowledge Bases
search_knowledge_base	Search a Knowledge Base using semantic similarity

See Tools Reference for complete documentation.

---

Other AI Assistants

Can I use AirOps with Cursor, VS Code, or Windsurf?

Yes. AirOps works with any MCP-compatible client.

Cursor:

{
  "mcpServers": {
    "airops": {
      "url": "https://app.airops.com/mcp"
    }
  }
}

VS Code / Windsurf:

{
  "mcp": {
    "servers": {
      "airops": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
      }
    }
  }
}

See Getting Started for detailed setup instructions.

---

Troubleshooting

Claude says "needs authentication"

Claude web/desktop:

1. Go to Settings → Connectors

2. Find AirOps and click Reconnect

3. Complete OAuth sign-in

Claude Code:

1. Run /mcp

2. Select AirOps server

3. Choose Authenticate

4. Complete OAuth in browser

Tools aren't showing up

1. Restart Claude — Close and reopen the app

2. Check connection — Settings → Connectors should show "Connected"

3. Reconnect — Disconnect and reconnect the integration

Connection refused or timeout

• Verify you can reach https://app.airops.com in your browser

• Corporate networks may block MCP connections—contact IT

• Try disconnecting VPN temporarily

OAuth not working (WSL/corporate)

WSL users: Browser OAuth may fail from WSL. Run Claude from Windows instead.

Corporate networks: Your network may block OAuth redirects. Try a personal network or ask IT to whitelist app.airops.com.

How do I clear cached authentication?

1. Disconnect: Settings → Connectors → Disconnect

2. Reconnect and complete OAuth again

For Claude Code:

claude mcp remove airops
claude mcp add --transport http airops https://app.airops.com/mcp

---

Security

Is my data secure?

Yes. The connector uses:

• OAuth 2.0 with PKCE — Industry-standard authentication

• HTTPS — All data encrypted in transit

• User-level permissions — Access only your Brand Kits

• No credential storage — OAuth tokens managed securely

What can the connector access?

Read access:

• Brand Kits you have permission for

• Pages and metrics

• Analytics data

• Prompts and citations

• Knowledge Bases

Create & Update:

• Reports (saved to your account)

• Action grids

• Brand Kit settings (name, URL, writing tone, persona)

• Brand Kit entities (product lines, competitors, audiences, regions, content types, content samples, writing rules)

• Publish Brand Kit drafts to make changes active

Cannot:

• Delete any data

• Access other users' workspaces

---

Resources

AirOps Documentation

• Claude Connector

• Getting Started

• Use Cases

• Tools Reference

Claude Documentation

• Setting up Integrations

• Connectors Directory

• Remote MCP