Server MCP di Linkly

Il Server MCP di Linkly ti consente di connettere gli assistenti AI al tuo account Linkly utilizzando il Model Context Protocol. Una volta connesso, puoi creare e gestire link brevi attraverso la 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 le azioni direttamente.

Assistenti AI supportati

Il Server MCP di Linkly funziona con:

• Claude Desktop
• ChatGPT Desktop
• Altri client compatibili con MCP (Cursor, Windsurf, ecc.)

Server MCP o Linkly CLI?

Se il tuo assistente AI è un agente di codifica in grado di 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 della riga di comando e la CLI fornisce output --json su ogni comando più 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 connesso, puoi chiedere al tuo assistente AI di:

• Creare link brevi - "Crea un link breve per https://example.com"
• Tracciare le prestazioni - "Quanti click hanno ottenuto i miei link questa settimana?"
• Gestire i link - "Aggiorna il link chiamato 'promo' con una nuova destinazione"
• Visualizzare l'analisi - "Mostrami i click per paese degli ultimi 30 giorni"
• Cercare link - "Trova tutti i link correlati al lancio del prodotto"
• Gestire i domini - "Elenca i miei domini personalizzati"
• Configurare webhook - "Sottoscrivi https://my-site.com/webhook per ricevere gli eventi di click"

Iniziare

Il Server MCP di Linkly 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 questo, il tuo assistente rimane connesso.

https://mcp.linklyhq.com

Configurazione

Claude Desktop

In Claude Desktop, vai a Impostazioni → Connettori → Aggiungi connettore personalizzato. Inserisci 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 rimane quindi connesso — non è necessaria alcuna configurazione o strumenti aggiuntivi.

Claude Code (CLI)

Claude Code supporta i server MCP remoti nativamente. Aggiungi Linkly con un comando:

claude mcp add --transport http linkly https://mcp.linklyhq.com

Quindi esegui /mcp all'interno di Claude Code, scegli 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 MCP di Linkly:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Strumenti disponibili

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

Risoluzione dei problemi

"Impossibile connettersi al server MCP"

• Conferma che https://mcp.linklyhq.com sia raggiungibile dalla tua macchina
• In Claude Code, esegui /mcp e scegli linkly per ri-attivare il flusso OAuth

"Autenticazione non riuscita", "invalid_client" o il browser continua a chiedere di accedere

Questi significano che il tuo client sta mantenendo una registrazione di connessione obsoleta. Cancella le credenziali memorizzate nella cache e ri-autorizza. 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 vengono visualizzati

• 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

• Integrazione Claude Desktop
• Integrazione ChatGPT
• Documentazione API Linkly
• Linkly CLI
• Webhook
• Model Context Protocol