Server MCP Linkly
Il Server MCP Linkly ti consente di connettere assistenti AI al tuo account Linkly utilizzando il Model Context Protocol. Una volta connesso, 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 esterni e fonti di dati. Invece di copiare e incollare tra le app, puoi chiedere al tuo assistente AI di eseguire azioni direttamente.
Assistenti AI Supportati
Il Server MCP Linkly funziona con:
- Claude Desktop
- ChatGPT Desktop
- Altri client compatibili con MCP (Cursor, Windsurf, ecc.)
Cosa Puoi Fare
Una volta connesso, puoi chiedere al tuo assistente AI di:
- Creare link brevi - "Crea un link breve per https://example.com"
- Monitorare 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 analisi - "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 eventi di clic"
Per Iniziare
Il Server MCP Linkly ospitato è disponibile su 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 aprirà una finestra del browser che ti chiederà di accedere a Linkly e autorizzare l'accesso. Dopodiché, il tuo assistente resta connesso.
https://mcp.linklyhq.com
Configurazione
Claude Desktop
Apri il file di configurazione di Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Aggiungi il server MCP Linkly:
{
"mcpServers": {
"linkly": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
}
}
}
Riavvia Claude Desktop. La prima volta che utilizzi uno strumento Linkly, si aprirà una scheda del browser per accedere e autorizzare l'accesso.
Claude Code (CLI)
Claude Code supporta nativamente i server MCP remoti. Aggiungi Linkly con un solo comando:
claude mcp add --transport http linkly https://mcp.linklyhq.com
Poi esegui /mcp dentro Claude Code, seleziona linkly e autorizza nel browser quando richiesto.
ChatGPT Desktop
Apri il file di configurazione di ChatGPT:
- macOS:
~/Library/Application Support/ChatGPT/mcp_servers.json - Windows:
%APPDATA%\ChatGPT\mcp_servers.json
Aggiungi il server MCP Linkly:
{
"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 recenti sui clic |
get_analytics | Ottieni dati sui clic in serie temporali per i grafici |
get_analytics_by | Ottieni clic raggruppati per paese, browser, piattaforma, ecc. |
list_domains | Elenca i tuoi domini personalizzati |
list_webhooks | Elenca le sottoscrizioni webhook del workspace |
subscribe_webhook | Sottoscrivi un URL per ricevere eventi di clic |
Opzioni di Creazione Link
Quando crei 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
Risoluzione dei Problemi
"Impossibile connettersi al server MCP"
- Conferma che
https://mcp.linklyhq.comsia raggiungibile dalla tua macchina - Se il tuo client usa
mcp-remote, assicurati di avere Node.js v18 o successivo installato - In Claude Code, esegui
/mcpe seleziona linkly per riattivare il flusso OAuth
"Autenticazione fallita" / il browser continua a chiedere l'accesso
Cancella le credenziali MCP memorizzate dal tuo client e riautorizza. In Claude Code, esegui /mcp → linkly → riconnetti. In Claude Desktop, chiudi l'app, elimina il token mcp-remote memorizzato in ~/.mcp-auth/, quindi riavvia.
Strumenti non visualizzati
- Riavvia il tuo assistente AI dopo aver salvato la configurazione
- Controlla 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
FAQ Server MCP
Devo installare qualcosa per usare il server MCP?
No. Il server ospitato su https://mcp.linklyhq.com utilizza OAuth: accedi una volta nel browser e il tuo assistente AI resta connesso. Non c'è nulla da installare sulla tua macchina oltre al tuo assistente AI stesso.
Serve una chiave API?
No. Il server MCP utilizza OAuth: accedi a Linkly tramite il browser la prima volta che il tuo assistente AI si connette, e non c'è alcuna chiave API da copiare o incollare.
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 unicamente un token di accesso limitato al tuo workspace. Il modello AI stesso non vede mai le tue credenziali.
Posso usare MCP con le versioni web di Claude o ChatGPT?
No, MCP richiede le applicazioni desktop o la CLI di Claude Code. Le versioni web non supportano le connessioni MCP.
Come aggiorno il server MCP?
Non c'è nulla da aggiornare: rilasciamo miglioramenti continui al server ospitato e ogni client connesso li riceve automaticamente.
Monitora 500 clic mensili con tutte le funzioni incluse.
Nessuna carta di credito richiesta