Terug naar AI-agents

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/mcp

Of 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/agent

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

ToolBeschrijvingBelangrijke parameters
list_workspacesToon 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_accountsToon 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_boardsToon de borden van een Pinterest-account, met id, naam, privacy en aantal pins. Geef de bord-id mee als pinterestConfigs[].boardId.accountId
list_wordpress_categoriesToon de categorieën van een WordPress-site, met id, naam en bovenliggende id. Geef de id's mee als wordpressConfigs[].categoryIds.accountId
upload_mediaUpload media vanaf URL's of base64-data. Geeft mediaUrls terug voor create_post.urls?, files?
get_upload_urlsHaal vooraf ondertekende upload-URL's op om bestanden direct naar de opslag te uploaden.files (fileName + mimeType)
open_upload_widgetToon 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_ticketWordt per bestand aangeroepen door het uploadvak. Verborgen voor de AI.None
create_postMaak 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_postHaal alle details van één bericht op via de ID.id
list_postsToon berichten, optioneel gefilterd op platform, status of datumbereik.statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset?
update_postWerk 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_postVerwijder een bericht. Een ingepland bericht gaat dan niet live; een gepubliceerd bericht blijft live op de netwerken.id
unschedule_postHaal een ingepland bericht uit de kalender en bewaar het als concept zonder datum.id
publish_draftPubliceer een concept direct of plan het in voor later.id, timezone, scheduledAt?
list_post_resultsBekijk de publicatieresultaten per platform: gelukt of mislukt, met foutdetails.id
retry_failed_platformsProbeer het publiceren opnieuw op platforms die mislukten.id, platformIds?
bulk_schedule_postsPlan meerdere berichten tegelijk in met gedeelde platforms en koppelings-ID's.platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs?
list_recurring_postsToon terugkerende berichten (reeksen) met hun status, planning en volgende keer.statuses?, limit?, offset?
get_recurring_postHaal één terugkerend bericht op via de ID, inclusief waarom het is gepauzeerd en wanneer het weer post.id
pause_recurring_postPauzeer een reeks en verwijder het eerstvolgende ingeplande bericht.id
resume_recurring_postHervat een gepauzeerde reeks vanaf het eerstvolgende tijdslot. Gemiste tijdslots worden overgeslagen.id
delete_recurring_postStop een reeks definitief. Berichten die al zijn gepubliceerd, blijven bestaan.id
get_analytics_overviewWeergaven, likes, reacties, shares, volgers en engagementratio voor een periode, elk vergeleken met de vorige periode.from, to, platforms?
get_analytics_timeseriesDezelfde statistieken per dag, week of maand, voor vragen over trends.from, to, platforms?, granularity?
get_platform_breakdownDezelfde statistieken per platform, met de statistieken die elk platform rapporteert.from, to
list_post_analyticsStatistieken per bericht, te sorteren op elke statistiek. Topberichten en "hoe deed dit bericht het".from, to, platforms?, sortBy?, page?, limit?
get_analytics_sync_statusWanneer elk account voor het laatst is gesynchroniseerd en of er een opnieuw gekoppeld moet worden voor statistieken.None
trigger_analytics_syncVernieuw de statistieken nu. Eén keer per 10 minuten per werkruimte.None
generate_captionSchrijf een bijschrift op basis van een prompt, binnen de tekenlimiet van het gekozen platform. Kost 2 AI-credits.prompt, platform?
refine_captionHerschrijf 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_imageStart 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_jobControleer 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.