Server MCP di Linkly

Il Server MCP di Linkly ti permette di connettere assistenti AI al tuo account Linkly utilizzando il Model Context Protocol. Una volta connesso, puoi creare e gestire link brevi attraverso conversazione naturale.

Cos'è MCP?

Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti AI di connettersi in modo sicuro a strumenti e fonti di dati esterni. Invece di copiare e incollare tra app, puoi chiedere al tuo assistente AI di eseguire 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 CLI di Linkly?

Se il tuo assistente AI è un agente di coding che può eseguire comandi shell — come Claude Code o Cursor — la CLI di Linkly è spesso una scelta migliore rispetto al server MCP. Gli agenti di coding hanno già familiarità con l'utilizzo di strumenti da riga di comando, e la CLI offre output --json su ogni comando più un comando linkly schema che stampa l'intero albero di comandi, così l'agente può scoprire tutto quello che può fare. Il server MCP rimane la scelta migliore per 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 l'analitca - "Mostrami i clic per paese degli ultimi 30 giorni"
• Cercare link - "Trova tutti i link correlati al lancio del prodotto"
• Gestire domini - "Elenca i miei domini personalizzati"
• Configurare webhook - "Sottoscrivi https://my-site.com/webhook per ricevere eventi di clic"

Per iniziare

Il Server MCP di 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, si apre una finestra del browser che ti chiede di accedere a Linkly e approvare l'accesso. Dopo di che, il tuo assistente rimane 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 di Linkly:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Riavvia Claude Desktop. La prima volta che utilizzi uno strumento di Linkly, si apre una scheda del browser per accedere e approvare l'accesso.

Claude code (CLI)

Claude Code supporta nativamente i server MCP remoti. 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 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 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

"Non è stato possibile connettere al server MCP"

• Conferma che https://mcp.linklyhq.com è raggiungibile dalla tua macchina
• Se il tuo client utilizza mcp-remote, assicurati che Node.js v18 o versione successiva sia installato
• In Claude Code, esegui /mcp e seleziona linkly per riavviare il flusso OAuth

"Autenticazione non riuscita" / il browser continua a chiedere di accedere

Cancella le credenziali MCP in cache del tuo client e autorizza di nuovo. In Claude Code, esegui /mcp → linkly → riconnetti. In Claude Desktop, esci dall'app, elimina il token mcp-remote memorizzato nella cache in ~/.mcp-auth/, quindi riavvia.

Gli strumenti non vengono visualizzati

• Riavvia il tuo assistente AI dopo aver salvato la configurazione
• Verifica che la sintassi JSON nel file di configurazione sia valida
• Verifica che il server MCP sia in esecuzione (controlla la presenza dell'icona degli strumenti nel tuo assistente)

Risorse correlate

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