API e MCP
Un sito di notizie completo, da un solo prompt
Collega Claude Code a News Factory tramite MCP e chiedigli un sito di notizie con una sola frase: lo crea a partire dai tuoi articoli, con immagini, punti chiave, tag, un feed RSS e una sitemap. Il sito si aggiorna da solo, e la stessa chiave ti apre la REST API per qualsiasi altra cosa tu voglia costruire.
- Un solo comando per collegarlo
- Chiave in sola lettura, un solo tema
- Claude Code, Codex o qualsiasi client MCP
Come funziona
I tuoi articoli, aperti ai tuoi agenti
News Factory trova le notizie del tuo tema e scrive gli articoli. L'API e il server MCP permettono ad altri software di usarli: il tuo codice chiama la REST API, e un agente IA come Claude Code si collega al server MCP, dove ogni endpoint dell'API diventa uno strumento che può chiamare.
Entrambi usano la stessa chiave API, ed è la chiave a decidere cosa possono fare. Tramite MCP, un agente vede solo gli strumenti che la sua chiave consente, e ogni chiamata passa gli stessi controlli della REST API.
Passo dopo passo
Da una cartella vuota a un sito online
I quattro passi del video, con i comandi da copiare. Ogni scheda porta al punto corrispondente del video.
- Un tema di News Factory che pubblica articoli
- Una chiave API (Pro, Business o Enterprise)
- Claude Code, oppure Codex
Crea una chiave API
In News Factory, apri Impostazioni organizzazione, poi Chiavi API, e crea una chiave. Dalle un nome, lasciala in sola lettura e scegli il tuo tema. La chiave viene mostrata una sola volta, quindi salvala in .env.local in una cartella vuota.
NEWS_FACTORY_API_KEY=<your key>Collega Claude Code tramite MCP
Un solo comando aggiunge il server MCP di News Factory a Claude Code, con la chiave come bearer token. claude mcp list conferma che è collegato. Usi Codex? Stesso server, un solo comando.
source .env.local claude mcp add --transport http news-factory \ https://client-api.news-factory.app/mcp \ --header "Authorization: Bearer $NEWS_FACTORY_API_KEY" claude mcp listcodex mcp add news-factory \ --url https://client-api.news-factory.app/mcp \ --bearer-token-env-var NEWS_FACTORY_API_KEYChiedi il sito
Con parole semplici, indicando il nome del tuo tema. Tramite MCP, Claude Code verifica la chiave, il tema e un articolo reale, fa un piano, scrive il codice, esegue la build, corregge ciò che si rompe e confronta ogni pagina con i tuoi articoli reali.
Build me a news website that feeds from my News Factory topic Peptides.Pubblica su Vercel
Aggiungi la chiave a Vercel come variabile d'ambiente e pubblica. Nel video, il sito è online 42 secondi dopo.
vercel env add NEWS_FACTORY_API_KEY production vercel deploy --prod
Cosa ha creato
Un vero sito di notizie, con i tuoi articoli
Tutto è nato da una sola frase. Il sito legge direttamente dall'API di News Factory e si aggiorna ogni minuto, così quando News Factory pubblica un nuovo articolo, compare sul sito. Senza toccare il codice, senza ripubblicare.
Home page
Gli ultimi articoli, con le loro immagini.
Una pagina per ogni articolo
Titolo, sommario, immagine principale, punti chiave, l'articolo completo, le FAQ, i tag e gli articoli correlati.
Pagine dei tag
Gli articoli raggruppati per tag.
Feed RSS e sitemap
Pronti per i lettori e per i motori di ricerca.
Creato da Claude Code in un'esecuzione reale di 11 minuti e 43 secondi, poi pubblicato su Vercel.
Non solo siti web
La stessa chiave, per tutto ciò che costruisci
La REST API usa la stessa chiave. Tutto ciò che News Factory fa con articoli, fonti di contenuto, feed RSS e workflow è disponibile, documentato per le persone e per gli agenti IA.
Ricette passo passo nella documentazione di riferimento
- Scrivi un articolo da una pagina web
- Controllalo e miglioralo
- Traducilo
- Scegli le notizie pertinenti dai feed che segui
- Avvia un workflow e attendi che finisca
curl https://client-api.news-factory.app/v1/me \
-H "Authorization: Bearer $NEWS_FACTORY_API_KEY"Inizia ogni integrazione con GET /v1/me: ti indica l'organizzazione, le autorizzazioni della chiave e i workspace tematici che può usare.
Il controllo resta a te
Il tuo agente riceve solo ciò che consenti
Sola lettura, un solo tema
Ogni chiave riceve solo le autorizzazioni che le servono, come la sola lettura, e può essere limitata a un solo workspace tematico. Tramite MCP, l'agente vede solo gli strumenti consentiti da quelle autorizzazioni.
Mostrata una volta, revocata in un minuto
Una chiave viene mostrata una sola volta e conservata solo come hash. Dalle una scadenza, o revocala quando vuoi: smette di funzionare entro un minuto.
Fuori dal codice
Nel video, la chiave sta in .env.local sul tuo computer e in una variabile d'ambiente su Vercel, mai nel codice che scrive l'agente.
Domande
API e MCP: le risposte
Che cos'è il server MCP di News Factory?
È il modo in cui gli agenti IA usano News Factory. Collega Claude Code, Codex, Cursor o qualsiasi client MCP a https://client-api.news-factory.app/mcp con una chiave API, e ogni endpoint dell'API di News Factory diventa uno strumento che l'agente può chiamare, nei limiti delle autorizzazioni della chiave.
Quali piani includono l'API e MCP?
I piani Pro, Business ed Enterprise.
Devo scrivere codice?
Non per il sito del video: Claude Code l'ha scritto tutto partendo da una sola frase. Tu crei una chiave, esegui un comando per collegarla e pubblichi. Per costruire una tua integrazione, la REST API ha una documentazione di riferimento pubblica, una specifica OpenAPI 3.1 e i file llms.txt per gli agenti IA.
È sicuro dare la mia chiave API a un agente IA?
Dagli una chiave con solo l'accesso che gli serve. Per un sito web basta una chiave in sola lettura limitata a un solo workspace tematico. Le chiavi vengono mostrate una sola volta, conservate solo come hash, possono avere una scadenza e smettono di funzionare entro un minuto dalla revoca.
Chi può creare le chiavi API?
Un amministratore dell'organizzazione, nell'app, in Impostazioni organizzazione, Chiavi API. Un'organizzazione può avere più chiavi, ognuna con solo l'accesso che serve a una singola integrazione.
Come resta aggiornato il sito?
Il sito del video legge direttamente dall'API di News Factory e si aggiorna ogni minuto. Quando News Factory pubblica un nuovo articolo nel tuo tema, compare sul sito, senza modifiche al codice e senza ripubblicare.
Posso usare l'API senza MCP?
Sì. La REST API usa la stessa chiave. Inizia con GET /v1/me, poi segui le ricette della documentazione di riferimento: scrivi un articolo da una pagina web, controllalo e miglioralo, traducilo, scegli le notizie pertinenti dai feed che segui, oppure avvia un workflow e attendi che finisca.
Dai al tuo agente la tua redazione
L'API e il server MCP sono inclusi nei piani Pro, Business ed Enterprise. Crea una chiave, collega il tuo agente e chiedi ciò che ti serve.
