Installatiehandleiding MCP
Koppel AdaptlyPost in minder dan een minuut aan je AI-assistent. Plak de URL, log in wanneer daarom wordt gevraagd en begin met posten.
Vereisten
Een actief AdaptlyPost-account registreren
Minstens één gekoppeld social media-account
Optioneel: een API-token voor headless agents en clients zonder OAuth, via Beheren > API en AI-agents
Installatie voor Claude Code en Cursor
Voeg dit toe aan je MCP-instellingen en log in wanneer de browser opent. Voor Claude Code: ~/.claude/settings.json. Voor Cursor: .cursor/mcp.json.
MCP config
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp"
}
}
}Claude Code CLI
claude mcp add --transport http adaptlypost https://mcp.adaptlypost.com/mcpOf gebruik de opdracht van één regel voor de Claude Code CLI. Die opent bij het eerste gebruik de inlogpagina:
Alternatief met API-sleutel
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp",
"headers": {
"Authorization": "Bearer adaptly_your_key"
}
}
}
}Voor headless agents of clients zonder OAuth voeg je een Authorization-header toe met een token van de pagina API en AI-agents. Sleutels beginnen met adaptly_.
Installatie voor Claude Desktop
Claude Desktop koppelt via de mcp-remote-bridge, die de inlogpagina voor je opent. Voeg dit toe aan je claude_desktop_config.json:
claude_desktop_config.json
{
"mcpServers": {
"adaptlypost": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.adaptlypost.com/mcp"]
}
}
}Installatie voor andere MCP-clients
Elke MCP-client die HTTP-transport ondersteunt, kan direct koppelen.
Endpoint
https://mcp.adaptlypost.com/mcp
Authenticatie
Log in wanneer daarom wordt gevraagd (OAuth), of stuur Authorization: Bearer adaptly_your_key
Transport
HTTP (Streamable HTTP)
Zonder Bearer-header antwoordt de server met 401 en een WWW-Authenticate-header, zodat clients die OAuth ondersteunen zelf de inlogpagina openen.
Gebruik voor clients die alleen stdio-transport ondersteunen de mcp-remote-bridge, zoals beschreven in het gedeelte over Claude Desktop.
Alternatief: Agent Skill
Voor Claude Code, Cursor, Windsurf en Codex kun je AdaptlyPost ook als agent-skill installeren, zonder MCP-configuratie.
npx skills add adaptlypost/agentInstalleert een SKILL.md en een CLI-script die je agent de AdaptlyPost API leren. Bekijk op GitHub
Overzicht van tools
De MCP-server biedt 80 tools; de belangrijkste staan hieronder. Je AI vindt ze automatisch, vraag het gewoon in gewone taal.
| Tool | Beschrijving | Belangrijke parameters |
|---|---|---|
| list_workspaces | Toon de werkruimtes waarin je login kan werken. Geef een id als workspaceId mee aan een andere tool om in die werkruimte te werken. | None |
| list_accounts | Toon gekoppelde social media-accounts met ID's, platforms, gebruikersnamen en status. Een account dat als unauthorized is gemarkeerd, moet opnieuw worden gekoppeld voordat het kan posten. | None |
| list_pinterest_boards | Toon de borden van een Pinterest-account, met id, naam, privacy en aantal pins. Geef de bord-id mee als pinterestConfigs[].boardId. | accountId |
| list_wordpress_categories | Toon de categorieën van een WordPress-site, met id, naam en bovenliggende id. Geef de id's mee als wordpressConfigs[].categoryIds. | accountId |
| upload_media | Upload media vanaf URL's of base64-data. Geeft mediaUrls terug voor create_post. | urls?, files? |
| get_upload_urls | Haal vooraf ondertekende upload-URL's op om bestanden direct naar de opslag te uploaden. | files (fileName + mimeType) |
| open_upload_widget | Toon een uploadvak in ChatGPT of Claude, zodat de gebruiker foto's, video's of documenten van zijn apparaat kan toevoegen. Het vak stuurt de mediaUrls terug als het klaar is. | None |
| get_upload_ticket | Wordt per bestand aangeroepen door het uploadvak. Verborgen voor de AI. | None |
| create_post | Maak een bericht voor een of meer platforms: nu publiceren, inplannen, als concept opslaan of dagelijks, wekelijks, maandelijks of jaarlijks herhalen. Gebruik platformMedia om andere media naar één platform te sturen. | platforms, contentType, timezone, text?, scheduledAt?, saveAsDraft?, recurrence?, mediaUrls?, mediaAltTexts?, platformMedia?, platformTexts?, *ConnectionIds, pageIds?, *Configs? |
| get_post | Haal alle details van één bericht op via de ID. | id |
| list_posts | Toon berichten, optioneel gefilterd op platform, status of datumbereik. | statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset? |
| update_post | Werk het bijschrift, de planning, de media of de platforminstellingen van een ingepland bericht of concept bij. | id, text?, platforms?, contentType?, scheduledAt?, timezone?, mediaUrls?, mediaAltTexts?, platformMedia?, platformTexts?, *ConnectionIds, *Configs? |
| delete_post | Verwijder een bericht. Een ingepland bericht gaat dan niet live; een gepubliceerd bericht blijft live op de netwerken. | id |
| unschedule_post | Haal een ingepland bericht uit de kalender en bewaar het als concept zonder datum. | id |
| publish_draft | Publiceer een concept direct of plan het in voor later. | id, timezone, scheduledAt? |
| list_post_results | Bekijk de publicatieresultaten per platform: gelukt of mislukt, met foutdetails. | id |
| retry_failed_platforms | Probeer het publiceren opnieuw op platforms die mislukten. | id, platformIds? |
| bulk_schedule_posts | Plan meerdere berichten tegelijk in met gedeelde platforms en koppelings-ID's. | platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs? |
| list_recurring_posts | Toon terugkerende berichten (reeksen) met hun status, planning en volgende keer. | statuses?, limit?, offset? |
| get_recurring_post | Haal één terugkerend bericht op via de ID, inclusief waarom het is gepauzeerd en wanneer het weer post. | id |
| pause_recurring_post | Pauzeer een reeks en verwijder het eerstvolgende ingeplande bericht. | id |
| resume_recurring_post | Hervat een gepauzeerde reeks vanaf het eerstvolgende tijdslot. Gemiste tijdslots worden overgeslagen. | id |
| delete_recurring_post | Stop een reeks definitief. Berichten die al zijn gepubliceerd, blijven bestaan. | id |
| get_analytics_overview | Weergaven, likes, reacties, shares, volgers en engagementratio voor een periode, elk vergeleken met de vorige periode. | from, to, platforms? |
| get_analytics_timeseries | Dezelfde statistieken per dag, week of maand, voor vragen over trends. | from, to, platforms?, granularity? |
| get_platform_breakdown | Dezelfde statistieken per platform, met de statistieken die elk platform rapporteert. | from, to |
| list_post_analytics | Statistieken per bericht, te sorteren op elke statistiek. Topberichten en "hoe deed dit bericht het". | from, to, platforms?, sortBy?, page?, limit? |
| get_analytics_sync_status | Wanneer elk account voor het laatst is gesynchroniseerd en of er een opnieuw gekoppeld moet worden voor statistieken. | None |
| trigger_analytics_sync | Vernieuw de statistieken nu. Eén keer per 10 minuten per werkruimte. | None |
| generate_caption | Schrijf een bijschrift op basis van een prompt, binnen de tekenlimiet van het gekozen platform. Kost 2 AI-credits. | prompt, platform? |
| refine_caption | Herschrijf een bestaand bijschrift op basis van een instructie zoals "maak het korter", of maak een half geschreven bijschrift af. Kost 2 AI-credits. | prompt, originalText, partialText?, platform? |
| generate_image | Start een AI-afbeelding en krijg meteen een job-ID terug. 2 AI-credits voor standaard, 4 voor premium, terugbetaald als het mislukt. | prompt, aspectRatio?, model?, quality?, sessionId?, referenceImages? |
| get_image_job | Controleer een afbeeldingsjob totdat die klaar is, met een openbare afbeeldings-URL voor een bericht, of mislukt is. | jobId |
Toegang beheren
Ingelogde agents verliezen hun toegang als je de connector in je client verwijdert of uitlogt. API-tokens kun je altijd bekijken en intrekken via je pagina API en AI-agents. Als je een token intrekt, wordt elke agent die het gebruikt direct losgekoppeld.
Klaar om te koppelen?
Plak de URL in je MCP-instellingen, log één keer in en begin met posten vanuit je AI.