> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Den Laposta-Skill für Ihren KI-Assistenten installieren

> Geben Sie Ihrem KI-Assistenten mit einer gebrauchsfertigen Erweiterung Zugriff auf die gesamte Laposta-API.

Ein Skill ist ein Ordner mit Anweisungen für Ihren KI-Assistenten. Der Laposta-Skill umfasst die vollständige API: alle Endpunkte, Pflichtfelder, Fehlercodes und häufig gemachte Fehler. Sie müssen also nichts erklären, bevor Sie eine Anfrage stellen.

Der Skill ist kostenlos, Open Source und steht unter [github.com/laposta/laposta-skill](https://github.com/laposta/laposta-skill) zur Verfügung. Die Endpunkt-Referenz im Skill wird aus derselben Quelle generiert wie diese Dokumentation. Wenn sich die API ändert, wird ein einziges Skript ausgeführt und der Skill ist wieder auf dem aktuellen Stand.

## Beispiele für Befehle

Sie können alles, was [die API](/api) kann, in normaler Sprache ausführen. Hier sind einige Beispiele für Befehle, die Sie direkt verwenden können:

* „Wie viele aktive Abonnenten gibt es in jeder meiner Listen?“
* „Trage diese zwölf E-Mail-Adressen in die Newsletter-Liste ein, mit dem Vornamen im richtigen Feld.“
* „Wer hat sich letzten Monat abgemeldet?“
* „Erstelle eine Kampagne aus dieser HTML-Datei und schicke mir eine Test-E-Mail.“
* „Vergleiche die Öffnungs- und Klickrate meiner letzten fünf Kampagnen.“

Wenn Sie nach einem Endpunkt fragen, schlägt der Skill die Antwort in seiner eigenen Referenz nach, anstatt sie aus seinem Gedächtnis abzurufen.

## In Claude Code installieren

Das Repository dient auch als Plugin-Katalog. Führen Sie diese beiden Zeilen aus:

```text
/plugin marketplace add laposta/laposta-skill
/plugin install laposta@laposta-skill
```

Wählen Sie anschließend aus, wo der Skill abgelegt werden soll: für Sie persönlich, für ein einzelnes Projekt oder nur lokal. Updates können Sie später mit `/plugin marketplace update laposta-skill` abrufen.

> **Note**
>
> Wenn Sie die Nachricht erhalten, dass `/plugin` nicht verfügbar ist, liegt das nicht am Skill. Diese Slash-Befehle funktionieren nur in Claude Code im Terminal, nicht in der Desktop-App oder im Browser. Verwenden Sie dort diese regulären Befehle:
>
> ```bash
> claude plugin marketplace add laposta/laposta-skill
> claude plugin install laposta@laposta-skill
> ```

Wenn Sie die Dateien lieber selbst ablegen möchten, kopieren Sie den Ordner `laposta` in Ihren persönlichen Skills-Ordner. Claude Code erkennt den Ordner sofort, ohne dass Sie das Programm neu starten müssen.

**`Handmatig installeren`**

```bash title="Handmatig installeren"
git clone https://github.com/laposta/laposta-skill.git
mkdir -p ~/.claude/skills
cp -r laposta-skill/plugins/laposta/skills/laposta ~/.claude/skills/
```

## Auf claude.ai installieren

Auf claude.ai gibt es keinen Katalog, daher können Sie dort eine ZIP-Datei hochladen. Achten Sie darauf, dass der Ordner `laposta` die oberste Ebene in der ZIP-Datei bildet, da er sonst nicht erkannt wird.

**`Het zipbestand maken`**

```bash title="Het zipbestand maken"
cd laposta-skill/plugins/laposta/skills && zip -r laposta.zip laposta
```

Laden Sie diese Datei in Ihren Einstellungen unter „Skills“ hoch.

> **Warning**
>
> Auf claude.ai muss der Netzwerkzugriff aktiviert sein, da der Assistent sonst `api.laposta.nl` nicht erreichen kann. Ob Sie diesen selbst aktivieren können, hängt von Ihren eigenen Einstellungen und den Vorgaben Ihres Administrators ab. Über die API von Claude funktioniert der Skill zwar grundsätzlich, kann aber `api.laposta.nl` nicht erreichen, da diese Umgebung keine Internetverbindung hat.

## In anderen Assistenten installieren

Der Skill verwendet ausschließlich die Felder aus dem „Agent Skills“-Standard. Derselbe Ordner funktioniert daher in jedem Programm, das diesen Standard unterstützt, wie Gemini CLI, GitHub Copilot, Codex und Cursor. Wo sich der Skills-Ordner befindet, ist je nach Programm unterschiedlich. Sie finden diese Information in der Dokumentation des jeweiligen Programms.

## Ihren API-Schlüssel übergeben

Der Skill fragt im Gespräch nicht nach Ihrem Schlüssel, sondern liest ihn aus der Umgebungsvariable `LAPOSTA_API_KEY` aus. Richten Sie diese wie folgt ein:

```bash
export LAPOSTA_API_KEY="ihr-schluessel"
```

Wie Sie einen Schlüssel erhalten, erfahren Sie unter [API-Schlüssel erstellen](/hoe-kom-ik-aan-een-api-sleutel). Erstellen Sie hierfür einen separaten Schlüssel. Warum das wichtig ist, wird unter [KI-Assistenten verbinden](/laposta-gebruiken-met-ai) erläutert.

## Sicher arbeiten mit dem Skill

Die Sicherheitsregeln sind direkt im Skill integriert, sodass Sie sich darum nicht kümmern müssen.

| Situation                             | Was passiert                                                                                        |
| ------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Etwas nachschlagen                    | Geschieht sofort, ohne Rückfrage                                                                    |
| Löschen, leeren, einplanen, versenden | Sie erhalten zunächst eine Bestätigungsfrage, in der auch die Anzahl der Abonnenten genannt wird    |
| Viele Abonnenten gleichzeitig ändern  | Auch hier erfolgt zuerst eine Rückfrage, selbst wenn es sich um eine Reihe normaler Aufrufe handelt |
| Eine Kampagne versenden               | Immer zuerst eine Test-E-Mail                                                                       |
| „Nimm jemanden von der Liste“         | Fragt nach, ob Sie abmelden oder löschen meinen, da dies nicht dasselbe ist                         |
| Ihr Schlüssel                         | Wird niemals angezeigt, gespeichert oder in einen Befehl eingefügt                                  |

## Verwandte Artikel

#### [Einen KI-Assistenten mit Ihrem Konto verbinden](/laposta-gebruiken-met-ai)

Lassen Sie einen KI-Assistenten über die API sicher in Ihren Listen und Kampagnen arbeiten.

#### [Die Laposta API](/api)

Verbinden Sie Laposta mit Ihrer eigenen Software: Abonnenten synchronisieren, Kampagnen…

#### [Einen API-Schlüssel erstellen](/hoe-kom-ik-aan-een-api-sleutel)

Sie können Ihre API-Schlüssel auf der Seite Verbindungen erstellen und verwalten…

#### [Labels für Abonnenten verwenden](/labels)

Geben Sie Ihren Abonnenten eigene Labels, um danach zu filtern, Kampagnen an eine…