# FAQ

## 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](https://claude.ai/settings/connectors): 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?

```bash
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](https://docs.airops.com/mcp/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](https://docs.airops.com/mcp/tools) 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:**

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

**VS Code / Windsurf:**

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

See [Getting Started](https://docs.airops.com/mcp/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:

```bash
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](https://docs.airops.com/mcp/claude-connector)
* [Getting Started](https://docs.airops.com/mcp/getting-started)
* [Use Cases](https://docs.airops.com/mcp/use-cases)
* [Tools Reference](https://docs.airops.com/mcp/tools)

**Claude Documentation**

* [Setting up Integrations](https://support.anthropic.com/en/articles/10168395-setting-up-claude-integrations)
* [Connectors Directory](https://support.anthropic.com/en/articles/11724452-using-the-connectors-directory-to-extend-claude-s-capabilities)
* [Remote MCP](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)