Linkly MCP Server

Met de Linkly MCP Server kun je AI-assistenten 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 verbinding kunnen maken met externe tools en gegevensbronnen. In plaats van tussen apps heen en weer te kopiëren en plakken, kun je je AI-assistent vragen om acties direct uit te voeren.

Ondersteunde AI-assistenten

De Linkly MCP Server werkt met:

Waar je het vindt

De Linkly MCP Server staat vermeld in de belangrijkste MCP-directories, dus je kunt het installeren vanaf waar je al naar connectors zoekt:

MCP server of de Linkly CLI?

Als je AI-assistent een coding agent is die shell-commando's kan uitvoeren — zoals Claude Code of Cursor — is de Linkly CLI vaak een beter alternatief dan de MCP server. Coding agents zijn al gewend aan het besturen van opdrachtregelprogramma's, en de CLI biedt --json output bij elk commando plus een linkly schema commando dat de volledige commandoboom afdrukt, zodat de agent alles kan ontdekken wat het kan doen. De MCP server blijft de betere keuze voor assistenten die geen shell-commando's kunnen uitvoeren, zoals Claude Desktop en ChatGPT Desktop.

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 bijhouden - "Hoeveel clicks hebben mijn links deze week gehad?"
  • Links beheren - "Werk de link genaamd 'promo' bij met een nieuwe bestemming"
  • Analytics bekijken - "Toon me clicks per land voor de afgelopen 30 dagen"
  • Links zoeken - "Zoek alle links die met de productlancering te maken hebben"
  • Domeinen beheren - "Vermeld mijn aangepaste domeinen"
  • Webhooks instellen - "Abonneer https://my-site.com/webhook om clickgebeurtenissen te ontvangen"

Aan de slag

De gehoste Linkly MCP Server bevindt zich op https://mcp.linklyhq.com. Er is niets te installeren en geen API-sleutel om te kopiëren — de server gebruikt OAuth, dus wanneer je AI-assistent voor het eerst verbinding maakt, wordt er een browservenster geopend waarin je wordt gevraagd je aan te melden bij Linkly en toegang goed te keuren. Daarna blijft je assistent verbonden.

https://mcp.linklyhq.com

Configuratie

Claude desktop

In Claude Desktop ga je naar Settings → Connectors → Add custom connector. Voer een naam in (Linkly) en de externe MCP server-URL:

https://mcp.linklyhq.com

Klik op Add, vervolgens op Connect op de Linkly connector. Er opent een browsertabblad waarin je kunt aanmelden en toegang kunt goedkeuren. Claude Desktop blijft dan verbonden — geen configuratiebestand of extra tooling nodig.

Claude code (CLI)

Claude Code ondersteunt externe MCP servers natively. Voeg Linkly toe met één commando:

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

Voer vervolgens /mcp uit in Claude Code, kies linkly en autoriseer in de browser wanneer daarom wordt gevraagd.

ChatGPT desktop

Open je ChatGPT configuratiebestand:

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

Voeg de Linkly MCP server toe:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Beschikbare tools

ToolBeschrijving
create_linkMaak een nieuwe korte link met optionele UTM-parameters, pixels en meer
update_linkWerk de instellingen van een bestaande link bij
delete_linkVerwijder een link
get_linkHaal details op van een specifieke link
list_linksVermeld alle links in je workspace
search_linksZoek links op naam, URL of notitie
get_clicksHaal recente clickgegevens op
get_analyticsHaal tijdsreeksclickgegevens op voor grafieken
get_analytics_byHaal clicks gegroepeerd op land, browser, platform, etc.
list_domainsVermeld je aangepaste domeinen
list_webhooksVermeld workspace webhook-abonnementen
subscribe_webhookAbonneer een URL om clickgebeurtenissen te ontvangen

Bij het maken van links kun je opgeven:

  • 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
  • Verloop: expiry_datetime, expiry_destination
  • Je eigen gegevens: metadata, sleutel-waardeparen zoals ID's van je systeem. Deze worden geretourneerd met de link en opgenomen in webhook-payloads. Zie link metadata

Probleemoplossing

"Could not connect to MCP server"

  • Bevestig dat https://mcp.linklyhq.com bereikbaar is van je machine
  • In Claude Code voer je /mcp uit en kies je linkly om de OAuth-stroom opnieuw te starten

"Authentication failed", "invalid_client", of browser blijft vragen om aan te melden

Dit betekent dat je client een verouderde verbindingsregistratie bevat. Wis de gecachete referenties en autoriseer opnieuw. In Claude Code voer je /mcp → linkly → herverbinding uit. In Claude Desktop verwijder je de Linkly connector onder Settings → Connectors en voeg je deze opnieuw toe, waarna je je opnieuw aanmeldt.

Tools verschijnen niet

  • Start je AI-assistent opnieuw op nadat je de configuratie hebt opgeslagen
  • 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)

Gerelateerde bronnen

MCP server veelgestelde vragen

Moet ik iets installeren om de MCP server te gebruiken?

Nee. De gehoste server op https://mcp.linklyhq.com gebruikt OAuth — je meldt je eenmaal in de browser aan en je AI-assistent blijft verbonden. Er is geen software om op je machine te installeren naast je AI-assistent zelf.

Heb ik een API-sleutel nodig?

Nee. De MCP server gebruikt OAuth — je meldt je voor het eerst in Linkly aan via je browser wanneer je AI-assistent verbinding maakt, en er is geen API-sleutel om ergens te kopiëren of plakken.

Welke AI-assistenten ondersteunen MCP?

Claude Desktop, Claude Code (CLI) en ChatGPT Desktop ondersteunen allemaal MCP. Andere tools zoals Cursor en Windsurf hebben ook MCP-ondersteuning.

Is mijn account veilig?

Ja. De gehoste server gebruikt OAuth 2.1 met PKCE — je Linkly-wachtwoord wordt alleen ingevoerd op app.linklyhq.com, en je AI-assistent ziet alleen een toegangstoken met het bereik van je workspace. Het AI-model zelf ziet je referenties nooit.

Respecteert de MCP-server mijn rol in de workspace?

Ja. Je AI-assistent kan doen wat je rol toestaat en niets meer. Als je de Read-rol hebt, kan het links en analytics opzoeken, maar kan het niets maken, bewerken of verwijderen.

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

Nee, MCP vereist de desktoptoepassingen of de Claude Code CLI. De webversies ondersteunen geen MCP-verbindingen.

Hoe werk ik de MCP server bij?

Er is niets om bij te werken — we implementeren voortdurend verbeteringen op de gehoste server en elke verbonden client krijgt ze automatisch.

Beschikbaarheid per plan

Beschikbaar vanaf Pro

Plannen vergelijken →

Track 500 maandelijkse klikken gratis.