Guida alla configurazione MCP

Name: AdaptlyPost
Rating: 5.0 (110 reviews)
Author: AdaptlyPost

Collega AdaptlyPost al tuo assistente AI in meno di un minuto. Incolla l'URL, accedi quando richiesto e inizia a pubblicare.

Requisiti

Un account AdaptlyPost attivo registrati
Almeno un account social collegato
Facoltativo: un token API per agenti headless e client senza OAuth, da Gestione > API e agenti AI

Configurazione per Claude Code e Cursor

Aggiungi questo alle impostazioni MCP e accedi quando si apre il browser. Per Claude Code: ~/.claude/settings.json. Per 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

Oppure usa il comando da una riga della CLI di Claude Code. Al primo utilizzo apre la pagina di accesso:

Alternativa con chiave API

{
  "mcpServers": {
    "adaptlypost": {
      "type": "http",
      "url": "https://mcp.adaptlypost.com/mcp",
      "headers": {
        "Authorization": "Bearer adaptly_your_key"
      }
    }
  }
}

Per agenti headless o client senza OAuth, aggiungi un header Authorization con un token preso dalla pagina API e agenti AI. Le chiavi iniziano con adaptly_.

Configurazione per Claude Desktop

Claude Desktop si collega tramite il bridge mcp-remote, che apre per te la pagina di accesso. Aggiungi questo al tuo claude_desktop_config.json:

claude_desktop_config.json

{
  "mcpServers": {
    "adaptlypost": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.adaptlypost.com/mcp"]
    }
  }
}

Configurazione per altri client MCP

Qualsiasi client MCP che supporta il trasporto HTTP può collegarsi direttamente.

Endpoint

https://mcp.adaptlypost.com/mcp

Autenticazione

Accedi quando richiesto (OAuth) oppure invia Authorization: Bearer adaptly_your_key

Trasporto

HTTP (Streamable HTTP)

Senza un header Bearer il server risponde 401 con un header WWW-Authenticate, così i client che supportano OAuth aprono da soli la pagina di accesso.

Per i client che supportano solo il trasporto stdio, usa il bridge mcp-remote come mostrato nella sezione Claude Desktop.

Alternativa: Agent Skill

Per Claude Code, Cursor, Windsurf e Codex puoi anche installare AdaptlyPost come agent skill, senza alcuna configurazione MCP.

npx skills add adaptlypost/agent

Installa un SKILL.md e uno script CLI che insegnano al tuo agente l'API di AdaptlyPost. Vedi su GitHub

Riferimento degli strumenti

Il server MCP espone 33 strumenti. La tua AI li scopre da sola, basta chiedere in linguaggio naturale.

Strumento	Descrizione	Parametri principali
list_workspaces	Elenca i workspace in cui il tuo accesso può operare. Passa un id come workspaceId a qualsiasi altro strumento per lavorare in quel workspace.	None
list_accounts	Elenca gli account social collegati con ID, piattaforme, username e stato. Un account segnato come non autorizzato va ricollegato prima di poter pubblicare.	None
upload_media	Carica media da URL o dati base64. Restituisce i mediaUrls per create_post.	urls?, files?
get_upload_urls	Ottieni URL di caricamento prefirmati per caricare i file direttamente nello storage.	files (fileName + mimeType)
open_upload_widget	Mostra un riquadro di caricamento in ChatGPT o Claude, così l'utente può aggiungere foto, video o documenti dal proprio dispositivo. Al termine il riquadro restituisce i mediaUrls.	None
get_upload_ticket	Chiamato dal riquadro di caricamento una volta per file. Nascosto all'AI.	None
create_post	Crea un post per una o più piattaforme: pubblica subito, programma, salva una bozza o ripetilo ogni giorno, settimana, mese o anno.	platforms, contentType, timezone, text?, scheduledAt?, saveAsDraft?, recurrence?, mediaUrls?, mediaAltTexts?, platformTexts?, ConnectionIds, pageIds?, Configs?
get_post	Ottieni tutti i dettagli di un singolo post tramite ID.	id
list_posts	Elenca i post con filtri facoltativi per piattaforma, stato o intervallo di date.	statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset?
update_post	Aggiorna didascalia, programmazione, media o configurazioni delle piattaforme di un post programmato o in bozza.	id, text?, platforms?, contentType?, scheduledAt?, timezone?, mediaUrls?, mediaAltTexts?, platformTexts?, ConnectionIds, Configs?
delete_post	Elimina un post. Un post programmato non verrà pubblicato; un post pubblicato resta online sui social.	id
unschedule_post	Toglie un post programmato dal calendario e lo conserva come bozza senza data.	id
publish_draft	Pubblica subito una bozza o programmala per dopo.	id, timezone, scheduledAt?
list_post_results	Controlla i risultati della pubblicazione per piattaforma, riuscita o non riuscita con i dettagli dell'errore.	id
retry_failed_platforms	Riprova la pubblicazione sulle piattaforme non riuscite.	id, platformIds?
bulk_schedule_posts	Programma più post in una volta con piattaforme e ID di collegamento condivisi.	platforms, timezone, posts[], ConnectionIds, pageIds?, Configs?
list_recurring_posts	Elenca i post ricorrenti (serie) con stato, programmazione e prossima uscita.	statuses?, limit?, offset?
get_recurring_post	Ottieni un post ricorrente tramite ID, compreso il motivo della pausa e quando uscirà il prossimo.	id
pause_recurring_post	Mette in pausa una serie e rimuove il prossimo post programmato.	id
resume_recurring_post	Riprende una serie in pausa dalla prima fascia utile da adesso. Le fasce perse vengono saltate.	id
delete_recurring_post	Ferma una serie per sempre. I post già usciti vengono conservati.	id
get_analytics_overview	Visualizzazioni, like, commenti, condivisioni, follower e tasso di engagement per un intervallo di date, ognuno confrontato con l'intervallo precedente.	from, to, platforms?
get_analytics_timeseries	Le stesse metriche raggruppate per giorno, settimana o mese per le domande sull'andamento.	from, to, platforms?, granularity?
get_platform_breakdown	Le stesse metriche suddivise per piattaforma, con le metriche che ogni piattaforma fornisce.	from, to
list_post_analytics	Metriche per post ordinabili per qualsiasi metrica. Post migliori e "com'è andato questo post".	from, to, platforms?, sortBy?, page?, limit?
get_analytics_sync_status	Quando è stato sincronizzato l'ultima volta ogni account e se qualcuno va ricollegato per le statistiche.	None
trigger_analytics_sync	Aggiorna subito le statistiche. Una volta ogni 10 minuti per workspace.	None
generate_caption	Scrive una didascalia partendo da un prompt, entro il limite di caratteri della piattaforma scelta. Costa 2 crediti AI.	prompt, platform?
refine_caption	Riscrive una didascalia esistente seguendo un'istruzione come "rendila più breve", o completa una didascalia scritta a metà. Costa 2 crediti AI.	prompt, originalText, partialText?, platform?
generate_image	Avvia un'immagine AI e restituisce subito un ID del job. 2 crediti AI per lo standard, 4 per il premium, rimborsati se non riesce.	prompt, aspectRatio?, model?, quality?, sessionId?, referenceImages?
get_image_job	Controlla un job di immagine finché non è completato, con un URL pubblico dell'immagine pronto per un post, o non riuscito.	jobId

Gestire l'accesso

Gli agenti che hanno effettuato l'accesso lo perdono quando rimuovi il connettore nel tuo client o esci. Puoi vedere e revocare i token API in qualsiasi momento dalla tua pagina API e agenti AI. Revocare un token scollega subito qualsiasi agente che lo usa.

Pronto a collegarti?

Incolla l'URL nelle impostazioni MCP, accedi una volta e inizia a pubblicare dalla tua AI.

Inizia la prova gratuita di 7 giorni

Ottieni la chiave API