Server MCP di Linkly

Il Server MCP di Linkly ti consente di connettere assistenti AI al tuo account Linkly usando il Model Context Protocol. Una volta connesso, puoi creare e gestire link brevi attraverso conversazioni naturali.

Che 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.)

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 degli 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 gli eventi di clic"

Guida Introduttiva

Il Server MCP di Linkly ospitato si trova all'indirizzo 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 usi uno strumento di Linkly, si apre una scheda del browser per accedere e approvare l'accesso.

Claude Code (CLI)

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

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

"Could not connect to MCP server"

• Conferma che https://mcp.linklyhq.com sia 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 avviare nuovamente il flusso OAuth

"Authentication failed" / 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 mcp-remote memorizzato nella cache in ~/.mcp-auth/, quindi riavvia.

Gli strumenti non appaiono

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