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 consente 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 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 del server MCP. Gli agenti di codifica sono già abituati a guidare strumenti da riga di comando, e la CLI offre 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 quello 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 analitiche - "Mostrami i clic per paese negli ultimi 30 giorni"
• Cercare link - "Trova tutti i link relativi al lancio del prodotto"
• Gestire domini - "Elenca i miei domini personalizzati"
• Configurare webhook - "Sottoscrivi https://my-site.com/webhook per ricevere eventi di clic"

Iniziare

Il server MCP di Linkly ospitato si trova in 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 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 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 dei link

Durante la creazione dei 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 connettersi 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 riattivare il flusso OAuth

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

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

Gli strumenti non compaiono

• 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 di Linkly
• Linkly CLI
• Webhook
• Model Context Protocol