Server MCP di Linkly

Il server MCP di 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 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.)

Dove trovarlo

Il server MCP di Linkly è elencato nelle principali directory MCP, quindi puoi installarlo da dove cerchi già i connettori:

• Directory dei connettori Claude — connessione 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
• 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 più adatta del 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 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 clic hanno ricevuto i miei link questa settimana?"
• Gestire i link - "Aggiorna il link chiamato 'promo' con una nuova destinazione"
• Visualizzare analytics - "Mostrami i clic 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 - "Iscriviti a https://my-site.com/webhook per ricevere gli eventi di clic"

Iniziare

Il server MCP Linkly ospitato si trova 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, una finestra del browser si apre chiedendoti di accedere a Linkly e approvare l'accesso. Dopo, il tuo assistente rimane connesso.

https://mcp.linklyhq.com

Configurazione

Claude desktop

In Claude Desktop, vai su 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 Connetti sul connettore Linkly. Si apre una scheda del browser per accedere e approvare l'accesso. Claude Desktop rimane quindi connesso — non è necessario alcun file di configurazione o strumento aggiuntivo.

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 in Claude Code, seleziona linkly e autorizza nel browser quando richiesto.

ChatGPT desktop

Apri il tuo file di configurazione 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 di 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.com sia raggiungibile dal tuo computer
• In Claude Code, esegui /mcp e seleziona linkly per riattivare 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 scaduta. Cancella le credenziali memorizzate nella cache e autorizza di nuovo. In Claude Code, esegui /mcp → linkly → riconnettiti. 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 con Claude Desktop
• Integrazione con ChatGPT
• Documentazione dell'API di Linkly
• Linkly CLI
• Webhook
• Model Context Protocol