Come creare una chiave API
|Una chiave API di MagicPost consente a un assistente IA o al tuo codice di agire sul tuo account MagicPost. Crei una chiave nell'app: apri il menu del profilo, seleziona Impostazioni, poi apri la scheda API e MCP. Le chiavi API sono incluse nei piani Creator, Agency e Team, oltre che durante la prova gratuita di MagicPost. Il piano Growth non include le chiavi API.
Crei una chiave API di MagicPost per chiamare l'API REST di MagicPost e per i tre assistenti che l'app MagicPost configura con una chiave: Claude Desktop, Claude Code e Perplexity. Claude Code può anche connettersi tramite un accesso a MagicPost, senza chiave. Non devi creare una chiave per Claude sul web, ChatGPT o Gemini. Questi tre assistenti si connettono tramite un accesso a MagicPost e MagicPost crea la chiave per te quando approvi la connessione.
Chi può creare una chiave API di MagicPost
Creator, Agency e Team. Le chiavi API e il server MCP di MagicPost fanno parte di questi piani.
Prova gratuita. Le chiavi API sono disponibili per tutta la durata della prova gratuita di MagicPost. Una chiave smette di funzionare quando termina la prova, se non hai un abbonamento a uno di questi piani.
Membri di un'organizzazione. Un membro di un'organizzazione Agency o Team può creare chiavi API di MagicPost. C'è un'eccezione per Agency, dove i posti sono di diversi tipi: un posto Growth, Analytics o Engagement non include le chiavi API. Il posto Creator, che offre accesso completo, le include.
Growth. Il piano Growth non include le chiavi API e MagicPost non mostra la scheda API e MCP a chi ha un abbonamento Growth.
Un abbonamento a un precedente piano MagicPost segue le proprie regole: consulta I piani Analytics e Starter. Per passare a un piano che include le chiavi API, consulta come effettuare l'upgrade del tuo piano MagicPost.
Come creare una chiave API di MagicPost
In MagicPost, apri il menu del profilo e seleziona Impostazioni.
Apri la scheda API e MCP. Il link diretto è app.magicpost.in/settings?tab=api-keys.
Fai clic su Crea una chiave. Quando l'elenco delle chiavi è vuoto, il pulsante nell'elenco mostra Crea la tua prima chiave.
Nella finestra Crea una chiave API, compila Nome della chiave con lo strumento che stai collegando, ad esempio "Claude Desktop". Il nome è obbligatorio.
Fai clic su Crea. La finestra Chiave API creata mostra la chiave.
Fai clic su Copia accanto alla chiave e conservala in un luogo sicuro.
Fai clic su Ho copiato, chiudi.
Una chiave API di MagicPost inizia con mp_. MagicPost mostra la chiave completa una sola volta, nella finestra Chiave API creata. MagicPost memorizza un hash della chiave, non la chiave, quindi nessuno può visualizzarla di nuovo in seguito. Se chiudi la finestra senza copiare la chiave, creane una nuova.
Cosa offre la finestra "Chiave API creata"
Sotto la chiave, la finestra Chiave API creata di MagicPost contiene una scheda per ogni assistente, con le indicazioni su cosa incollare e dove:
Claude Desktop: un blocco di configurazione con la tua chiave già inserita, da incollare nel file claude_desktop_config.json.
Claude Code: un comando con la tua chiave già inserita, da eseguire nel terminale. Claude Code può anche connettersi senza chiave, tramite un accesso a MagicPost: la pagina di Claude Code nella documentazione per sviluppatori di MagicPost descrive questo metodo.
Perplexity: l'indirizzo del server MCP di MagicPost, da aggiungere come connettore personalizzato con autenticazione tramite chiave API.
Claude Web, ChatGPT e Gemini: solo l'indirizzo del server MCP di MagicPost, perché questi assistenti non hanno bisogno di una chiave.
La configurazione di ogni assistente è descritta in Come collegare MagicPost a Claude, ChatGPT, Gemini e Perplexity. Per sapere cosa può fare in MagicPost un assistente connesso, consulta Che cos'è MCP e cosa posso farci? Per una panoramica del prodotto, consulta la pagina della funzionalità LinkedIn MCP.
Come gestire e revocare le tue chiavi API di MagicPost
L'elenco Le tue chiavi nella scheda API e MCP mostra ogni chiave API attiva di MagicPost con il nome, i primi caratteri, la data di creazione e la data dell'ultimo utilizzo. L'elenco non mostra mai una chiave completa.
Le chiavi API di MagicPost create tramite un accesso da Claude sul web, ChatGPT o Gemini compaiono nello stesso elenco, con il nome assegnato dall'assistente al momento della connessione.
Per revocare una chiave API di MagicPost, fai clic sull'icona del cestino nella relativa riga, poi fai clic su Revoca nella finestra Revocare questa chiave API?. L'API di MagicPost verifica la chiave a ogni richiesta, quindi una chiave revocata smette di funzionare immediatamente. La revoca è permanente: una chiave revocata non può essere riattivata. Le chiavi revocate restano visibili in una sezione compressa sotto l'elenco.
Una chiave API di MagicPost non scade. La chiave funziona finché non la revochi o finché l'account MagicPost non perde l'accesso alle API.
MagicPost limita il numero di chiavi API attive per account. L'app MagicPost conta ogni chiave attiva nell'elenco Le tue chiavi, comprese quelle create tramite un accesso da Claude sul web, ChatGPT o Gemini. Quando raggiungi il limite, Crea una chiave è disabilitato e la scheda API e MCP mostra il numero massimo. Revoca una chiave o una connessione a un assistente che non utilizzi più per creare una nuova chiave.
Il limite di MagicPost sulle chiavi API attive blocca solo Crea una chiave nell'app. Un accesso da Claude sul web, ChatGPT o Gemini viene comunque accettato quando l'account ha raggiunto il limite e la chiave di quella connessione viene aggiunta all'elenco Le tue chiavi.
A cosa dà accesso una chiave API di MagicPost
Una chiave API di MagicPost dà accesso all'intero account, non a una sua parte. Con la tua chiave, uno strumento può leggere le tue bozze e le tue metriche LinkedIn, creare e pianificare post, pubblicare sul tuo account LinkedIn e utilizzare i tuoi crediti Leads. Mantieni segreta la chiave e crea una chiave per ogni strumento, così potrai revocarne una senza interrompere il funzionamento degli altri.
In un'organizzazione Agency o Team, una chiave creata dall'account di un amministratore consente di accedere anche agli account dei membri: può elencarli, leggere le loro metriche e i loro post e creare e pianificare post per loro.
Un'agenzia non ha bisogno di una chiave API di MagicPost per ogni cliente. Una chiave creata dall'account di un membro che non è amministratore è limitata all'account di quel membro.
Come utilizzare una chiave API di MagicPost con l'API REST
Per chiamare l'API REST di MagicPost, invia la chiave nell'header Authorization come token bearer: la parola Bearer, uno spazio e poi la tua chiave. L'indirizzo di base dell'API è https://api.magicpost.in/api/v1/. Il riferimento dell'API si trova nella documentazione per sviluppatori di MagicPost. Include chiavi API, metriche, post e pianificazione.
Una chiave API di MagicPost da sola non consente di caricare un file multimediale in un post tramite l'API REST: solo il server MCP di MagicPost allega un file a una bozza. Una chiamata REST diretta può comunque modificare il titolo e il testo alternativo di un contenuto multimediale già allegato.
L'API di MagicPost limita il numero di richieste al minuto per ogni chiave. L'aggiornamento dei post LinkedIn e il rilevamento dei leads hanno un limite al minuto più restrittivo. La pubblicazione e la pianificazione di un post hanno ciascuna un proprio limite al minuto. La generazione di post ha limiti distinti al minuto, al giorno e alla settimana. Quando superi un limite, l'API di MagicPost risponde con lo stato HTTP 429 e la risposta indica il limite applicabile.
La documentazione per sviluppatori di MagicPost indica i valori in due punti. La pagina degli errori e dei limiti di frequenza indica il limite predefinito al minuto e il limite per l'aggiornamento dei post. La voce generate_post della pagina degli strumenti indica i limiti per la generazione dei post.
MagicPost limita inoltre il numero di post che un profilo LinkedIn può pubblicare ogni 24 ore, includendo anche i post pianificati. Quando superi questo limite, l'API di MagicPost rifiuta la pubblicazione o la pianificazione con lo stato HTTP 429 e la risposta indica il limite e il prossimo slot disponibile. Il limite dipende dall'account.
Domande frequenti
Ho perso la mia chiave API di MagicPost. Posso visualizzarla di nuovo?
No. MagicPost mostra una chiave API una sola volta, quando la crei, e ne memorizza solo un hash. Revoca la chiave persa in Impostazioni, API e MCP, poi crea una nuova chiave e sostituiscila nel tuo strumento.
Perché nelle impostazioni di MagicPost non c'è la scheda API e MCP?
MagicPost nasconde la scheda API e MCP in due casi: utilizzi il piano Growth oppure sei membro di un'organizzazione Agency con un posto Growth, Analytics o Engagement. Le chiavi API sono incluse nei piani Creator, Agency e Team. In un account gratuito la cui prova è terminata, la scheda è visibile, ma Crea una chiave apre una finestra per effettuare l'upgrade.
Ho bisogno di una chiave API di MagicPost per ogni cliente o membro del team?
No. In un'organizzazione Agency o Team, una chiave creata dall'account di un amministratore consente di accedere agli account di tutti i membri. Se preferisci una chiave per ogni membro, creala dalle impostazioni dell'account di quel membro.
Una connessione da ChatGPT, Gemini o Claude sul web crea una chiave?
Sì. Quando approvi la connessione nella pagina di autorizzazione di MagicPost, MagicPost crea una chiave API a cui assegna il nome fornito dall'assistente. MagicPost elenca questa chiave nella scheda API e MCP e revocarla disconnette l'assistente. Quando un connettore che MagicPost già conosce effettua nuovamente l'accesso, MagicPost revoca la chiave precedente di quel connettore e ne crea una nuova.
La mia chiave API di MagicPost ha smesso di funzionare. Perché?
Ci sono due motivi comuni. La chiave è stata revocata nella scheda API e MCP. Oppure l'account non ha più accesso alle API, ad esempio perché la prova gratuita è terminata o perché è passato a un piano senza chiavi API. Nel secondo caso, l'API di MagicPost risponde che l'accesso alle API e a MCP non è incluso nel tuo piano.
Hai bisogno di aiuto?
Contattaci tramite la chat nell'app oppure prenota una chiamata di onboarding di 30 minuti: https://cal.com/magicpost/book-a-call