# Gracias in je AI-assistent

> Gracias is een Nederlands zakelijk cadeauplatform (B2B): bedrijven geven medewerkers en relaties cadeaus en belevingen van lokale, ambachtelijke makers. Deze pagina beschrijft (1) hoe een klant Gracias aan Claude koppelt en (2) het aanvraagcontract waarmee een AI-agent namens een bedrijf zonder account een offerte-aanvraag indient. HTML-versie: https://gracias.gifts/ai · Achtergrond: https://gracias.gifts/llms.txt

## Voor klanten: Gracias koppelen aan Claude

Klanten van Gracias kunnen het platform als MCP-connector aan Claude koppelen en daarna in een gesprek vragen stellen zoals:

- "Wie heeft er de komende vier weken iets te vieren?"
- "Anna is vijf jaar in dienst. Wat past bij haar, rond de 40 euro?"
- "Zet voor iedereen die in november jarig is een cadeau klaar, budget 25 euro, en houd rekening met hun dieet."
- "Wat heeft Bas vorig jaar gekregen? Herhaal die bestelling met een ander kaartje."
- "Waar staan mijn bestellingen van deze week?"

Koppelen:

1. In Claude: Instellingen → Connectors → Custom connector toevoegen.
2. Adres: `https://mcp.gracias.gifts/mcp` (Claude Code: `claude mcp add --transport http gracias https://mcp.gracias.gifts/mcp`).
3. Inloggen met het Gracias-account. De connector werkt met de rechten van die gebruiker en ziet alleen de eigen organisatie.

Grenzen: Claude bestelt en betaalt niet zelf (hij vult de winkelmand en geeft een checkout-link), verwijderen vraagt altijd bevestiging, en de connector is gebouwd op het open Model Context Protocol en getest met Claude.

## Voor AI-agents: het aanvraagcontract

Een agent kan namens een gebruiker zonder account een offerte-aanvraag indienen. De aanvraag wordt pas echt nadat de contactpersoon op de link in een bevestigingsmail klikt; daarna neemt het team van Gracias binnen één werkdag contact op.

### Endpoint

`POST https://gracias.gifts/api/aanvraag`
`Content-Type: application/json`
Geen authenticatie, geen sleutel.

### Velden

| Veld | Verplicht | Toelichting |
|---|---|---|
| `bedrijf` | ja | Naam van de organisatie |
| `naam` | ja | Contactpersoon |
| `email` | ja | Zakelijk e-mailadres van de contactpersoon; hier gaat de bevestigingsmail heen |
| `bron` | ja | Naam van de agent of assistent (bv. `claude`, `chatgpt`, eigen naam). Zonder dit veld wordt de aanvraag als gewoon formulier behandeld. |
| `tel` | nee | Telefoonnummer |
| `gelegenheid` | nee | Vrije tekst: Kerst, verjaardagen, jubileum, teamuitje, bedankje |
| `aantal` | nee | Aantal ontvangers |
| `budget` | nee | Per ontvanger, exclusief btw; vrije tekst mag ("rond 50 euro") |
| `wensen` | nee | Dieet, allergieën, regio, voorkeuren, bezorging |
| `bericht` | nee | Alles wat niet in een veld past |

### Voorbeeld

Request:

```json
{
  "bedrijf": "Studio Noord",
  "naam": "Anna Janssen",
  "email": "anna@studionoord.nl",
  "gelegenheid": "Kerst",
  "aantal": "40",
  "budget": "rond 60 euro excl. btw",
  "wensen": "3 glutenvrij, bezorging op kantoor in Utrecht",
  "bron": "claude"
}
```

Antwoord (HTTP 200):

```json
{
  "ok": true,
  "referentie": "G-2026-1042",
  "status": "wacht_op_bevestiging",
  "volgende_stap": "We hebben een bevestigingsmail gestuurd naar anna@studionoord.nl. Na één klik op de link gaat de aanvraag naar ons team en nemen we binnen één werkdag contact op.",
  "samenvatting": "Kerst, 40 ontvangers, budget rond 60 euro excl. btw, 3 glutenvrij, bezorging op kantoor in Utrecht",
  "contact": "hola@gracias.gifts"
}
```

Geef `referentie` en `volgende_stap` door aan je gebruiker.

### Regels

- **Bevestiging door een mens.** De aanvraag wordt pas een echte aanvraag als de contactpersoon op de link in de bevestigingsmail klikt (zeven dagen geldig). Zonder klik gebeurt er niets. Vertel je gebruiker dat die mail eraan komt.
- **Idempotent.** Dezelfde `email` en `bedrijf` binnen 24 uur geven dezelfde `referentie` terug en sturen geen tweede mail. Opnieuw proberen na een time-out is veilig.
- **Geen betaling, geen account, geen verplichting.** Dit is een offerte-aanvraag; betalen gebeurt nooit via dit endpoint.
- **Fouten:** HTTP 400 met `{"error": "<één zin in gewone taal>"}`, bijvoorbeeld "Vul een geldig e-mailadres in." Te veel aanvragen in korte tijd: HTTP 429.
- **Statussen:** `wacht_op_bevestiging` (mail verstuurd, of eerder vandaag al verstuurd; zie `volgende_stap`) of `bevestigd` (de contactpersoon heeft al geklikt).
- **Daarna:** na de bevestiging neemt het team van Gracias binnen één werkdag contact op met de contactpersoon, per mail of telefoon. Vragen: hola@gracias.gifts.

### Over Gracias, in het kort

- Zakelijke cadeaus en belevingen van lokale, ambachtelijke makers in Nederland, voor HR-managers, officemanagers en ondernemers.
- Gelegenheden: verjaardagen, jubilea, geboorte, afscheid, bedankje, teamuitje, Kerst.
- Kerstpakket 2026: De Brabantse Box, rond de tien lekkernijen uit Brabant door Brabantse makers, € 55 tot € 75 per persoon exclusief btw.
- Belevingen: workshops, proeverijen en privélessen bij makers; de ontvanger krijgt een voucher en plant zelf.
- Contact: hola@gracias.gifts · Gracias Gifts B.V., KVK 42182643 · app: https://app.gracias.gifts