> 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/codex-plugin.md).

# Codex-Plugin

Richten Sie das AirOps MCP-Plugin in Codex mit interaktiven Apps ein

Das AirOps-MCP-Plugin verbindet Codex mit Ihrem AirOps-Workspace. Es bietet eine Einrichtung mit einem Klick und Unterstützung für Interactive Apps, einschließlich Diagrammen und Brand-Kit-Review-Oberflächen, die direkt in Ihrer Aufgabe angezeigt werden.

## Schnelle Einrichtung

1. Öffnen Sie das [AirOps MCP-Plugin](https://chatgpt.com/plugins/plugin_asdk_app_6a8774407d4081919100aae8d18bba79).
2. Wählen Sie **Plugin installieren**.
3. Schließen Sie den AirOps-Anmeldevorgang ab, wenn Sie dazu aufgefordert werden.

Nach der Installation und Authentifizierung ist AirOps als Plugin-Quelle in unterstützten Codex-Aufgabenansichten verfügbar.

{% hint style="info" %}
Die Verfügbarkeit von Plugins hängt von Ihrem Codex-Tarif, den Workspace-Einstellungen, der Rolle und der Region ab. In einem verwalteten Workspace muss ein Administrator das Plugin möglicherweise verfügbar machen, bevor Sie es installieren oder verwenden können.
{% endhint %}

## Interaktive Apps

Das Codex-Plugin unterstützt **Interaktive Apps**, Live-Oberflächen, die direkt in Ihrer Aufgabe und nicht als Textbeschreibungen angezeigt werden.

### Was du sehen wirst

| Interaktive App            | Anwendungsfall                                                                       |
| -------------------------- | ------------------------------------------------------------------------------------ |
| Liniendiagramme            | Trends im Zeitverlauf, einschließlich Erwähnungsrate und Zitate                      |
| Balken- und Kreisdiagramme | Vergleiche zwischen Wettbewerbern, Anbietern und Themen                              |
| KPI-Karten                 | Aktuelle Kennzahlen mit Veränderungen im Zeitraum                                    |
| Datentabellen              | Seiten, Prompts, Zitate und andere detaillierte Ergebnisse                           |
| Brand Kit-Review           | Überprüfen und akzeptieren oder lehnen Sie vorgeschlagene Änderungen am Brand Kit ab |

### Beispiel

```
Sie: „Zeig mir, wie sich unsere Erwähnungsrate in den letzten zwei Monaten verändert hat.“
Codex: [Zeigt ein interaktives Trenddiagramm]
       Ihre Erwähnungsrate ist von 9 % auf 18 % gestiegen.
```

### Interactive Apps verwenden

* **Inline anzeigen:** Diagramme und Review-Oberflächen erscheinen direkt in der Aufgabe.
* **Interagieren:** Fahren Sie mit der Maus über Diagrammdaten oder verwenden Sie die vom App bereitgestellten Steuerelemente.
* **Verfeinern:** Bitten Sie Codex, den Datumsbereich, die Metriken, die Gruppierung oder den Diagrammtyp zu ändern.
* **Änderungen prüfen:** Akzeptieren oder lehnen Sie vorgeschlagene Brand Kit-Änderungen ab, bevor Sie sie anwenden.

Interactive Apps werden automatisch angezeigt, wenn Codex ein unterstütztes AirOps-Tool aufruft.

### Fehlerbehebung bei Interactive Apps

Wenn eine Interactive App nicht angezeigt wird:

1. Stellen Sie sicher, dass das AirOps-Plugin unter **Quellen → Plugins verwenden**.
2. Bitten Sie ausdrücklich um ein Diagramm oder eine Brand-Kit-Überprüfung, zum Beispiel: „Zeig mir ein Diagramm meines Erwähnungsraten-Trends.“
3. Stellen Sie sicher, dass Ihr AirOps-Konto auf das angeforderte Brand Kit und die angeforderten Daten zugreifen kann.
4. Starten Sie nach dem erneuten Verbinden des Plugins eine neue Aufgabe.

## AirOps in Codex verwenden

In einer unterstützten Codex-Aufgabenansicht:

1. Öffnen **Quellen**.
2. Wählen Sie **Plugins verwenden**.
3. Suchen Sie nach dem installierten AirOps-Plugin und wählen Sie es aus.
4. Bitten Sie Codex, mit Ihren AirOps-Daten zu arbeiten.

Zum Beispiel:

```
Überprüfen Sie unsere KI-Suchleistung der letzten 30 Tage und identifizieren Sie die größten Chancen.
```

## Das Plugin verwalten

### Erneut verbinden

Wenn AirOps erneut eine Authentifizierung benötigt, öffnen Sie das Plugin über **Quellen → Plugins verwenden** und schließen Sie den Anmeldevorgang ab, wenn Sie dazu aufgefordert werden.

### Workspace-Zugriff

Workspace-Administratoren können die Verfügbarkeit von Plugins über **Workspace-Einstellungen → Plugins**. Sie können die enthaltenen Funktionen des Plugins prüfen und festlegen, ob es für Mitglieder zur Installation verfügbar ist oder für berechtigte Rollen automatisch installiert wird.

Der Plugin-Zugriff umgeht nicht die Berechtigungen des verbundenen AirOps-Kontos.

## Fehlerbehebung

### Plugin nicht gefunden

Prüfen Sie, dass:

1. Sie eine unterstützte Codex-Aufgabenansicht verwenden.
2. Das Plugin für Ihr Konto oder Ihre Rolle installiert ist.
3. Ihr Workspace-Administrator den Zugriff aktiviert hat, wenn Sie einen verwalteten Workspace verwenden.

Änderungen im Codex-Verzeichnis können einige Zeit zum Aktualisieren benötigen. Wenn das Plugin kürzlich veröffentlicht oder aktiviert wurde, versuchen Sie es später erneut.

### Authentifizierung erforderlich

Öffnen **Quellen → Plugins verwenden**, wählen Sie AirOps aus und schließen Sie den Authentifizierungsvorgang ab. Wenn das Problem weiterhin besteht, melden Sie sich in Ihrem Browser von AirOps ab und authentifizieren Sie sich erneut.

### Tools oder Daten sind nicht verfügbar

Bestätigen Sie, dass:

* Das AirOps-Plugin für die Aufgabe ausgewählt ist.
* Ihr AirOps-Konto auf die angeforderten Workspace-Daten zugreifen kann.
* Sie eine vom Plugin unterstützte Funktion anfordern.

## Codex-Plugin vs. direkte MCP-Einrichtung

| Funktion          | AirOps MCP-Plugin                             | Direkte MCP-Einrichtung                                       |
| ----------------- | --------------------------------------------- | ------------------------------------------------------------- |
| Einrichtung       | Aus dem Codex-Plugin-Verzeichnis installieren | Den MCP-Server manuell konfigurieren                          |
| Interaktive Apps  | Ja                                            | Hängt vom MCP-Client ab                                       |
| Authentifizierung | Den Plugin-Einrichtungsablauf abschließen     | In Ihrem MCP-Client authentifizieren                          |
| Am besten für     | Codex-Aufgaben                                | Claude Code, Cursor, VS Code, Windsurf und andere MCP-Clients |

Das Plugin verwendet den AirOps-MCP-Server unter `https://app.airops.com/mcp`.

## Was Sie tun können

* **KI-Suchintelligenz überprüfen:** Erwähnungsrate, Zitatrate und Share of Voice nachverfolgen
* **Wettbewerber analysieren:** Die Leistung über KI-Plattformen hinweg vergleichen
* **Chancen finden:** Seiten entdecken, die Zitate verlieren oder kurz vor dem Ranking stehen
* **Berichte erstellen:** Gespeicherte Dashboards für Stakeholder generieren
* **Nach Anbieter verfolgen:** ChatGPT, Perplexity, Gemini und Claude vergleichen
* **Markenidentität verwalten:** Markenname, Beschreibung, Schreibton und Persona aktualisieren
* **Markenentitäten konfigurieren:** Produktlinien, Zielgruppen, Regionen, Inhaltstypen, Schreibregeln und Wettbewerber verwalten
* **Wissensdatenbanken durchsuchen:** Relevante Inhalte in Ihren Dokumenten mithilfe semantischer Suche finden


---

# 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/codex-plugin.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.
