Collegare Adhook agli assistenti IA (MCP)

Scopri come collegare il tuo account Adhook a Claude, Claude Code o ad altri assistenti IA tramite il server MCP. Imparerai anche a usare nei tuoi post immagini e video salvati sul tuo computer.

Che cos'è l'MCP di Adhook?

Il server MCP di Adhook collega assistenti IA come Claude o ChatGPT direttamente al tuo account Adhook. Nella chat puoi quindi, tra l'altro:

creare, pianificare e modificare post sui social media
configurare e gestire boost dei post e campagne pubblicitarie
gestire temi, attività e voci del calendario
rispondere a commenti, messaggi e recensioni e moderarli
analizzare il social listening e i post degli influencer
consultare, creare e analizzare report
creare report ad hoc (oltre 10 fonti dati, oltre 100 segmenti, oltre 250 metriche)

Non è necessario aprire l'interfaccia di Adhook.

MCP sta per Model Context Protocol. Si tratta di uno standard aperto che consente agli assistenti IA di comunicare con servizi esterni.

Per gli amministratori di agenzia è disponibile anche l'MCP Adhook Management per l'onboarding di nuovi clienti. È descritto alla fine di questo articolo. Per il lavoro quotidiano ti serve solo l'MCP di Adhook.

Requisiti

Un account Adhook con le autorizzazioni necessarie
Un client che supporti i connettori MCP remoti, ad esempio:
- Claude nel browser
- Claude Desktop
- Claude Code
- ChatGPT
- un altro assistente IA compatibile con MCP

Installazione e collegamento

URL del server:

https://mcp.adhook.io/mcp

Al primo collegamento accedi tramite OAuth con le tue credenziali Adhook. L'accesso è limitato alle tue autorizzazioni personali in Adhook.

La tua password non viene condivisa con l'assistente IA. Puoi revocare il collegamento in qualsiasi momento in Adhook o nell'assistente.

Claude nel browser o Claude Desktop

Apri Impostazioni → Connettori.
Seleziona Aggiungi connettore personalizzato.
Inserisci il seguente URL: https://mcp.adhook.io/mcp
Salva il connettore.
Fai clic su Connetti e accedi con il tuo account Adhook.

Il connettore Adhook compare quindi con gli strumenti disponibili.

Claude Code nel terminale

claude mcp add --transport http adhook https://mcp.adhook.io/mcp

Al primo utilizzo si apre il login di Adhook nel browser.

Con --scope user puoi rendere il connettore disponibile per tutti i progetti dell'utente:

claude mcp add --transport http --scope user adhook https://mcp.adhook.io/mcp

ChatGPT nel browser

Apri Impostazioni → Plugin → Avanzate.
Attiva la modalità sviluppatore.
Seleziona Crea plugin.
Inserisci il seguente URL: https://mcp.adhook.io/mcp
Salva il plugin.
Fai clic su Connetti e accedi con il tuo account Adhook.

Il plugin Adhook è quindi disponibile in ChatGPT con gli strumenti disponibili.

Altri assistenti IA

Qualsiasi client che supporti i connettori MCP remoti può aggiungere il seguente URL come connettore personalizzato:

https://mcp.adhook.io/mcp

Ciò è possibile, ad esempio, anche con ChatGPT in modalità sviluppatore o connettore. I passaggi esatti variano a seconda del client.

Strumenti disponibili nell'MCP di Adhook

L'assistente sceglie da solo gli strumenti adatti. Non è necessario conoscere i nomi degli strumenti: descrivi semplicemente cosa vuoi ottenere. La panoramica mostra cosa è possibile fare.

Account, brand e team

Strumento	Funzione
`get_current_user`	Mostra l'utente Adhook attualmente collegato.
`get_subtenants`	Elenca i tuoi brand.
`find_subtenant_by_name`	Trova un brand in base al nome.
`get_users`	Elenca gli utenti del tuo account con nome ed e-mail.
`get_teams`	Elenca i team, ad esempio per assegnare messaggi o attività a un team.
`get_tags`	Elenca i tag disponibili, eventualmente filtrati per nome.

Post

Strumento	Funzione
`get_posts`	Elenca o cerca post. È possibile filtrare, tra l'altro, per testo, stato, brand, periodo e canali.
`get_post_by_id`	Recupera tutti i dettagli di un singolo post.
`create_post`	Crea un post con testo, canali, immagini o video, data di pubblicazione, temi, tag e responsabili. Sono possibili testi, media e link diversi per ogni canale. Facoltativamente si può configurare subito un boost.
`update_post`	Modifica un post esistente, ad esempio testo, canali, data, media o boost.
`update_post_tags`	Aggiunge o rimuove tag su uno o più post senza modificare gli altri tag.
`submit_post`	Invia un post per l'approvazione o lo attiva.
`delete_post`	Elimina un post. È possibile solo per i post creati tramite l'MCP.

I canali supportati includono Facebook, Instagram, LinkedIn, TikTok, X, Pinterest, YouTube e Google Business Profile. I canali senza un account collegato del brand vengono deselezionati automaticamente.

Media

Strumento	Funzione
`upload_media`	Importa in Adhook un'immagine o un video accessibile pubblicamente tramite il suo URL.
`create_media_upload_url`	Crea un URL di upload temporaneo per un file locale. Viene usato dall'estensione Local Media (vedi sotto).
`get_pinterest_boards`	Elenca le bacheche Pinterest di un brand. Necessario per creare post su Pinterest.

Campagne pubblicitarie e boost

Strumento	Funzione
`get_campaigns`	Elenca o cerca campagne pubblicitarie.
`get_campaign_by_id`	Recupera tutti i dettagli di una campagna, inclusi gruppi di annunci, budget, posizionamenti e creatività.
`create_campaign`	Crea una campagna pubblicitaria con creatività, targeting, budget, durata e canali, ad esempio Meta, LinkedIn, Google Ads, TikTok e Pinterest. Un budget totale viene suddiviso tra i canali selezionati.
`update_campaign`	Modifica una campagna esistente, ad esempio nome, durata, creatività, targeting, budget, canali o temi.
`submit_campaign`	Verifica una campagna e la invia per l'approvazione o la attiva, a seconda del processo di approvazione configurato.
`change_campaign_status`	Mette in pausa, riattiva o termina una campagna.
`update_campaign_tags`	Aggiunge o rimuove tag su una o più campagne.
`delete_campaign`	Elimina una campagna in Adhook. Viene eliminata anche sulle piattaforme pubblicitarie solo su richiesta esplicita.
`get_targeting_templates`	Elenca i modelli di targeting attivi di un brand. Il modello viene usato per i boost tramite `create_post` o `update_post`.

Un boost si configura direttamente durante la creazione o l'aggiornamento di un post. Puoi definire, tra l'altro, budget, canale, durata, posizionamenti e modello di targeting.

Temi, attività e calendario

Strumento	Funzione
`get_topics`, `get_topic_by_id`	Elenca i temi o recupera i dettagli di un tema.
`create_topic`, `update_topic`	Crea o modifica un tema per la pianificazione editoriale.
`delete_topic`	Elimina un tema. Il collegamento con post, campagne e voci del calendario viene rimosso e le attività collegate vengono eliminate.
`get_tasks`, `get_task_by_id`	Cerca attività per testo, tema, responsabile, stato, brand o scadenza, oppure recupera un'attività.
`create_task`, `update_task`	Crea un'attività oppure la modifica, la riprogramma, la assegna o la completa.
`delete_task`	Elimina un'attività.
`get_custom_events`, `get_custom_event_by_id`	Elenca le tue voci del calendario come newsletter, campagne stampa, comunicati stampa o eventi, oppure recupera una voce.
`create_custom_event`, `update_custom_event`	Crea o modifica una voce del calendario con data, tipo, descrizione, temi, budget e responsabile. Non viene inviato né pubblicato nulla.
`delete_custom_event`	Elimina una voce del calendario.

Community management

Strumento	Funzione
`get_threads`, `get_thread_by_id`	Elenca le conversazioni nella inbox o recupera una conversazione.
`update_thread`, `assign_thread`	Modifica lo stato, i tag o il contrassegno di una conversazione, oppure la assegna a una persona o a un team.
`get_messages`, `get_message_by_id`	Elenca commenti, messaggi, menzioni e recensioni, oppure recupera un singolo messaggio.
`get_message_post_details`	Mostra il post originale a cui appartiene un commento.
`get_moderation_activity`	Mostra la cronologia e le note interne di una conversazione o di un messaggio.
`update_message_status`, `assign_message`	Imposta lo stato di un messaggio (aperto, in corso, completato) o lo assegna.
`update_message`, `update_message_tags`	Modifica i tag, il contrassegno o il sentiment di uno o più messaggi.
`reply_message`	Risponde direttamente sulla piattaforma a un commento, un messaggio o una menzione.
`add_discussion_note`	Aggiunge una nota interna, con notifica facoltativa ai membri del team o via e-mail.
`moderate_message_action`	Mette mi piace, nasconde, mostra di nuovo o elimina un commento sulla piattaforma. Le azioni possibili dipendono dal social network. Ad esempio, su TikTok non è possibile eliminare i commenti di terzi.

Social listening

Strumento	Funzione
`get_social_listening_items`	Recupera i contenuti del social listening con le metriche di engagement: post di profili monitorati (ad esempio concorrenti), risultati per hashtag e parole chiave, notizie, siti web, menzioni, commenti e recensioni. Utile anche per idee di contenuto a confronto con i tuoi post.

Influencer

Strumento	Funzione
`get_influencers`, `get_influencer_by_id`	Elenca gli influencer o recupera un profilo con account social, numero di follower, brand e tag.
`get_influencer_posts`	Elenca i post degli influencer registrati.
`get_influencer_results`	Mostra i risultati aggregati di un influencer in un periodo, ad esempio post, engagement, visualizzazioni e copertura.
`log_influencer_post_by_url`	Registra un post o un reel di Instagram tramite il suo URL. Data, didascalia e metriche pubbliche vengono caricate automaticamente. È necessario un account business o creator pubblico.
`create_influencer_post`	Registra manualmente un post di un influencer con data, canale e metriche, ad esempio per canali diversi da Instagram.

Reporting

Strumento	Funzione
`get_reports`, `get_report_by_id`	Elenca i report esistenti o recupera le impostazioni di un report.
`create_report`, `update_report`	Crea un nuovo report o ne modifica nome, periodo, ambito dei dati, filtri e layout.
`delete_report`	Elimina un report.
`get_report_widgets`	Elenca i widget e le metriche di un report.
`get_report_widget_data`	Recupera i dati di un singolo widget.
`create_report_widget`, `update_report_widget`	Aggiunge a un report grafici, tabelle, riepiloghi KPI, testi, immagini o interruzioni di pagina, oppure li modifica, inclusi fonte dati, metriche, segmenti, filtri e ordinamento.
`delete_report_widget`	Rimuove un widget da un report.
`run_headless_report`	Esegue un'analisi ad hoc per un periodo senza salvare un report. Accede a oltre 10 fonti dati, oltre 100 segmenti e oltre 250 metriche, ad esempio annunci a pagamento, post organici, web analytics, community management, newsletter e SEO.

Esempi di richieste

«Mostrami tutti i post pianificati del brand Esempio SA per la prossima settimana.»
«Crea per Esempio SA un post LinkedIn e Instagram per venerdì prossimo alle 10:00.»
«Usa per il post il seguente testo e le immagini prodotto-1.jpg e prodotto-2.jpg.»
«Sponsorizza questo post con 150 CHF per sette giorni. Usa l'obiettivo Engagement e il modello di targeting DACH Ampio.»
«Quali commenti di ieri sono ancora senza risposta? Proponimi delle risposte.»
«Quali report esistono per Esempio SA?»
«Come si è evoluta la copertura del brand il mese scorso?»
«Mostrami il traffico del sito web proveniente dall'e-mail, suddiviso per campagna.»

Usare immagini e video locali

Un connettore remoto come l'MCP di Adhook non può accedere direttamente ai file sul tuo computer. Anche un'immagine trascinata nella chat non viene trasmessa all'MCP di Adhook dall'assistente IA.

Per i file disponibili solo in locale è quindi disponibile un'estensione aggiuntiva. Viene eseguita sul tuo computer e carica il file selezionato su Adhook.

Importante: questa funzione è disponibile solo con Claude Desktop e Claude Code. Non funziona in claude.ai nel browser né in altri client esclusivamente web. In questi casi usa URL accessibili pubblicamente per i media dei tuoi post, oppure carica prima i file nella Media Library di Adhook e usa gli URL dei media.

1. Aggiornare il connettore Adhook

Per rendere disponibile all'assistente lo strumento create_media_upload_url, scollega una volta il connettore Adhook e collegalo di nuovo.

In alternativa puoi riavviare Claude Desktop.

2. Creare una cartella media

Crea una cartella da cui l'assistente può usare i file.

Esempi:

macOS: ~/AdhookMedia
Windows: C:\Users\<Nome>\AdhookMedia

3. Installare l'estensione

Claude Desktop

Scarica l'estensione: https://media.adhook.io/adhook-local-media-0.1.0.mcpb
Apri il file scaricato con un doppio clic. Claude Desktop mostra quindi la finestra di installazione.
Se non succede nulla, apri in Claude Desktop Settings → Extensions → Install Extension e seleziona il file scaricato.
Nel campo Media folder seleziona la cartella creata al passaggio 2.
Se richiesto, conferma l'avviso che l'estensione non è verificata.
Completa l'installazione. Adhook Local Media Upload compare quindi come estensione attiva in Settings → Extensions.

Non è necessario installare separatamente Node.js o un ambiente di esecuzione simile. Tutti i componenti necessari sono inclusi nel pacchetto.

Claude Code

Esegui il seguente comando nel terminale:

claude mcp add adhook-media --scope user \   --env ADHOOK_MEDIA_DIR="$HOME/AdhookMedia" \   -- npx -y @adhookio/local-media-mcp

È necessario Node.js 18 o una versione successiva.

4. Usare i media locali

Salva l'immagine o il video direttamente nella cartella media configurata.

Chiedi all'assistente, ad esempio:

«Quali immagini ci sono nella cartella media?»

Poi crea il post:

«Crea un post Adhook con prodotto.jpg e il seguente testo: …»

L'assistente carica automaticamente il file e lo aggiunge al post.

Buono a sapersi

Il file deve trovarsi direttamente nella cartella media condivisa.
I file nelle sottocartelle non vengono considerati.
Indica nella richiesta il nome esatto del file.
Un'immagine trascinata nella finestra della chat non viene usata automaticamente tramite l'estensione.
La dimensione massima dei file è di 100 MB.
Per aggiornare l'estensione, installa la nuova versione .mcpb nello stesso modo. Sostituisce la versione precedente.

Risoluzione dei problemi

Problema	Soluzione
L'assistente non trova strumenti Adhook	Controlla il collegamento del connettore e collega di nuovo il connettore Adhook. Se necessario, riavvia Claude Desktop.
Manca `create_media_upload_url`	Scollega il connettore Adhook e collegalo di nuovo.
L'estensione Local Media mostra «not running»	Riavvia Claude Desktop.
L'upload non riesce	Verifica nelle impostazioni dell'estensione che il percorso della cartella media sia corretto.
Immagini o video non vengono trovati	Verifica che i file si trovino direttamente nella cartella media e non in una sottocartella.
Un post non può essere eliminato	Tramite l'MCP si possono eliminare solo i post creati in precedenza tramite l'MCP.

Sicurezza e protezione dei dati

Il collegamento avviene tramite OAuth con le tue credenziali Adhook. La tua password non viene condivisa con l'assistente.
L'assistente può accedere solo ai dati e alle azioni per cui il tuo utente Adhook è autorizzato.
L'estensione Local Media viene eseguita esclusivamente in locale.
L'estensione può accedere solo ai file nella cartella che hai selezionato.
Puoi revocare il collegamento in qualsiasi momento nell'assistente o nelle impostazioni di Adhook.

Per gli amministratori di agenzia: MCP Adhook Management

Questa sezione è rilevante solo se configuri nuovi clienti e account pubblicitari per la tua agenzia. Per il lavoro quotidiano con post, campagne e report basta l'MCP di Adhook.

L'MCP Management è un server separato che colleghi come secondo connettore. Ti permette di gestire l'onboarding di un nuovo cliente nella chat: creare il brand, creare un account pubblicitario, richiedere l'accesso alla pagina Facebook del cliente, impostare le autorizzazioni degli utenti nel Meta Business Manager e assegnare tutto al brand.

Alcune azioni, come la creazione di brand e account pubblicitari, sono riservate agli amministratori. Gli account pubblicitari non possono essere eliminati tramite l'API. Per questo l'assistente ti chiede conferma prima di questi passaggi, ad esempio per nome, valuta e fuso orario di un nuovo account pubblicitario.

Collegamento

Aggiungi un secondo connettore come descritto sopra in Installazione e collegamento, ma con questo URL:

https://mcp.adhook.io/mcp/management

Dai al connettore un nome proprio, ad esempio Adhook Management. In Claude Code:

claude mcp add --transport http --scope user adhook-management https://mcp.adhook.io/mcp/management

Procedura tipica di onboarding Meta

Individuare la pagina Facebook del cliente tramite il suo URL.
Verificare se il tuo Business Manager ha già accesso alla pagina e, in caso contrario, richiedere l'accesso al cliente.
Attendere che il cliente abbia approvato la richiesta, quindi assegnare la pagina a persone del tuo Business Manager.
Creare il brand in Adhook.
Creare un account pubblicitario Meta e assegnarlo al brand. La pagina del cliente viene registrata come inserzionista.
Assegnare altre persone all'account pubblicitario.
Assegnare la pagina Facebook e l'account Instagram al brand e verificare il risultato.

Puoi anche chiedere semplicemente all'assistente: «Configura il nuovo cliente Esempio SA con la pagina Facebook facebook.com/esempiosa.» L'assistente ti guiderà attraverso questi passaggi.

Brand

Strumento	Funzione
`get_subtenants`, `find_subtenant_by_name`	Elenca i tuoi brand o trova un brand in base al nome.
`get_subtenant_by_id`	Mostra tutte le impostazioni di un brand, inclusi gli account dei canali assegnati.
`create_subtenant`	Crea un nuovo brand, una filiale o un nuovo cliente. Solo per amministratori.
`update_subtenant`	Modifica le impostazioni generali di un brand, ad esempio nome, brand principale, sito web, lingue, responsabile, stato, autorizzazioni per post e pubblicità, nonché beneficiario e pagante degli annunci Meta.
`assign_meta_assets_to_subtenant`	Assegna a un brand un account pubblicitario Meta, una pagina Facebook e un account Instagram.

Meta (Facebook e Instagram)

Strumento	Funzione
`get_meta_ad_accounts`	Elenca gli account pubblicitari Meta collegati in Adhook.
`sync_meta_ad_accounts`	Importa gli account pubblicitari a cui hai ottenuto accesso dopo aver collegato Facebook, ad esempio account creati manualmente nel Business Manager.
`create_meta_ad_account`	Crea un nuovo account pubblicitario Meta nel Business Manager della tua agenzia e, facoltativamente, lo assegna a un brand. Solo per amministratori.
`get_facebook_pages`	Elenca le pagine Facebook a cui ha accesso l'utente Facebook collegato.
`resolve_facebook_page`	Individua l'ID e il nome di una pagina Facebook tramite URL, nome utente o ID.
`get_facebook_page_access_status`	Indica se il tuo Business Manager ha accesso a una pagina e lo stato delle richieste di accesso in sospeso.
`request_facebook_page_access`	Richiede al cliente l'accesso come agenzia alla sua pagina Facebook, per poter pubblicare annunci per suo conto.
`get_meta_business_users`	Elenca le persone e gli utenti di sistema del Business Manager della tua agenzia.
`assign_user_to_facebook_page`, `remove_user_from_facebook_page`	Assegna una pagina Facebook a una persona del tuo Business Manager con attività specifiche (ad esempio pubblicare annunci e visualizzare le statistiche), modifica le attività o rimuove la persona.
`get_meta_ad_account_users`	Elenca le persone assegnate a un account pubblicitario, con le relative attività.
`assign_user_to_meta_ad_account`, `remove_user_from_meta_ad_account`	Assegna un account pubblicitario a una persona con un ruolo, modifica il ruolo o rimuove la persona.

Strumento	Funzione
`get_linkedin_ad_accounts`	Elenca gli account pubblicitari LinkedIn collegati in Adhook.
`get_linkedin_pages`	Elenca le pagine aziendali LinkedIn gestite dall'account LinkedIn collegato.
`create_linkedin_ad_account`	Crea un nuovo account pubblicitario LinkedIn per una pagina aziendale. La valuta non può essere modificata in seguito e dovrai poi aggiungere un metodo di pagamento in LinkedIn. Solo per amministratori.
`sync_linkedin_ad_accounts`	Importa gli account pubblicitari LinkedIn a cui hai ottenuto accesso dopo aver collegato LinkedIn.

Utenti

Strumento	Funzione
`get_current_user`	Mostra l'utente Adhook attualmente collegato.
`get_users`	Elenca gli utenti del tuo account, ad esempio per definire il responsabile di un brand.

Esempi di richieste

«Crea il brand Esempio SA e un account pubblicitario Meta in CHF.»
«Richiedi l'accesso alla pagina Facebook facebook.com/esempiosa.»
«Chi del nostro Business Manager ha accesso all'account pubblicitario di Esempio SA?»

Buono a sapersi

Se mancano strumenti come create_subtenant, il connettore Management non è collegato.
Solo gli amministratori possono creare brand e account pubblicitari.
Se un account pubblicitario esistente non viene trovato, chiedi all'assistente di sincronizzare gli account pubblicitari Meta o LinkedIn.
L'assistente esegue azioni di maggiore impatto, come la creazione di account pubblicitari o la modifica delle autorizzazioni degli utenti, solo dopo la tua conferma.