> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/entwickler/faq.md).

# FAQ

Häufig gestellte Fragen zu AirOps MCP, dem Codex-Plugin und Claude Connector

## Erste Schritte

### Was ist der AirOps Claude Connector?

Mit dem AirOps Claude Connector kannst du direkt aus Claude-Unterhaltungen auf deine AEO-Daten (AI Engine Optimization) zugreifen. Statt zwischen Claude und dem AirOps-Dashboard zu wechseln, stell Claude Fragen wie „Wie entwickelt sich meine Marke in der AI-Suche?“ und erhalte sofortige Einblicke.

Finde ihn im [Connectors-Verzeichnis von Claude](https://claude.ai/settings/connectors): klicke auf **„Suche und Tools“** in deinem Chat und wähle **„Connectoren hinzufügen“**, oder gehe zu **Einstellungen → Connectors → Connectoren durchsuchen**. Suche nach „AirOps“, klicke auf Verbinden und authentifiziere dich mit deinem AirOps-Konto.

### Was kann ich mit AirOps in Claude machen?

* **AI-Sichtbarkeit überwachen** — Erwähne-Rate, Zitier-Rate, Share of Voice prüfen
* **Wettbewerber analysieren** — Leistung über AI-Plattformen hinweg vergleichen
* **Chancen finden** — Seiten entdecken, die Zitate verlieren oder kurz vor dem Ranking stehen
* **Berichte erstellen** — Gespeicherte Dashboards für Stakeholder erstellen
* **Nach Anbieter tracken** — ChatGPT, Perplexity, Gemini und Claude vergleichen
* **Prompts erkunden** — AI-Fragen finden, in denen du erwähnt wirst oder nicht
* **Markenidentität verwalten** — Markennamen, Schreibton, Persona und Stil aktualisieren
* **Marken-Entitäten konfigurieren** — Produktlinien, Zielgruppen, Regionen, Inhaltstypen, Schreibregeln und Wettbewerber verwalten
* **Knowledge Bases durchsuchen** — Relevante Inhalte in deinen Dokumenten finden

### Was ist der Unterschied zwischen dem Claude Connector und MCP?

**Claude-Connector** ist die native Integration im Connectors-Verzeichnis von Claude:

* Einrichtung mit einem Klick
* Interaktive Apps (Diagramme werden in der Unterhaltung gerendert)
* Automatisches OAuth

**MCP** ist das zugrunde liegende Protokoll. Verwende es für Cursor, VS Code, Windsurf oder Claude Code:

* Manuelle Konfiguration
* Die gleichen Tools, andere Einrichtung

| Funktion         | Claude-Connector     | MCP                       |
| ---------------- | -------------------- | ------------------------- |
| Einrichtung      | Mit einem Klick      | Manuell                   |
| Interaktive Apps | Ja                   | Hängt vom Client ab       |
| Am besten für    | Claude Web & Desktop | Cursor, VS Code, Windsurf |

### Welche Claude-Apps unterstützen AirOps?

| App            | Verbindungsmethode | Interaktive Apps |
| -------------- | ------------------ | ---------------- |
| Codex          | AirOps MCP-Plugin  | Ja               |
| Claude Web     | Claude-Connector   | Ja               |
| Claude Desktop | Claude-Connector   | Ja               |
| Claude Code    | MCP                | Nein             |

### Welche Pläne brauche ich?

**AirOps:** Ein kostenpflichtiger Arbeitsbereich, einschließlich einer berechtigten Testphase im kostenpflichtigen Tarif. Insights-Abfragen erfordern außerdem, dass AEO aktiviert und ein konfiguriertes Brand Kit vorhanden ist. Kostenlose Arbeitsbereiche können sich verbinden und `list_workspaces` nutzen, aber Ressourcentools geben eine Planbeschränkung zurück.

**Claude:** Pro, Team oder Enterprise. Der kostenlose Plan unterstützt keine Connectors.

***

## Interaktive Apps

### Was sind Interactive Apps?

Einige Plugins und Connectoren rendern live interaktive Oberflächen in deiner Unterhaltung oder Aufgabe, statt nur Text zurückzugeben. Du kannst das Diagramm oder die Oberfläche direkt dort ansehen, wo du gerade arbeitest.

In Codex installierst und wählst du das AirOps-Plugin aus, um seine Interactive Apps zu nutzen. In Claude zeigen Connectoren mit dieser Fähigkeit im Verzeichnis ein **„Interaktiv“-Badge** an.

### Unterstützt AirOps Interactive Apps?

Ja. Wenn du nach Trends oder Kennzahlen fragst, kann AirOps Folgendes anzeigen:

* **Liniendiagramme** für Trends über die Zeit
* **Balkendiagramme** für Vergleiche
* **KPI-Karten** für aktuelle Kennzahlen
* **Datentabellen** für detaillierte Daten

### Warum sehe ich keine Visualisierungen?

1. **Prüfe deine Verbindung:** In Codex wähle AirOps unter **Quellen → Plugins verwenden**. In Claude überprüfe, ob AirOps unter **Einstellungen → Connectors**.
2. **Prüfe den Zugriff:** Bestätige, dass dein Konto auf das angeforderte AirOps Brand Kit und die Daten zugreifen kann.
3. **Sei präzise:** Versuche „Zeige mir ein Diagramm meines Erwähnungsraten-Trends.“
4. **Neu verbinden:** Verbinde AirOps erneut und starte dann eine neue Unterhaltung oder Aufgabe.

***

## Verbindung

### Wie verbinde ich Claude (Web/Desktop)?

1. Gehen Sie zu **Einstellungen → Connectors**
2. Suche nach **„AirOps“**
3. Klicken Sie auf **Verbinden**
4. Melde dich mit deinem AirOps-Konto an

### Wie verbinde ich Claude Code?

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

Dann authentifizieren:

1. Ausführen `/mcp` in Claude Code
2. Wähle den AirOps-Server aus
3. Wähle **Authentifizieren**
4. Schließe OAuth in deinem Browser ab

### Benötige ich einen API-Schlüssel?

Nein. Der Connector verwendet OAuth — du meldest dich mit deinem AirOps-Konto an und Claude übernimmt den Rest. Keine API-Schlüssel oder Tokens, die verwaltet werden müssen.

### Woran erkenne ich, ob ich verbunden bin?

In Claude Web/Desktop:

* Gehen Sie zu **Einstellungen → Connectors**
* AirOps sollte als „Verbunden“ angezeigt werden

Du kannst es auch testen, indem du Claude fragst:

```
„Auf welche Brand Kits habe ich in AirOps Zugriff?“
```

Wenn Claude deine Brand-Kit-Liste zurückgibt, bist du verbunden.

### Wie trenne ich die Verbindung oder stelle sie wieder her?

**Zum Trennen:**

1. Gehen Sie zu **Einstellungen → Connectors**
2. Finde AirOps
3. Klicken Sie auf **Trennen**

**Zum erneuten Verbinden:** Befolge die Verbindungsschritte erneut. Wenn es Probleme gibt, trenne zuerst die Verbindung, um zwischengespeicherte Authentifizierung zu löschen.

### Wie wird die Authentifizierung gehandhabt?

1. Du klickst auf **Verbinden** in Claude
2. Claude leitet dich zu AirOps weiter
3. Du meldest dich mit deinen AirOps-Zugangsdaten an
4. AirOps stellt Claude ein OAuth-Token aus
5. Claude verwendet dieses Token für Anfragen
6. Tokens aktualisieren sich automatisch — keine erneute Authentifizierung nötig

In Claude werden keine Passwörter oder API-Schlüssel gespeichert. Du kannst den Zugriff jederzeit durch Trennen widerrufen.

***

## Anwendungsfälle

### Wie prüfe ich meine AI-Sichtbarkeit?

```
"Wie performt meine Marke in der KI-Suche?"
„Wie hoch ist meine Erwähnungsrate in den letzten 30 Tagen?“
„Zeige mir die AI-Sichtbarkeitstrends der letzten 2 Monate“
```

### Wie vergleiche ich mich mit Wettbewerbern?

```
„Wie schneide ich im Vergleich zu Wettbewerbern ab?“
"Wie hoch ist mein Share of Voice im Vergleich zu Clari?"
„Welche Wettbewerber erhalten mehr Zitate?“
```

### Wie tracke ich nach AI-Anbieter?

```
"Wie performe ich bei ChatGPT im Vergleich zu Perplexity und Gemini?"
"Welcher KI-Anbieter erwähnt meine Marke am häufigsten?"
```

### Wie finde ich Optimierungsmöglichkeiten?

```
„Welche Seiten verlieren AI-Zitate?“
„Finde Seiten, die in AI-Antworten kurz vor dem Ranking stehen“
„Zeige mir Prompts mit hohem Volumen, in denen ich nicht erwähnt werde“
```

### Wie erstelle ich Berichte?

```
„Erstelle einen Bericht, der die AI-Sichtbarkeitsleistung zusammenfasst“
"Speichere einen Bericht, den ich mit meinem Team teilen kann"
```

Berichte werden in AirOps gespeichert und Claude gibt einen teilbaren Link zurück.

### Wie erstelle ich Aktionsraster?

```
„Erstelle ein Aktionsraster für Seiten, die an Sichtbarkeit verlieren“
"Richte ein Grid ein, um diese Seiten zu optimieren"
```

Claude erstellt in AirOps ein Raster mit deinen Seiten, bereit für Power Agents.

Siehe [Anwendungsfälle](/docs/de/entwickler/use-cases.md) für weitere Beispiele und Best Practices.

***

## Bewährte Vorgehensweisen

### Welche Fragen stelle ich am besten?

**Sei beim Umfang spezifisch:**

* Gut: „Zeige mir Seiten, die in den letzten 30 Tagen Zitate verloren haben“
* Weniger gut: „Zeig mir alle meine Daten“

**Schrittweise aufbauen:**

1. "Wie schneide ich insgesamt ab?"
2. "In welchen Themen bin ich am stärksten?"
3. "Zeig mir die Top-Seiten in diesem Thema"

**Zeiträume angeben:**

* "Vergleiche diesen Monat mit dem letzten Monat"
* "Zeig mir den Trend der letzten 8 Wochen"

**Ergebnisorientierte Fragen verwenden:**

* "Was sollte ich zuerst optimieren?"
* "Woran verliere ich gegen Wettbewerber?"
* "Was sind meine größten Chancen?"

### Wie wähle ich ein Brand Kit aus?

Wenn du mehrere Brand Kits hast, gib den Namen an:

```
"Wie performt Gong in der KI-Suche?"
"Verwende das Brand Kit von Acme Corp"
```

Oder frage: „Auf welche Brand Kits habe ich Zugriff?“

Claude merkt sich deine Auswahl für die Unterhaltung.

### Kann ich Aktionen ausführen oder nur Daten lesen?

Beides. Du kannst:

* **Berichte erstellen** — In AirOps gespeichert mit teilbaren Links
* **Aktions-Grids erstellen** — Seiten zur Optimierung organisiert
* **Direkte Links erhalten** — Zu Seiten, Berichten und Rastern in AirOps springen

***

## Tools

### Welche Tools sind verfügbar?

**Arbeitsbereich & Brand Kit:**

| Tool                    | Beschreibung                                                      |
| ----------------------- | ----------------------------------------------------------------- |
| `list_workspaces`       | Arbeitsbereiche auflisten, auf die du Zugriff hast                |
| `list_brand_kits`       | Brand Kits mit AEO- und Brand-Management-Flags auflisten          |
| `get_brand_kit`         | Markenidentität, Schreibstil und zugehörige Entitäten abrufen     |
| `get_insights_settings` | AEO-Konfiguration abrufen (Wettbewerber, Personas, Prompt-Anzahl) |
| `update_brand_kit`      | Markennamen, URL, Schreibton, Persona aktualisieren               |
| `publish_brand_kit`     | Entwurfsänderungen veröffentlichen, um sie aktiv zu machen        |
| `get_legacy_brand_kit`  | Legacy-Brand-Kit für Migrations-Workflows abrufen                 |

**Brand Kit-Verwaltung:**

| Tool                               | Beschreibung                                              |
| ---------------------------------- | --------------------------------------------------------- |
| `manage_brand_kit_product_line`    | Produktlinien erstellen oder aktualisieren                |
| `manage_brand_kit_competitor`      | Wettbewerber erstellen oder aktualisieren                 |
| `manage_brand_kit_audience`        | Zielgruppen erstellen oder aktualisieren                  |
| `manage_brand_kit_region`          | Regionen erstellen oder aktualisieren                     |
| `manage_brand_kit_content_type`    | Inhaltstypen erstellen oder aktualisieren                 |
| `manage_brand_kit_content_sample`  | Inhaltsbeispiele erstellen oder aktualisieren             |
| `manage_brand_kit_writing_rule`    | Schreibregeln erstellen oder aktualisieren                |
| `manage_brand_kit_custom_variable` | Benutzerdefinierte Variablen erstellen oder aktualisieren |

Brand-Kit-Bearbeitungen verwenden `update_brand_kit` und `manage_brand_kit_*` nach Benutzerbestätigung. Sie bleiben im Entwurf, bis der Benutzer ausdrücklich bestätigt `publish_brand_kit`. Siehe [Einen Brand-Kit-Entwurf bearbeiten](/docs/de/entwickler/tools.md#edit-a-brand-kit-draft).

**AEO-Analytics:**

| Tool                       | Beschreibung                                                           |
| -------------------------- | ---------------------------------------------------------------------- |
| `list_aeo_prompts`         | Verfolgte AI-Prompts für ein Brand Kit                                 |
| `get_prompt_answers`       | AI-Antworten für einen bestimmten Prompt                               |
| `get_answer`               | Vollständige AI-Antwort mit Zitaten und Erwähnungen                    |
| `list_aeo_citations`       | URLs, die in AI-Antworten zitiert werden                               |
| `get_aeo_citation`         | Details für eine bestimmte zitierte URL                                |
| `list_aeo_domains`         | Domains, die in AI-Antworten zitiert werden                            |
| `list_pages`               | Seiten mit AEO-, GSC-, GA4- und Agent-Analytics-Zählungen              |
| `list_aeo_agent_analytics` | Tägliche Crawl- und AI-Agent-Besuchsanzahlen nach Engine und Crawl-Typ |
| `get_page_details`         | Detaillierte Kennzahlen für eine bestimmte Seite                       |
| `get_page_prompts`         | AI-Prompts, die eine bestimmte Seite zitieren                          |
| `list_topics`              | Für ein Brand Kit konfigurierte Themen                                 |
| `list_personas`            | Für ein Brand Kit konfigurierte Personas                               |
| `query_analytics`          | Benutzerdefinierte Kennzahlenabfragen mit flexiblen Dimensionen        |
| `analytics_chart`          | Interaktive Diagrammvisualisierung (nur Claude Web & Desktop)          |
| `create_report`            | Gespeicherte Analyseberichte erstellen                                 |
| `list_reports`             | Gespeicherte Berichte auflisten                                        |
| `get_report`               | Einen bestimmten Bericht abrufen                                       |

**Knowledge Bases:**

| Tool                    | Beschreibung                                                      |
| ----------------------- | ----------------------------------------------------------------- |
| `list_knowledge_bases`  | Verfügbare Knowledge Bases auflisten                              |
| `search_knowledge_base` | Eine Knowledge Base mithilfe semantischer Ähnlichkeit durchsuchen |

Siehe [Tool-Referenz](/docs/de/entwickler/tools.md) für die vollständige Dokumentation.

***

## Andere KI-Assistenten

### Kann ich AirOps mit Cursor, VS Code oder Windsurf verwenden?

Ja. AirOps funktioniert mit jedem MCP-kompatiblen 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"]
      }
    }
  }
}
```

Siehe [Erste Schritte](/docs/de/entwickler/getting-started.md) für detaillierte Einrichtungsanweisungen.

***

## Fehlerbehebung

### Claude sagt „Authentifizierung erforderlich“

**Claude Web/Desktop:**

1. Gehen Sie zu **Einstellungen → Connectors**
2. Finde AirOps und klicke auf **Erneut verbinden**
3. OAuth-Anmeldung abschließen

**Claude Code:**

1. Ausführen `/mcp`
2. AirOps-Server auswählen
3. Wähle **Authentifizieren**
4. OAuth im Browser abschließen

### Tools werden nicht angezeigt

1. **Claude neu starten** — App schließen und erneut öffnen
2. **Verbindung prüfen** — Einstellungen → Connectors sollten „Verbunden“ anzeigen
3. **Erneut verbinden** — Integration trennen und erneut verbinden

### Verbindung verweigert oder Zeitüberschreitung

* Stelle sicher, dass du erreichen kannst `https://app.airops.com` in deinem Browser
* Unternehmensnetzwerke können MCP-Verbindungen blockieren — wende dich an die IT
* Versuche, das VPN vorübergehend zu trennen

### OAuth funktioniert nicht (WSL/Unternehmen)

**WSL-Nutzer:** Browser-OAuth kann unter WSL fehlschlagen. Starte Claude stattdessen unter Windows.

**Firmennetzwerke:** Dein Netzwerk blockiert möglicherweise OAuth-Weiterleitungen. Probiere ein privates Netzwerk oder bitte die IT, `app.airops.com`.

### Wie lösche ich zwischengespeicherte Authentifizierung?

1. Trennen: **Einstellungen → Connectors → Trennen**
2. Erneut verbinden und OAuth erneut abschließen

Für Claude Code:

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

***

## Sicherheit

### Sind meine Daten sicher?

Ja. Der Connector verwendet:

* **OAuth 2.0 mit PKCE** — Authentifizierung nach Industriestandard
* **HTTPS** — Alle Daten während der Übertragung verschlüsselt
* **Berechtigungen auf Benutzerebene** — Zugriff nur auf deine Brand Kits
* **Keine Speicherung von Zugangsdaten** — OAuth-Tokens sicher verwaltet

### Worauf kann der Connector zugreifen?

**Lesezugriff:**

* Brand Kits, für die du Berechtigung hast
* Seiten und Kennzahlen
* Analysedaten
* Prompts und Zitate
* Wissensdatenbanken

**Erstellen & Aktualisieren:**

* Berichte (in deinem Konto gespeichert)
* Aktionsraster
* Brand-Kit-Einstellungen (Name, URL, Schreibton, Persona)
* Brand-Kit-Entitäten (Produktlinien, Wettbewerber, Zielgruppen, Regionen, Inhaltstypen, Inhaltsbeispiele, Schreibregeln)
* Brand-Kit-Entwürfe veröffentlichen, um Änderungen aktiv zu machen

**Kann nicht:**

* Daten löschen
* Auf Arbeitsbereiche anderer Benutzer zugreifen

***

## Ressourcen

**AirOps-Dokumentation**

* [Claude-Connector](/docs/de/entwickler/claude-connector.md)
* [Erste Schritte](/docs/de/entwickler/getting-started.md)
* [Anwendungsfälle](/docs/de/entwickler/use-cases.md)
* [Tool-Referenz](/docs/de/entwickler/tools.md)

**Claude-Dokumentation**

* [Integrationen einrichten](https://support.anthropic.com/en/articles/10168395-setting-up-claude-integrations)
* [Connectors-Verzeichnis von Claude](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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/de/entwickler/faq.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.