> ## Documentation Index
> Fetch the complete documentation index at: https://avala.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Avala mit KI nutzen

> Verbinden Sie Avala mit Claude, Cursor, VS Code und ChatGPT über MCP

Das [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) ist ein offener Standard, der KI-Assistenten erlaubt, externe Werkzeuge aufzurufen und auf Datenquellen zuzugreifen. Der MCP Server von Avala stellt Ihre Datensätze, Projekte und Exporte als Werkzeuge bereit, sodass Sie Ihren Annotations-Workflow in natürlicher Sprache in Claude, Cursor, VS Code oder ChatGPT verwalten können.

## Schnelleinrichtung

Installieren Sie den MCP Server mit einem kompatiblen KI-Client. Sie benötigen **Node.js 18+** und einen [Avala API Key](/docs/api-reference/authentication).

Für Claude Desktop fügen Sie Folgendes zu Ihrer Konfigurationsdatei hinzu (`~/Library/Application Support/Claude/claude_desktop_config.json` auf macOS):

<Warning>
  Committen Sie niemals Konfigurationsdateien mit echten API Keys in die Versionsverwaltung. Setzen Sie `AVALA_API_KEY` als System-Umgebungsvariable oder ersetzen Sie `"your-api-key"` lokal durch Ihren tatsächlichen Key.
</Warning>

```json theme={null}
{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}
```

Starten Sie Claude Desktop neu. Die Avala-Werkzeuge erscheinen in der Werkzeugauswahl.

<Info>
  MCP läuft standardmäßig im schreibgeschützten Modus im mitgelieferten Server. Um Schreib-/Lösch-Werkzeuge zu aktivieren, setzen Sie `AVALA_MCP_ENABLE_MUTATIONS=true` vor dem Start des MCP Servers.
</Info>

## Was Sie tun können

Nach der Verbindung können Sie Ihren KI-Assistenten bitten, in natürlicher Sprache mit Avala zu interagieren:

```
Liste alle meine Datensätze auf
```

```
Zeige den Status des Projekts "Pedestrian Detection"
```

```
Wie viele Aufgaben sind in "Lidar QA" abgeschlossen?
```

```
Zeige Exportjobs für Datensatz ds_abc123
```

```
Zeige meine Workspace-Statistiken
```

Der Assistent ruft das entsprechende Avala MCP-Werkzeug auf, verarbeitet die Antwort und präsentiert die Ergebnisse. Sie können mehrere Anfragen in einer einzelnen Konversation verketten — zum Beispiel Datensätze auflisten, einen auswählen und dann einen Export auslösen.

## Vollständiger Setup-Guide

Für VS Code, ChatGPT und eine vollständige Liste der verfügbaren MCP-Werkzeuge, siehe den vollständigen [MCP Server Setup-Guide](/docs/integrations/mcp-setup).

<CardGroup cols={2}>
  <Card title="MCP Server Setup" icon="plug" href="/docs/integrations/mcp-setup">
    Vollständige Einrichtungsanweisungen für alle unterstützten KI-Clients und die vollständige Werkzeugreferenz.
  </Card>

  <Card title="API-Authentifizierung" icon="key" href="/docs/api-reference/authentication">
    API Keys erstellen und verwalten, die vom MCP Server verwendet werden.
  </Card>
</CardGroup>