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, Claude

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

• Access brand guidelines — Pull your brand voice and writing style

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?

Tool	Description
list_brand_kits	List Brand Kits for brand management and content creation
get_brand_kit	Get brand identity, writing style, and related entities
list_aeo_brand_kits	List Brand Kits for AEO operations
get_aeo_brand_kit	Get a Brand Kit for AEO analytics and AI visibility
list_pages	Pages with metrics (supports smart filters)
get_page_details	Detailed page metrics
get_page_prompts	AI prompts citing a page
get_prompt_answers	Answers for a prompt
get_answer	Full AI answer with citations
list_aeo_prompts	Prompts in your topics
list_aeo_citations	URLs being cited
list_aeo_domains	Domains being cited
query_analytics	Custom metrics queries
create_report	Create saved reports
create_action_grid	Create optimization grids

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

Create:

• Reports (saved to your account)

• Action grids

Cannot:

• Modify Brand Kit settings

• 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