Server MCP Linkly

Il Server MCP 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 una conversazione naturale.

Cos'è MCP?

Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti AI di connettersi in modo sicuro a strumenti esterni e fonti di dati. 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:

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 le analisi - "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 eventi di clic"

Per Iniziare

Il Server MCP Linkly ospitato è disponibile 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 aprirà una finestra del browser che ti chiederà di accedere a Linkly e autorizzare l'accesso. Dopodiché, il tuo assistente resta 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 aprirà una scheda del browser per accedere e autorizzare l'accesso.

Claude Code (CLI)

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

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

Poi esegui /mcp dentro 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

StrumentoDescrizione
create_linkCrea un nuovo link breve con parametri UTM opzionali, pixel e altro
update_linkAggiorna le impostazioni di un link esistente
delete_linkElimina un link
get_linkOttieni i dettagli di un link specifico
list_linksElenca tutti i link nel tuo workspace
search_linksCerca link per nome, URL o nota
get_clicksOttieni i dati recenti sui clic
get_analyticsOttieni dati sui clic in serie temporali per i grafici
get_analytics_byOttieni clic raggruppati per paese, browser, piattaforma, ecc.
list_domainsElenca i tuoi domini personalizzati
list_webhooksElenca le sottoscrizioni webhook del workspace
subscribe_webhookSottoscrivi un URL per ricevere eventi di clic

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 dalla tua macchina
  • Se il tuo client usa mcp-remote, assicurati di avere Node.js v18 o successivo installato
  • In Claude Code, esegui /mcp e seleziona linkly per riattivare il flusso OAuth

"Autenticazione fallita" / il browser continua a chiedere l'accesso

Cancella le credenziali MCP memorizzate dal tuo client e riautorizza. In Claude Code, esegui /mcplinkly → riconnetti. In Claude Desktop, chiudi l'app, elimina il token mcp-remote memorizzato in ~/.mcp-auth/, quindi riavvia.

Strumenti non visualizzati

  • Riavvia il tuo assistente AI dopo aver salvato la configurazione
  • Controlla 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

FAQ Server MCP

Devo installare qualcosa per usare il server MCP?

No. Il server ospitato su https://mcp.linklyhq.com utilizza OAuth: accedi una volta nel browser e il tuo assistente AI resta connesso. Non c'è nulla da installare sulla tua macchina oltre al tuo assistente AI stesso.

Serve una chiave API?

No. Il server MCP utilizza OAuth: accedi a Linkly tramite il browser la prima volta che il tuo assistente AI si connette, e non c'è alcuna chiave API da copiare o incollare.

Quali assistenti AI supportano MCP?

Claude Desktop, Claude Code (CLI) e ChatGPT Desktop supportano tutti MCP. Anche altri strumenti come Cursor e Windsurf hanno supporto MCP.

Il mio account è sicuro?

Sì. Il server ospitato utilizza OAuth 2.1 con PKCE: la tua password Linkly viene inserita solo su app.linklyhq.com, e il tuo assistente AI vede unicamente un token di accesso limitato al tuo workspace. Il modello AI stesso non vede mai le tue credenziali.

Posso usare MCP con le versioni web di Claude o ChatGPT?

No, MCP richiede le applicazioni desktop o la CLI di Claude Code. Le versioni web non supportano le connessioni MCP.

Come aggiorno il server MCP?

Non c'è nulla da aggiornare: rilasciamo miglioramenti continui al server ospitato e ogni client connesso li riceve automaticamente.

Monitora 500 clic mensili con tutte le funzioni incluse.

Nessuna carta di credito richiesta