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 korte 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 acties direct 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:

  • Korte links maken - "Maak een korte link voor https://example.com"
  • Prestaties volgen - "Hoeveel clicks hebben mijn links deze week gekregen?"
  • Links beheren - "Update de link genaamd 'promo' met een nieuwe bestemming"
  • Analytics bekijken - "Toon me clicks per land voor de laatste 30 dagen"
  • Links zoeken - "Vind alle links gerelateerd aan de productlancering"
  • Domeinen beheren - "Lijst mijn aangepaste domeinen"
  • Webhooks instellen - "Abonneer https://my-site.com/webhook om click-gebeurtenissen 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 draai lokaal met npx:

npx -y linkly-mcp-server

Of installeer globaal:

npm install -g linkly-mcp-server

Bekijk het pakket op npm.

Configuratie

Je API-inloggegevens 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": "jouw-api-sleutel",
        "LINKLY_WORKSPACE_ID": "jouw-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:

Met npx:

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

Met gehoste server:

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

Beschikbare Tools

ToolBeschrijving
create_linkMaak een nieuwe korte link met optionele UTM-parameters, pixels en meer
update_linkUpdate de instellingen van een bestaande link
delete_linkVerwijder een link
get_linkVerkrijg details van een specifieke link
list_linksLijst alle links in je workspace
search_linksZoek links op naam, URL of notitie
get_clicksVerkrijg recente click-gegevens
get_analyticsVerkrijg tijdreeks click-gegevens voor grafieken
get_analytics_byVerkrijg clicks gegroepeerd per land, browser, platform, enz.
list_domainsLijst je aangepaste domeinen
list_webhooksLijst workspace webhook-abonnementen
subscribe_webhookAbonneer een URL om click-gebeurtenissen te ontvangen

Opties voor het maken van links

Bij het maken van links kun je het volgende 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 hebben dit nodig)

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 inloggegevens staan
  • Probeer je API-sleutel opnieuw te genereren

Tools verschijnen niet

  • Start je AI-assistent opnieuw op na het opslaan van de configuratie
  • Controleer of de JSON-syntax in je configuratiebestand geldig is
  • Verifieer dat de MCP-server draait (controleer het tools-icoon in je assistent)

Server niet bereikbaar

  • Bevestig dat het commando-pad correct is
  • Als je de gehoste server gebruikt, controleer dan je internetverbinding
  • Verifieer dat de MCP-server handmatig draait vanuit de terminal

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 desktoptoepassingen. De webversies ondersteunen geen MCP-verbindingen.

Hoe update ik de MCP-server?

Als je npx gebruikt, haalt het automatisch de nieuwste versie op elke keer. Als je globaal hebt geïnstalleerd, voer dan npm update -g linkly-mcp-server uit.

Track 1000 monthly clicks with all features included.

No credit card required