Come creare una chiave API

La tua chiave API è ciò che consente a un assistente AI (o al tuo codice) di agire sul tuo account MagicPost. Ne hai bisogno per Claude Desktop, Perplexity o per chiamare direttamente l'API.

Non è necessario crearne una per Claude sul web, ChatGPT o Gemini: questi si collegano tramite OAuth e la chiave viene creata per te quando approvi la connessione. Viene mostrata nello stesso elenco qui sotto e puoi revocarla allo stesso modo.

Creare una chiave

1. In MagicPost, vai alle impostazioni del tuo account, scheda API & MCP.

2. Fai clic su Crea una chiave.

3. Assegna ad essa un nome in base a ciò che stai collegando: "Claude Desktop", "Perplexity", "mio script". Il nome serve solo a te e sarai felice di essere stato specifico quando ne avrai quattro.

4. Copia subito la chiave.

La chiave inizia con mp_. Viene mostrata esattamente una volta, al momento della creazione, e mai più. Se chiudi la finestra di dialogo senza averla copiata, andrà persa. Dovrai crearne un'altra.

Trattala come una password

Una chiave fornisce l'accesso completo al tuo account: può leggere le tue metriche, pubblicare post sul tuo LinkedIn e spendere i tuoi crediti.

• Non incollarla mai in un repository pubblico, in un documento condiviso o in uno screenshot.

• Non condividerla mai con nessun altro. Fornisci loro una propria chiave.

• Se sospetti che sia stata trapelata, revocala immediatamente e creane una nuova.

Gestire le chiavi

La stessa schermata elenca le tue chiavi, con il loro prefisso e la data di creazione, mai la chiave stessa, poiché non la conserviamo.

• Fino a 10 chiavi attive per account. Abbastanza per una per strumento. Le chiavi create da una connessione OAuth (Claude web, ChatGPT, Gemini) non contano ai fini di questo limite.

• Revoca qualsiasi chiave in qualsiasi momento. La revoca è permanente: una chiave revocata non può essere riattivata. Per una connessione OAuth, la revoca della chiave scollega l'assistente; ricollegandolo ne viene emessa una nuova.

Usa una chiave per strumento. Quando smetti di usare uno strumento, revocane la chiave. In questo modo, una fuga di dati non comporterà mai la revoca di tutto.

Utilizzo

Per un assistente AI, segui Come collegare MagicPost a Claude o Come collegare MagicPost a Perplexity.

Per l'API, inviala come token bearer:

Authorization: Bearer mp_vostro_token

L'URL di base è https://api.magicpost.in/api/v1/ e il riferimento completo si trova su https://dev.magicpost.in**.

Limiti di frequenza: 60 richieste al minuto per chiave. Due endpoint costosi sono invece limitati a 5 richieste al minuto: l'aggiornamento dei post di LinkedIn e il rilevamento dei lead. Oltre la soglia, l'API risponde con 429.

FAQ

Ho perso la mia chiave.

Non può essere recuperata. Non la memorizziamo mai in chiaro, ed è proprio per questo che è sicura. Revocala e creane una nuova.

Ho revocato una chiave e funziona ancora.

La propagazione della revoca richiede fino a un minuto. Dopodiché è disattivata.

Come faccio a sapere se una chiave funziona ancora?

Il tuo assistente te lo comunicherà presto: gli strumenti smetteranno di rispondere. Dal codice, chiama GET /api/v1/auth/verify.

Di quale piano ho bisogno?

L'accesso API e MCP è incluso nel piano Creator e superiori.

Hai bisogno di aiuto?

Contattaci tramite la chat integrata nell'app o prenota una chiamata di onboarding di 30 minuti: https://cal.com/magicpost-team/contact-sales-team