API en MCP

De API opent bij de lancering. Wil je vroege toegang? Laat het weten.

Elk betaald plan heeft een REST API en een MCP-server.

Deze pagina geeft het overzicht. De volledige referentie staat op docs.ploffo.com.

Basis

REST API	`https://api.ploffo.com/v1`
MCP-server	`https://mcp.ploffo.com`
Formaat	JSON, UTF-8, tijden in ISO 8601 met tijdzone
Documentatie	`docs.ploffo.com` — opent bij de lancering
Status	`status.ploffo.com` — opent bij de lancering

De API werkt per workspace. Een sleutel geeft toegang tot de workspace waarin je hem maakt.

Authenticatie

Maak een API-sleutel aan in de app, onder de instellingen van je workspace.

Stuur hem mee in de header Authorization: Bearer <sleutel>. Bewaar hem als een wachtwoord; wie de sleutel heeft, kan in jouw naam plannen.

De MCP-server gebruikt dezelfde sleutel, of laat je aanmelden via OAuth.

Een post inplannen met curl

Deze aanvraag plant een post voor woensdag 7 oktober om 09:00 Belgische tijd. De Idempotency-Key zorgt dat dezelfde aanvraag geen tweede post maakt als je ze per ongeluk nog eens stuurt. Kijk naar het uur in het antwoord: jij plant 09:00 in Brussel, het systeem bewaart 07:00Z en onthoudt de tijdzone.

curl

curl -X POST https://api.ploffo.com/v1/posts \
  -H "Authorization: Bearer $PLOFFO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "channelIds": ["ch_7k2m"],
    "body": "Een cijfer zonder bron is een mening.",
    "runAt": "2026-10-07T09:00:00+02:00"
  }'

Antwoord

200 OK

{
  "id": "post_9fq3",
  "status": "scheduled",
  "runAt": "2026-10-07T07:00:00Z",
  "timezone": "Europe/Brussels",
  "channels": [{ "id": "ch_7k2m", "platform": "linkedin", "name": "ceeme" }]
}

MCP-server

MCP is de standaard waarmee AI-assistenten tools aanroepen. Voeg de Ploffo-server toe, en je assistent kan plannen en opvolgen in gewone taal.

Zo ziet de configuratie eruit in een client die een externe MCP-server ondersteunt:

mcp.json

{
  "mcpServers": {
    "ploffo": {
      "url": "https://mcp.ploffo.com",
      "headers": { "Authorization": "Bearer <jouw-sleutel>" }
    }
  }
}

De tools

`list_channels`	De aangesloten kanalen.
`create_post`	Een post aanmaken.
`schedule_post`	Een post inplannen op een datum en uur.
`list_schedule`	Wat er ingepland staat.
`cancel_scheduled_post`	Een ingeplande post annuleren.
`create_approval_round`	Een goedkeuringsronde starten: link en PDF voor een reeks posts.
`get_publication_proof`	Het bewijs van een publicatie: wat, wanneer, en de publieke link.
`get_usage`	Je verbruik in de lopende maand.

Assistenten

Werkt in Claude, ChatGPT, Cursor en elke assistent die MCP spreekt. Je schrijft waar je toch al schrijft; Ploffo plant in.

Verbind je assistent of platform

Je assistent

Elke assistent hieronder praat MCP. De server is voor allemaal dezelfde — https://mcp.ploffo.com — alleen de manier waarop je hem toevoegt, verschilt per assistent.

Je automatiseringsstack

Ook een scenario in n8n of Make kan de Ploffo-server aanroepen, zonder dat er iemand moet typen.

Documentatie

Alle eindpunten, velden, foutcodes en limieten staan op docs.ploffo.com.

Vragen die we vaak krijgen

Op welke plannen zit de API?

Op elk betaald plan: Solo, Studio en Agency. Je krijgt de REST API en de MCP-server.

Wat is een MCP-server?

MCP (Model Context Protocol) is een open standaard waarmee AI-assistenten externe tools gebruiken. Met de Ploffo-server kan een assistent posts plannen, goedkeuring vragen en de status opvragen.

Kan een post via de API de goedkeuring overslaan?

Nee. Een post wordt pas ingepland nadat jij hem hebt goedgekeurd, ook als hij via de API binnenkomt. Of je hem daarnaast ook aan je klant voorlegt, kies je per post.

Zijn er limieten op het aantal aanvragen?

Ja, per sleutel. De actuele limieten staan in de documentatie.

Ingepland. Goedgekeurd. Bewezen.

Begin gratis

Geen kaart nodig. 14 dagen. Geen verplichting.

Basis#

Authenticatie#

Een post inplannen met curl#