Riferimento della LinkedIn API
La LinkedIn API è l'intera superficie di LinkedIn con una sola chiave — Classic, Recruiter, Sales Navigator, pagine, offerte di lavoro, messaggistica e la Magic Route. Ogni operazione qui sotto è attiva sul DSN /linkedin.
In breve #
Questo riferimento copre LinkedIn, una parte della Top-Rated Team API. La stessa chiave raggiunge anche l'API dei canali di messaggistica: un'inbox condivisa per WhatsApp, Telegram, e-mail, SMS, LINE, TikTok, Instagram, Facebook Messenger e chat web, e il tuo account X. Chiavi e account collegati stanno nel pannello; aggiungi un account dal pannello.
Usala da un'IA #
Ogni operazione qui sotto è disponibile anche come strumento per qualsiasi assistente IA che parli MCP, a un solo indirizzo:
https://top-rated.team/linkedin/mcp/<your API key>Incollalo dove il tuo assistente chiede l'indirizzo di un server MCP. Non c'è niente da installare: la chiave nell'indirizzo è una normale chiave API, gli strumenti sono costruiti a partire dal catalogo qui sotto, e ogni chiamata che l'assistente fa passa per gli stessi controlli sulla chiave, sul piano e sulla proprietà dell'account a cui passano le tue richieste. Revocare la chiave chiude la connessione. Creane una nel pannello — «Collega la tua IA».
L'indirizzo contiene la tua chiave, quindi trattalo come una password: chiunque lo abbia può usare il tuo account attraverso di esso. Se dovesse trapelare, revoca quella chiave e creane un'altra.
Collegarlo, un client alla volta
Ogni client qui sotto prende quell'unico indirizzo e nient'altro. Sono i passaggi che la dashboard dà dopo aver creato una chiave, e sono gli stessi per qualunque agente.
Non c'è nessun passaggio di accesso. La tua chiave è già dentro quell'indirizzo, quindi quando un assistente chiede come autenticarsi, scegli l'opzione che significa «nessuna» — di solito si chiama No sign in, No authentication o None. Non configurare un client OAuth e non aggiungere un header di richiesta. È proprio su questa domanda che si blocca quasi chiunque.
ChatGPT
Apri Settings e cerca Connectors — a seconda di quando leggi queste righe potrebbe chiamarsi Apps & Connectors o Plugins — poi l'opzione per aggiungere un connettore custom o un server MCP. Su alcuni piani si trova dietro un interruttore Developer mode nella stessa area. Incolla l'indirizzo come URL del server, scegli l'opzione senza autenticazione e accetta l'avviso che compare sul collegamento di un server di terze parti.
Scritto in modo volutamente vago: OpenAI ha spostato questa impostazione più di una volta e non è offerta su tutti i piani, quindi un percorso di clic preciso qui sarebbe sbagliato nel giro di un mese. Se non la trovi proprio, il tuo account non ce l'ha — usa Claude, oppure chiama l'API dal tuo codice. La loro pagina attuale è help.openai.com.
Claude
- Apri Settings → Customize → Connectors.
- Fai clic su + Add, poi su Add custom connector.
- Dagli un nome che riconoscerai (Top-Rated Team va benissimo), incolla l'indirizzo qui sopra come remote MCP server URL e premi Continue.
- Nel passaggio di autenticazione scegli No sign in e lascia vuoto Request headers. Premi Add.
- Poi, in una conversazione, premi + in basso a sinistra, scegli Connectors e attivalo.
Con un piano Team o Enterprise, un proprietario lo aggiunge una volta sola in Organization settings → Connectors, e tutti gli altri lo attivano dal proprio elenco Connectors. Le istruzioni di Anthropic stessa sono su support.claude.com, e sono quelle a cui credere se questa pagina e quella dovessero mai dire cose diverse.
Cursor
Apri le impostazioni di Cursor e cerca MCP — a seconda della versione si è trovato sotto Tools, sotto Integrations o sotto Features. Aggiungi un server, dagli un nome e incolla l'indirizzo come suo url; lascia vuoti gli header e l'autenticazione. Cursor lo conserva in ~/.cursor/mcp.json, dove puoi anche scriverlo tu stesso: una voce mcpServers il cui unico campo è url.
Un server messo nel .cursor/mcp.json di un singolo progetto va attivato una volta in quella stessa schermata di impostazioni prima che l'agente lo usi. Uno nel file della tua cartella personale è attivo ovunque.
VS Code
VS Code raggiunge i server MCP tramite la modalità agente di GitHub Copilot, quindi Copilot va acceso prima. Il pulsante qui sotto passa l'indirizzo a VS Code, che chiede una volta prima di aggiungerlo. A mano è MCP: Add Server nella palette dei comandi, poi HTTP, poi l'indirizzo.
Quel pulsante apre VS Code Stable. Insiders prende lo stesso indirizzo sotto vscode-insiders:, e la strada della palette dei comandi funziona su entrambi — come code --add-mcp in un terminale.
Grok
Apri grok.com/connectors, premi New connector e scegli Custom. Incolla l'indirizzo come URL del server MCP e scegli l'opzione senza autenticazione. Su un account Business o Enterprise un amministratore aggiunge prima il connettore per l'organizzazione, e poi ogni persona lo attiva per sé.
È l'assistente di xAI che legge il tuo account tramite MCP. È una cosa diversa dall'API di X, che pubblica e legge sul social network X stesso e ha chiavi proprie — se è quello che ti serve, collega invece il canale X.
Gemini
Apri gemini.google.com/apps — la sua pagina Connected apps — e scegli Add a custom app. Incolla l'indirizzo qui sopra come MCP server URL, premi Next e consenti l'accesso. Viene aggiunta nell'app web e poi c'è anche nell'app mobile di Gemini.
Apri le app collegate di Gemini
Google offre le app personalizzate su alcuni account Google e non su altri — un account personale, l'inglese e l'app web anziché il telefono, al momento in cui scriviamo — quindi se in quella pagina non c'è Add a custom app, il tuo account non ce l'ha ancora. La pagina di Google stessa è support.google.com, ed è quella a cui credere se questa pagina e quella un giorno non coincidono. Gemini ti chiede di confermare tutto ciò che scrive.
Claude Code
In un terminale, esegui claude mcp add --transport http top-rated seguito dall'indirizzo qui sopra tra virgolette. Aggiungi -s user per averlo in ogni progetto e non solo in questo. Così è disponibile in Claude Code ovunque tu lo usi — il terminale, l'app desktop e gli editor in cui si integra — e /mcp elenca cosa può fare. Nessun accesso da fare: la chiave è già nell'indirizzo.
Codex
In un terminale, esegui codex mcp add top-rated --url seguito dall'indirizzo qui sopra tra virgolette. A mano, è un blocco [mcp_servers.top-rated] con una riga url in ~/.codex/config.toml. Non mettere una riga command nello stesso blocco: Codex rifiuta un server descritto in entrambi i modi.
Un Codex più vecchio leggeva url solo con experimental_use_rmcp_client = true in cima a quel file. Aggiorna prima Codex e aggiungi quella riga solo se, dopo, l'indirizzo viene ancora ignorato.
Altri assistenti
Qualsiasi assistente che parli MCP su HTTP accetta lo stesso unico indirizzo e nient'altro. Non c'è nessun pacchetto da installare né alcun file di configurazione da modificare. Se chiede un trasporto, è un server remoto su HTTP, non un comando da eseguire.
Verifica che funzioni. Chiedi all'assistente «elenca i miei account LinkedIn collegati». Se risponde con i tuoi account, è tutto collegato. Se dice di non avere uno strumento del genere, l'indirizzo è stato incollato troncato prima della chiave, oppure il connettore è stato aggiunto ma non attivato in quella conversazione.
Catalogo degli endpoint #
Ogni operazione della LinkedIn API, raggruppata per area. Apri una scheda per vederne i parametri, la richiesta e la risposta.