In breve
Esegui un profilo Threads dalla tua AI: leggi post, risposte, intere conversazioni e menzioni, pubblica e analizza post e account, ricerca per parole chiave e profili pubblici, pubblica testi, immagini, video e post e risposte a carosello, e nascondi o approva risposte. Un token utente Threads a lungo termine.
Configurazione guidata
Collega Threads a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Threads con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Threads
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Threads, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Threads + Microsoft Copilot
Esegui un profilo Threads dalla tua AI: leggi post, risposte, intere conversazioni e menzioni, pubblica e analizza post e account, ricerca per parole chiave e profili pubblici, pubblica testi, immagini, video e post e risposte a carosello, e nascondi o approva risposte. Un token utente Threads a lungo termine.
Requisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
THREADS_ACCESS_TOKEN
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 15 minuti. Hai bisogno di un'app Meta con il caso d'uso Accedi all'API di Threads e di un token utente Threads a lungo termine per il profilo con cui il connettore deve operare. Funziona con qualsiasi profilo Threads che ha autorizzato la tua app, inclusi gli account personali.
- Crea un'app Meta su developers.facebook.com/apps/creation con il caso d'uso Accedi all'API di Threads. Nella pagina Personalizza del caso d'uso aggiungi i permessi di cui hai bisogno:
threads_basic(sempre),threads_content_publish,threads_read_replies,threads_manage_repliesethreads_manage_insights, piùthreads_manage_mentions,threads_keyword_search,threads_profile_discovery,threads_location_taggingethreads_deletese utilizzi quegli strumenti. - Mentre l'app è in fase di sviluppo, solo le persone associate possono autorizzarla. Aggiungi il profilo sotto Ruoli dell'app → Ruoli → Aggiungi persone → Tester di Threads, poi accetta l'invito in Threads (Impostazioni → Account → Permessi del sito → Inviti).
- Ottieni un token utente: nel Graph API Explorer seleziona la tua app, cambia l'host in
threads.net, scegli i permessi e clicca su Genera token di accesso a Threads. Questo token dura un'ora. - Scambialo per un token a lungo termine (60 giorni) aprendo
https://graph.threads.net/access_token?grant_type=th_exchange_token&client_secret=<Threads app secret>&access_token=<short-lived token>. Il segreto dell'app Threads si trova sotto Impostazioni dell'app → Base. Copiaaccess_tokendalla risposta. - Incollalo in
THREADS_ACCESS_TOKEN, senza la parola Bearer (inizia conTH). Installa il connettore ed eseguithreads_get_profileper controllare la connessione: restituisce l'ID utente e l'handle del profilo.
Il token dura 60 giorni: Threads non fornisce un token di aggiornamento per questo tipo di connettore, quindi il token che incolli è l'unica credenziale. Aggiorna prima che i 60 giorni siano scaduti (e almeno 24 ore dopo che è stato emesso) aprendo https://graph.threads.net/refresh_access_token?grant_type=th_refresh_token&access_token=<current token>, poi incolla il nuovo token nel connettore. Un token che non è stato aggiornato in tempo non può essere rinnovato: ripeti i passi 3 e 4. Il Debugger del token di accesso mostra quando un token scade.
Cloud e self-hosted funzionano allo stesso modo: crei il token su Meta e lo incolli. Non c'è un URL di reindirizzamento da impostare in AnythingMCP.
Da dove iniziare: threads_get_profile, poi threads_list_posts per i post del profilo. Gli strumenti che agiscono sul profilo connesso usano me, quindi non passi mai un ID utente. Per le risposte, threads_list_replies restituisce le risposte di primo livello a un post e threads_get_conversation tutto ciò che è sotto di esso, con replied_to per ricostruire l'albero. threads_list_mentions e threads_list_my_replies coprono il resto dell'attività del profilo.
Insights: threads_get_post_insights restituisce visualizzazioni, mi piace, risposte, repost, citazioni e condivisioni di un post; threads_get_account_insights restituisce totali del profilo su un periodo, visualizzazioni al giorno e, da 100 follower, demografia dei follower. Gli insights esistono solo per i post del profilo connesso.
Scoperta: threads_search_posts cerca per parola chiave o tag tematico (senza il permesso approvato threads_keyword_search cerca solo i post del profilo; 2.200 ricerche ogni 24 ore). threads_lookup_profile e threads_list_profile_posts leggono profili pubblici per nome utente esatto, e threads_search_locations trova ID di località da taggare.
La pubblicazione è immediatamente pubblica: l'AI ti mostra il testo e i media esatti e aspetta un sì prima di pubblicare. Un post o una risposta testuale è una chiamata, threads_post_text (massimo 500 caratteri; reply_to_id lo rende una risposta). Un post di immagine o video richiede threads_create_container con un URL di media pubblico, per il video threads_get_container_status fino a quando non è FINISHED (circa 30 secondi in media), poi threads_publish. Un carosello è composto da 2 a 20 contenitori di elementi, un contenitore CAROUSEL con i loro ID e il testo, poi threads_publish. threads_repost ripubblica un post. threads_get_publishing_limit mostra le quote: 250 post, 1.000 risposte e 100 cancellazioni ogni 24 ore.
Moderazione: threads_hide_reply nasconde o mostra nuovamente una risposta di primo livello sui post del profilo. Per i post creati con approvazioni delle risposte, threads_list_pending_replies e threads_manage_pending_reply approvano o ignorano le risposte in attesa.
Disattivato all'installazione: threads_delete_post (cancella un post, una risposta o un repost per sempre). Una cancellazione non può essere annullata e richiede il permesso threads_delete. Attivalo nella pagina del connettore solo se l'AI deve cancellare; ti chiede di confermare ogni chiamata. La pubblicazione, il repost, il nascondere le risposte e l'approvazione delle risposte sono attivati (threads_post_text, threads_create_container, threads_publish, threads_repost, threads_hide_reply, threads_manage_pending_reply).
Paging e ID: le liste restituiscono data e paging.cursors; l'AI passa paging.cursors.after come after fino a quando non è mancante, con al massimo 100 elementi per pagina. Gli ID sono stringhe di cifre e vengono passati invariati. since e until accettano secondi Unix o date.
Errori comuni: 190 significa che il token è scaduto o è stato revocato (l'utente ha rimosso l'app o ha cambiato la password), oppure è un token di Facebook o Instagram piuttosto che un token di Threads: creane uno nuovo (passi 3 e 4). 10 o 200 significa che manca un permesso: aggiungilo nel caso d'uso e genera nuovamente il token. 4, 17, 32 o 613 è limitazione della velocità: aspetta qualche minuto. Un contenitore in ERROR di solito significa che Meta non è riuscita a scaricare l'URL del media (deve essere pubblico e non deve reindirizzare) o il formato non è supportato.
Non coperto: altri profili Threads diversi da quello che possiede il token (aggiungi un secondo connettore per un secondo profilo), e le API di Facebook e Instagram.
Passo 2 — Installa l'adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Passo 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Threads. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
threads_get_profile | Il profilo Threads connesso: id, nome utente, nome visualizzato, biografia, URL dell'immagine del profilo e is_verified |
threads_get_publishing_limit | Quanto delle quote di 24 ore il profilo ha utilizzato: post (quota_usage di 250, i caroselli contano una volta), risposte (reply_quota_usage… |
threads_list_posts | Elenca i post pubblicati dal profilo connesso, dal più recente: id, testo, tipo di media e URL, permalink, timestamp, link a citazioni e repost… |
threads_get_post | Un post o una risposta Threads per id media: testo, tipo di media e URL, permalink, proprietario, timestamp, figli di un carosello, citati o ripubblicati… |
threads_list_my_replies | Elenca le risposte scritte dal profilo connesso su qualsiasi post, dal più recente, con il post a cui ciascuna risponde (replied_to, root_post) |
threads_list_mentions | Elenca i post pubblici di altri profili che menzionano il profilo connesso (@username), dal più recente |
threads_list_replies | Elenca le risposte di primo livello a un post (non le risposte alle risposte), dal più recente per impostazione predefinita, con nome utente, testo, timestamp, hide_status e… |
threads_get_conversation | L'intera conversazione sotto un post come un'unica lista piatta: risposte di primo livello e annidate, ciascuna con replied_to e root_post così l'albero può essere… |
threads_list_pending_replies | Elenca le risposte in attesa di approvazione su un post pubblicato con approvazioni delle risposte attivate (enable_reply_approvals).… |
threads_hide_reply | Nascondi o mostra nuovamente una risposta di primo livello su uno dei post del profilo connesso |
threads_manage_pending_reply | Approva o ignora una risposta in attesa (da threads_list_pending_replies) |
threads_get_post_insights | Engagement totale di uno dei post del profilo connesso: visualizzazioni, mi piace, risposte, repost, citazioni e condivisioni |
threads_get_account_insights | Insights a livello di profilo dell'account connesso su un periodo: visualizzazioni (al giorno), mi piace, risposte, repost, citazioni, clic sui link e… |
threads_search_posts | Cerca post pubblici di Threads per parola chiave o tag tematico, più popolari (TOP) o più recenti (RECENT), opzionalmente solo post testuali, di immagine o video… |
threads_lookup_profile | Profilo pubblico di un altro utente Threads per nome utente esatto: nome, biografia, immagine del profilo, is_verified, follower_count e i mi piace… |
threads_list_profile_posts | Post pubblici recenti di un altro profilo Threads per nome utente esatto, dal più recente |
threads_search_locations | Trova luoghi da taggare in un post, per nome o per coordinate; restituisce ID di località con nome, indirizzo, città, paese e coordinate |
threads_post_text | Pubblica un post testuale, o una risposta testuale, in un solo passaggio (auto_publish_text): va in diretta sul profilo connesso immediatamente |
threads_create_container | Passo 1 della pubblicazione di un post di immagine, video o carosello (o risposta): crea un contenitore di media da un URL pubblico |
threads_get_container_status | Stato di un contenitore di media prima della pubblicazione: IN_PROGRESS (in fase di elaborazione, controlla di nuovo tra qualche secondo), FINISHED (pronto per… |
threads_publish | Passo 2 della pubblicazione: pubblica un contenitore di media FINISHED sul profilo connesso |
threads_repost | Ripubblica un post Threads pubblicato sul profilo connesso (come il pulsante di repost) |
threads_delete_post | Cancella uno dei post, risposte o repost del profilo connesso per sempre |
Esempi di prompt
- "Quali dei miei post Threads degli ultimi 30 giorni hanno ricevuto più visualizzazioni, e quante risposte ha ricevuto ciascuno?"
- "Mostrami l'intera conversazione sotto il mio ultimo post e riassumi cosa stanno chiedendo le persone."
- "Redigi una risposta alla domanda principale sotto quel post e mostramela prima di pubblicarla."
- "Come sono cambiati le visualizzazioni del mio profilo e i follower questo mese?"
- "Trova post recenti di Threads sul nostro nome prodotto e elenca gli account che li hanno scritti."
FAQ
Cosa succede quando il token scade? Le chiamate falliscono con errore 190. Aggiorna il token prima che i 60 giorni siano scaduti con grant_type=th_refresh_token e incolla il nuovo nel connettore; dopo la scadenza, genera un nuovo token e scambialo di nuovo.
Può cancellare post? Solo se attivi threads_delete_post nella pagina del connettore e il token ha il permesso threads_delete. È disattivato all'installazione.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?