Server MCP Linkly

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

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.

Il Server MCP Linkly funziona con:

• Claude Desktop
• ChatGPT Desktop
• Altri client compatibili con MCP (Cursor, Windsurf, ecc.)

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 link - "Aggiorna il link chiamato 'promo' con una nuova destinazione"
• Visualizzare analisi - "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 - "Iscriviti https://my-site.com/webhook per ricevere eventi di clic"

Il Server MCP Linkly è disponibile in due modi:

Usa il nostro server MCP ospitato - nessuna installazione richiesta:

https://mcp.linklyhq.com

Installa ed esegui localmente utilizzando npx:

npx -y linkly-mcp-server

Oppure installa globalmente:

npm install -g linkly-mcp-server

Visualizza il pacchetto su npm.

1. 1Accedi alla tua dashboard Linkly
2. 2Vai su Impostazioni → Chiavi API
3. 3Copia la tua Chiave API e l'ID Workspace

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", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

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:

Usando npx:

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

Usando il server ospitato:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

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
• Avanzato: cloaking, forward_params, block_bots, hide_referrer
• Scadenza: expiry_datetime, expiry_destination

• Verifica che la tua chiave API e l'ID Workspace siano corretti
• Assicurati di avere Node.js installato (v18 o successiva)
• Prova a eseguire npx linkly-mcp-server in un terminale per vedere eventuali errori

• Verifica la tua chiave API nella dashboard Linkly in Impostazioni → Chiavi API
• Assicurati che non ci siano spazi extra nelle tue credenziali
• Prova a rigenerare la tua chiave API

• 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)

• Conferma che il percorso del comando sia corretto
• Se usi il server ospitato, controlla la tua connessione internet
• Verifica che il server MCP funzioni manualmente dal terminale

• Integrazione Claude Desktop
• Integrazione ChatGPT
• Documentazione API Linkly
• Webhook
• Server MCP su npm
• Model Context Protocol