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—no configuration needed

• Automatic OAuth authentication

• Works with Claude Web and Desktop

MCP (Model Context Protocol) is the underlying technology. Use it for other AI tools:

• Manual configuration required

• Same tools available

• Works with Cursor, VS Code, Windsurf, Claude Code

Feature	Claude Connector	MCP
Setup	One-click	Manual configuration
Authentication	Automatic	Manual OAuth flow
Best for	Claude Web & Desktop	Cursor, VS Code, Windsurf

Recommendation: Use the Claude Connector if you're using Claude. Use MCP for other AI assistants.

Which Claude apps support AirOps?

App	Connection Method
Claude Web (claude.ai)	Claude Connector
Claude Desktop (Mac/Windows)	Claude Connector
Claude Code (CLI)	MCP

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.

---

Connection

How do I connect Claude to AirOps?

From Chat:

1. Click "Search and tools" (lower left)

2. Select "Add connectors"

3. Search for "AirOps"

4. Click Connect

5. Sign in with your AirOps account

From Settings:

1. Go to Settings → Connectors

2. Click "Browse connectors"

3. Search for "AirOps"

4. Click Connect

5. Sign in with your AirOps account

Mobile users can use connected tools but cannot browse the directory—connect from web or desktop first.

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 your Brand Kits
get_brand_kit	Get brand guidelines
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