--- title: "Configurare MCP" description: "Collega AdaptlyPost a Claude, Cursor, Windsurf o a qualsiasi assistente AI compatibile con MCP. Configurazione in meno di un minuto." url: "https://adaptlypost.com/it/features/agents/docs" --- [Torna agli agenti AI](https://adaptlypost.com/it/features/agents) # Guida alla configurazione MCP 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](https://adaptlypost.com/it/signup) * Almeno un account social collegato * Facoltativo: un token API per agenti headless e client senza OAuth, da [Gestione > API e agenti AI](https://adaptlypost.com/it/api-tokens) ## 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](https://adaptlypost.com/it/api-tokens). 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](https://github.com/adaptlypost/agent) ## 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](https://adaptlypost.com/it/api-tokens). 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](https://adaptlypost.com/it/signup)[Ottieni la chiave API](https://adaptlypost.com/it/api-tokens)