Linkly MCP Server

De Linkly MCP Server stelt je in staat om AI-assistenten te verbinden met je Linkly-account via het Model Context Protocol. Eenmaal verbonden kun je verkorte links maken en beheren via natuurlijk gesprek.

Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten veilig kunnen verbinden met externe tools en gegevensbronnen. In plaats van te kopiëren en plakken tussen apps, kun je je AI-assistent vragen om direct acties uit te voeren.

Ondersteunde AI-assistenten

De Linkly MCP Server werkt met:

Wat je kunt doen

Eenmaal verbonden kun je je AI-assistent vragen om:

  • Verkorte links maken - "Maak een verkorte link voor https://example.com"
  • Prestaties volgen - "Hoeveel kliks hebben mijn links deze week gekregen?"
  • Links beheren - "Werk de link genaamd 'promo' bij met een nieuwe bestemming"
  • Analyses bekijken - "Toon me kliks per land voor de laatste 30 dagen"
  • Links zoeken - "Vind alle links gerelateerd aan de productlancering"
  • Domeinen beheren - "Toon mijn aangepaste domeinen"
  • Webhooks instellen - "Abonneer https://my-site.com/webhook om klikgebeurtenissen te ontvangen"

Installatieopties

De Linkly MCP Server is op twee manieren beschikbaar:

Optie 1: Gehoste server (aanbevolen)

Gebruik onze gehoste MCP-server - geen installatie vereist:

https://mcp.linklyhq.com

Optie 2: npm-pakket

Installeer en voer lokaal uit met npx:

npx -y linkly-mcp-server

Of installeer globaal:

npm install -g linkly-mcp-server

Bekijk het pakket op npm.

Configuratie

Je API-referenties verkrijgen

  1. 1Log in op je Linkly-dashboard
  2. 2Ga naar Instellingen → API-sleutels
  3. 3Kopieer je API-sleutel en Workspace-ID

Claude Desktop-configuratie

Open je Claude Desktop-configuratiebestand:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Voeg de Linkly MCP-server toe:

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

ChatGPT Desktop-configuratie

Open je ChatGPT-configuratiebestand:

  • macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
  • Windows: %APPDATA%\ChatGPT\mcp_servers.json

Voeg de Linkly MCP-server toe:

Gebruik npx:

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

Gebruik gehoste server:

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

Beschikbare tools

ToolBeschrijving
create_linkMaak een nieuwe verkorte link met optionele UTM-parameters, pixels en meer
update_linkWerk de instellingen van een bestaande link bij
delete_linkVerwijder een link
get_linkVerkrijg details van een specifieke link
list_linksToon alle links in je workspace
search_linksZoek links op naam, URL of notitie
get_clicksVerkrijg recente klikgegevens
get_analyticsVerkrijg tijdreeks-klikgegevens voor grafieken
get_analytics_byVerkrijg kliks gegroepeerd per land, browser, platform, etc.
list_domainsToon je aangepaste domeinen
list_webhooksToon workspace webhook-abonnementen
subscribe_webhookAbonneer een URL om klikgebeurtenissen te ontvangen

Opties voor het maken van links

Bij het maken van links kun je specificeren:

  • Basis: url, name, note, domain, slug, enabled
  • UTM-parameters: utm_source, utm_medium, utm_campaign, utm_term, utm_content
  • Open Graph: og_title, og_description, og_image
  • Tracking: fb_pixel_id, ga4_tag_id, gtm_id
  • Geavanceerd: cloaking, forward_params, block_bots, hide_referrer
  • Vervaldatum: expiry_datetime, expiry_destination

Omgevingsvariabelen

VariabeleVereistBeschrijving
LINKLY_API_KEYJaJe Linkly API-sleutel
LINKLY_WORKSPACE_IDNeeJe workspace-ID (sommige clients vereisen dit)

Probleemoplossing

"Could not connect to MCP server"

  • Controleer of je API-sleutel en Workspace-ID correct zijn
  • Zorg ervoor dat je Node.js hebt geïnstalleerd (v18 of later)
  • Probeer npx linkly-mcp-server in een terminal uit te voeren om eventuele fouten te zien

"Authentication failed"

  • Verifieer je API-sleutel in het Linkly-dashboard bij Instellingen → API-sleutels
  • Zorg ervoor dat er geen extra spaties in je referenties zitten
  • Probeer je API-sleutel opnieuw te genereren

Tools verschijnen niet

  • Herstart je AI-assistent na het opslaan van de configuratie
  • Controleer of de JSON-syntaxis in je configuratiebestand geldig is
  • Verifieer dat de MCP-server actief is (controleer op het tools-pictogram in je assistent)

Server is niet bereikbaar

  • Bevestig dat het commandopad correct is
  • Als je de gehoste server gebruikt, controleer je internetverbinding
  • Verifieer dat de MCP-server handmatig vanuit de terminal werkt

Gerelateerde bronnen

MCP Server veelgestelde vragen

Moet ik iets installeren om de MCP-server te gebruiken?

Niet als je de gehoste server op https://mcp.linklyhq.com gebruikt. Als je liever lokaal draait, heb je Node.js v18 of later nodig.

Welke AI-assistenten ondersteunen MCP?

Claude Desktop en ChatGPT Desktop ondersteunen beide MCP. Andere tools zoals Cursor en Windsurf hebben ook MCP-ondersteuning.

Is mijn API-sleutel veilig?

Ja. Je API-sleutel wordt lokaal opgeslagen in het configuratiebestand van je AI-assistent en wordt alleen naar de servers van Linkly verzonden bij het maken van API-verzoeken. Het wordt nooit gedeeld met het AI-model zelf.

Kan ik MCP gebruiken met de webversies van Claude of ChatGPT?

Nee, MCP vereist de desktopapplicaties. De webversies ondersteunen geen MCP-verbindingen.

Hoe werk ik de MCP-server bij?

Bij gebruik van npx wordt automatisch de nieuwste versie opgehaald. Als je deze globaal hebt geïnstalleerd, voer dan npm update -g linkly-mcp-server uit.

Volg 500 maandelijkse klikken met alle functies inbegrepen.

Geen creditcard nodig