> 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/getting-started.md).

# Erste Schritte

Einrichtungsanweisungen für KI-Assistenten mit MCP

Verbinde deinen KI-Assistenten über den MCP-Server mit AirOps. Dieser Leitfaden behandelt die Einrichtung für Codex, Claude Code, Cursor, VS Code, Windsurf und andere MCP-Clients.

{% hint style="info" %}
**Claude im Web oder auf dem Desktop?** Verwende die [Claude-Connector](/docs/de/entwickler/claude-connector.md) für die Einrichtung mit einem Klick und interaktive Apps.
{% endhint %}

**Server-URL:** `https://app.airops.com/mcp`

Ressourcentools erfordern einen kostenpflichtigen AirOps-Arbeitsbereich, einschließlich berechtigter Testversionen der kostenpflichtigen Tarife. Kostenlose Arbeitsbereiche können Arbeitsbereiche verbinden und auflisten, aber keine Arbeitsbereichsdaten über MCP abfragen oder ändern. Siehe [Planzugriff](/docs/de/entwickler/tools.md#plan-access).

Die Authentifizierung verwendet OAuth 2.0 – melde dich über deinen Browser mit deinem AirOps-Konto an.

## Codex

Verwende die [AirOps MCP-Plugin](/docs/de/entwickler/codex-plugin.md) für die Einrichtung mit einem Klick in Codex.

## Claude Code

Führe in deinem Terminal aus:

```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 die Anmeldung in deinem Browser ab

## Cursor

1. Öffnen **Cursor-Einstellungen → Tools & MCP → Neuer MCP-Server**
2. Füge die Konfiguration hinzu:

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

3. Klicken Sie auf **Verbinden** zur Authentifizierung

## VS Code (Copilot)

1. Öffnen **Einstellungen** (Strg/Cmd + ,)
2. Suche nach "mcp" und klicke auf **In settings.json bearbeiten**
3. Hinzufügen:

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

## Windsurf

1. Öffnen **Windsurf-Einstellungen → Cascade → MCP-Server**
2. Klicken Sie auf **Server hinzufügen → Benutzerdefinierten Server hinzufügen**
3. Hinzufügen:

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

## Andere Clients

Die meisten MCP-Clients unterstützen den HTTP-Transport:

* **Transport:** HTTP (streambares HTTP)
* **URL:** `https://app.airops.com/mcp`

Für Clients, die SSE-Transport benötigen, verwende `mcp-remote` als Proxy:

```bash
npx -y mcp-remote https://app.airops.com/mcp
```

## Fehlerbehebung

### Authentifizierung

<details>

<summary>"Needs authentication"-Fehler</summary>

**Claude Code:** Ausführen `/mcp`, wähle AirOps aus, wähle **Authentifizieren**.

**Cursor:** Klicken Sie auf **Verbinden** Schaltfläche in den MCP-Einstellungen.

**Andere Clients:** Entferne den Server und füge ihn erneut hinzu, um zwischengespeicherte Token zu löschen.

</details>

<details>

<summary>OAuth funktioniert nicht (WSL/Firmennetzwerk)</summary>

**WSL-Nutzer:** Browser-OAuth kann von WSL aus fehlschlagen. Starte deinen Client stattdessen unter Windows.

**Firmennetzwerke:** Dein Netzwerk blockiert möglicherweise OAuth-Weiterleitungen. Versuche es mit einem privaten Netzwerk oder wende dich an die IT, um es auf die Whitelist zu setzen `app.airops.com`.

</details>

### Verbindung

<details>

<summary>Verbindung verweigert oder Zeitüberschreitung</summary>

Prüfe, ob du Folgendes erreichen kannst `https://app.airops.com` in deinem Browser. Einige Firmennetzwerke blockieren MCP-Verbindungen.

</details>

<details>

<summary>Tools werden nicht angezeigt</summary>

1. Starte deinen KI-Assistenten neu
2. **Claude Code:** Ausführen `/mcp` um die Verbindung zu überprüfen
3. Entferne den Server und füge ihn erneut hinzu

</details>

### Zwischengespeicherte Authentifizierung löschen

Entferne den Server und füge ihn erneut hinzu:

**Claude Code:**

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

**Andere Clients:** Lösche den Server aus deiner Konfiguration und füge ihn erneut hinzu.

## Nächste Schritte

* [Anwendungsfälle](/docs/de/entwickler/use-cases.md) — Beispiele für Berichte und Optimierung
* [Tool-Referenz](/docs/de/entwickler/tools.md) — Alle verfügbaren Tools
* [FAQ](/docs/de/entwickler/faq.md) — Häufige Fragen


---

# 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/getting-started.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.