Server MCP Linkly

Il Server MCP 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 conversazioni naturali.

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 azioni direttamente.

Assistenti AI supportati

Il Server MCP 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 rispetto al server MCP. Gli agenti di codifica hanno già familiarità con l'utilizzo di 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, così l'agente può 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"
• 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 analitiche - "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/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, 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 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 Linkly:

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

Strumenti disponibili

Opzioni di creazione dei link

Quando crei link, puoi specificare:

• Informazioni di 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
• 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 memorizzate nella cache del tuo client e autorizza di nuovo. In Claude Code, esegui /mcp → linkly → riconnessione. In Claude Desktop, chiudi l'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 l'icona degli strumenti nel tuo assistente)

Risorse correlate

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