> 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.

# De Laposta-skill installeren voor je AI-assistent

> Geef je AI-assistent toegang tot de hele Laposta-API met een kant-en-klare uitbreiding.

Een skill is een map met instructies voor je AI-assistent. De Laposta-skill bevat de volledige API: alle endpoints, verplichte velden, foutcodes en veelgemaakte fouten. Je hoeft dus niets uit te leggen voordat je iets vraagt.

De skill is gratis, open source en staat op [github.com/laposta/laposta-skill](https://github.com/laposta/laposta-skill). De endpoint-referentie in de skill wordt gegenereerd uit dezelfde bron als deze documentatie. Verandert de API, dan draait er één script en klopt de skill weer.

## Voorbeelden van opdrachten

Je kunt alles doen wat [de API](/api) kan, in gewone taal. Een paar voorbeelden van opdrachten die je direct kunt gebruiken:

* "Hoeveel actieve relaties staan er in elk van mijn lijsten?"
* "Zet deze twaalf adressen in de nieuwsbrieflijst, met de voornaam in het juiste veld."
* "Wie heeft zich vorige maand afgemeld?"
* "Maak een campagne van dit html-bestand en stuur mij een testmail."
* "Vergelijk de open- en klikratio van mijn laatste vijf campagnes."

Vraag je naar een endpoint, dan zoekt de skill het antwoord op in zijn eigen referentie in plaats van het uit zijn geheugen te halen.

## Installeren in Claude Code

De repository is ook een plugin-catalogus. Voer deze twee regels uit:

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

Kies daarna waar de skill komt te staan: voor jezelf, voor één project of alleen lokaal. Updates kun je later binnenhalen met `/plugin marketplace update laposta-skill`.

> **Note**
>
> Krijg je de melding dat `/plugin` niet beschikbaar is, dan ligt dat niet aan de skill. Die schuine-streep-commando's werken alleen in Claude Code in de terminal, niet in de desktop-app of de browser. Gebruik daar deze gewone commando's:
>
> ```bash
> claude plugin marketplace add laposta/laposta-skill
> claude plugin install laposta@laposta-skill
> ```

Zet je de bestanden liever zelf neer, kopieer dan de map `laposta` naar je persoonlijke skills-map. Claude Code herkent de map direct, zonder dat je het programma hoeft te herstarten.

**`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/
```

## Installeren op claude.ai

Op claude.ai is er geen catalogus, dus daar kun je een zipbestand uploaden. Zorg dat de map `laposta` de bovenste laag in het zipbestand is, anders wordt hij niet herkend.

**`Het zipbestand maken`**

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

Upload dit bestand in je instellingen bij ‘Skills’.

> **Warning**
>
> Op claude.ai moet netwerktoegang aanstaan, anders kan de assistent `api.laposta.nl` niet bereiken. Of je die zelf kunt aanzetten, hangt af van je eigen instellingen en van wat een beheerder toestaat. Via de API van Claude werkt de skill op zich wel, maar komt hij niet bij `api.laposta.nl` omdat die omgeving geen internetverbinding heeft.

## Installeren in andere assistenten

De skill gebruikt alleen de velden uit de Agent Skills-standaard. Dezelfde map werkt dus in elk programma dat die standaard volgt, zoals Gemini CLI, GitHub Copilot, Codex en Cursor. Waar de skills-map staat, verschilt per programma. Dit kun je terugvinden in de documentatie van het programma zelf.

## Je API-sleutel meegeven

De skill vraagt in het gesprek niet om je sleutel, maar leest die uit de omgevingsvariabele `LAPOSTA_API_KEY`. Stel die zo in:

```bash
export LAPOSTA_API_KEY="jouw-sleutel"
```

Hoe je aan een sleutel komt, lees je in [API-sleutel aanmaken](/hoe-kom-ik-aan-een-api-sleutel). Maak hiervoor een aparte sleutel aan. Waarom dat belangrijk is, staat bij [AI-assistent koppelen](/laposta-gebruiken-met-ai).

## Veilig werken met de skill

De veiligheidsregels zitten in de skill zelf, dus daar hoef je niet aan te denken.

| Situatie                                     | Wat er gebeurt                                                                  |
| -------------------------------------------- | ------------------------------------------------------------------------------- |
| Iets opzoeken                                | Gebeurt meteen, zonder tussenvraag                                              |
| Verwijderen, leegmaken, inplannen, verzenden | Je krijgt eerst een vraag ter bevestiging, waarin ook het aantal relaties staat |
| Veel relaties tegelijk wijzigen              | Ook eerst een vraag, ook al is het een reeks gewone aanroepen                   |
| Een campagne versturen                       | Altijd eerst een testmail                                                       |
| "Haal iemand van de lijst"                   | Vraagt of je afmelden of verwijderen bedoelt, want dat is niet hetzelfde        |
| Je sleutel                                   | Wordt nooit getoond, opgeslagen of in een commando gezet                        |

## Gerelateerde artikelen

#### [Een AI-assistent koppelen aan je account](/laposta-gebruiken-met-ai)

Laat een AI-assistent via de API veilig werken in je lijsten en campagnes.

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

Koppel Laposta aan je eigen software: relaties synchroniseren, campagnes versturen en…

#### [Een API-sleutel aanmaken](/hoe-kom-ik-aan-een-api-sleutel)

Je kunt je API-sleutels aanmaken en beheren op de pagina Koppelingen. Let op: een…

#### [Labels op relaties gebruiken](/labels)

Geef je relaties eigen labels om op te filteren, campagnes naar een selectie te sturen…