Server Linkly MCP
Il Server Linkly MCP ti consente di collegare gli assistenti AI al tuo account Linkly utilizzando il Model Context Protocol. Una volta collegato, puoi creare e gestire link brevi attraverso una conversazione naturale.
Cos'è MCP?
Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti AI di connettersi in modo sicuro a strumenti e fonti di dati esterni. Invece di copiare e incollare tra le app, puoi chiedere al tuo assistente AI di eseguire azioni direttamente.
Assistenti AI supportati
Il Server Linkly MCP funziona con:
- Claude Desktop
- ChatGPT Desktop
- Altri client compatibili con MCP (Cursor, Windsurf, ecc.)
Dove trovarlo
Il Server Linkly MCP è elencato nelle principali directory MCP, quindi puoi installarlo da dove cerchi già i connettori:
- Directory dei connettori Claude — collegamento con un clic in Claude (web e Desktop)
- Registro MCP ufficiale —
com.linklyhq/linkly - Smithery
- Glama
- mcp.so
- ClaudePluginHub — il plugin Linkly per Claude Code e Cowork
- Codice sorgente su GitHub — con licenza MIT
Server MCP o Linkly CLI?
Se il tuo assistente AI è un agente di codifica che può eseguire comandi shell, come Claude Code o Cursor, la Linkly CLI è spesso una scelta migliore rispetto al server MCP. Gli agenti di codifica hanno già familiarità con gli strumenti da riga di comando e la CLI fornisce output --json su ogni comando oltre a un comando linkly schema che stampa l'intero albero dei comandi, in modo che l'agente possa scoprire tutto ciò che può fare. Il server MCP rimane la scelta migliore per gli assistenti che non possono eseguire comandi shell, come Claude Desktop e ChatGPT Desktop.
Cosa puoi fare
Una volta collegato, puoi chiedere al tuo assistente AI di:
- Creare link brevi - "Crea un link breve per https://example.com"
- Tracciare le prestazioni - "Quanti clic hanno ricevuto i miei link questa settimana?"
- Gestire i link - "Aggiorna il link chiamato 'promo' con una nuova destinazione"
- Visualizzare le analitiche - "Mostrami i clic per paese degli ultimi 30 giorni"
- Cercare link - "Trova tutti i link relativi al lancio del prodotto"
- Gestire i domini - "Elenca i miei domini personalizzati"
- Configurare webhook - "Sottoscrivi
https://my-site.com/webhookper ricevere gli eventi di clic"
Primi passi
Il Server Linkly MCP ospitato si trova all'indirizzo https://mcp.linklyhq.com. Non c'è nulla da installare e nessuna chiave API da copiare — il server utilizza OAuth, quindi la prima volta che il tuo assistente AI si connette, si apre una finestra del browser chiedendoti di accedere a Linkly e approvare l'accesso. Dopo di che, il tuo assistente rimane collegato.
https://mcp.linklyhq.com
Configurazione
Claude desktop
In Claude Desktop, vai su Impostazioni → Connettori → Aggiungi connettore personalizzato. Immetti un nome (Linkly) e l'URL del server MCP remoto:
https://mcp.linklyhq.com
Fai clic su Aggiungi, quindi su Connetti sul connettore Linkly. Si apre una scheda del browser per accedere e approvare l'accesso. Claude Desktop quindi rimane collegato — nessun file di configurazione o strumenti aggiuntivi necessari.
Claude code (CLI)
Claude Code supporta i server MCP remoti in modo nativo. Aggiungi Linkly con un comando:
claude mcp add --transport http linkly https://mcp.linklyhq.com
Quindi esegui /mcp all'interno di Claude Code, seleziona linkly e autorizza nel browser quando richiesto.
ChatGPT desktop
Apri il tuo file di configurazione di ChatGPT:
- macOS:
~/Library/Application Support/ChatGPT/mcp_servers.json - Windows:
%APPDATA%\ChatGPT\mcp_servers.json
Aggiungi il server Linkly MCP:
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com"
}
}
}
Strumenti disponibili
| Strumento | Descrizione |
|---|---|
create_link | Crea un nuovo link breve con parametri UTM opzionali, pixel e altro |
update_link | Aggiorna le impostazioni di un link esistente |
delete_link | Elimina un link |
get_link | Ottieni i dettagli di un link specifico |
list_links | Elenca tutti i link nel tuo workspace |
search_links | Cerca link per nome, URL o nota |
get_clicks | Ottieni i dati di clic recenti |
get_analytics | Ottieni i dati dei clic in serie temporali per i grafici |
get_analytics_by | Ottieni i clic raggruppati per paese, browser, piattaforma, ecc. |
list_domains | Elenca i tuoi domini personalizzati |
list_webhooks | Elenca le sottoscrizioni ai webhook del workspace |
subscribe_webhook | Sottoscrivi un URL per ricevere gli eventi di clic |
Opzioni di creazione dei link
Quando crei i link, puoi specificare:
- Base:
url,name,note,domain,slug,enabled - Parametri UTM:
utm_source,utm_medium,utm_campaign,utm_term,utm_content - Open Graph:
og_title,og_description,og_image - Tracciamento:
fb_pixel_id,ga4_tag_id,gtm_id - Avanzate:
cloaking,forward_params,block_bots,hide_referrer - Scadenza:
expiry_datetime,expiry_destination - I tuoi dati:
metadata, coppie chiave-valore come gli ID dal tuo sistema. Viene restituito con il link e incluso nei payload dei webhook. Vedi metadati del link
Risoluzione dei problemi
"Impossibile connettersi al server MCP"
- Conferma che
https://mcp.linklyhq.comsia raggiungibile dal tuo computer - In Claude Code, esegui
/mcpe seleziona linkly per riavviare il flusso OAuth
"Autenticazione non riuscita", "invalid_client" o il browser continua a chiedere di accedere
Ciò significa che il tuo client sta mantenendo una registrazione di connessione obsoleta. Cancella le credenziali memorizzate nella cache e autorizza di nuovo. In Claude Code, esegui /mcp → linkly → riconnetti. In Claude Desktop, rimuovi il connettore Linkly in Impostazioni → Connettori e aggiungilo di nuovo, quindi accedi di nuovo.
Gli strumenti non appaiono
- Riavvia il tuo assistente AI dopo aver salvato la configurazione
- Verifica che la sintassi JSON nel tuo file di configurazione sia valida
- Verifica che il server MCP sia in esecuzione (controlla l'icona degli strumenti nel tuo assistente)
Risorse correlate
Domande frequenti sul server MCP
Devo installare qualcosa per utilizzare il server MCP?
No. Il server ospitato su https://mcp.linklyhq.com utilizza OAuth — accedi una volta nel browser e il tuo assistente AI rimane collegato. Non è necessario installare alcun software sul tuo computer oltre all'assistente AI stesso.
Ho bisogno di una chiave API?
No. Il server MCP utilizza OAuth — accedi a Linkly tramite il tuo browser la prima volta che il tuo assistente AI si connette e non c'è nessuna chiave API da copiare o incollare da nessuna parte.
Quali assistenti AI supportano MCP?
Claude Desktop, Claude Code (CLI) e ChatGPT Desktop supportano tutti MCP. Anche altri strumenti come Cursor e Windsurf hanno supporto MCP.
Il mio account è sicuro?
Sì. Il server ospitato utilizza OAuth 2.1 con PKCE — la tua password Linkly viene inserita solo su app.linklyhq.com e il tuo assistente AI vede solo un token di accesso limitato al tuo workspace. Il modello AI stesso non vede mai le tue credenziali.
Il server MCP rispetta il mio ruolo nel workspace?
Sì. Il tuo assistente AI può fare tutto ciò che il tuo ruolo consente e niente di più. Se hai il ruolo di Lettura, può cercare link e analitiche ma non può creare, modificare o eliminare nulla.
Disponibilità del piano
Disponibile da Pro
Traccia 500 clic mensili gratuitamente.