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"

Aan de slag

De gehoste Linkly MCP Server is bereikbaar op https://mcp.linklyhq.com. Er is niets te installeren en geen API-sleutel om te kopiëren — de server gebruikt OAuth, dus de eerste keer dat je AI-assistent verbinding maakt, opent er een browservenster waarin je wordt gevraagd om in te loggen bij Linkly en toegang goed te keuren. Daarna blijft je assistent verbonden.

https://mcp.linklyhq.com

Configuratie

Claude Desktop

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", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Herstart Claude Desktop. De eerste keer dat je een Linkly-tool gebruikt, opent er een browsertabblad waarin je kunt inloggen en toegang kunt goedkeuren.

Claude Code (CLI)

Claude Code ondersteunt remote MCP-servers standaard. Voeg Linkly toe met één commando:

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

Voer daarna /mcp uit binnen 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 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

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

Probleemoplossing

"Could not connect to MCP server"

  • Bevestig dat https://mcp.linklyhq.com bereikbaar is vanaf je computer
  • Als je client mcp-remote gebruikt, zorg er dan voor dat Node.js v18 of later is geïnstalleerd
  • Voer in Claude Code /mcp uit en kies linkly om de OAuth-flow opnieuw te starten

"Authentication failed" / browser blijft vragen om in te loggen

Wis de gecachte MCP-referenties van je client en autoriseer opnieuw. Voer in Claude Code /mcplinkly → opnieuw verbinden uit. In Claude Desktop: sluit de app af, verwijder het gecachte mcp-remote-token in ~/.mcp-auth/, en start daarna opnieuw op.

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)

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 logt één keer in via de browser en je AI-assistent blijft verbonden. Afgezien van je AI-assistent zelf is er niets te installeren op je computer.

Heb ik een API-sleutel nodig?

Nee. De MCP-server gebruikt OAuth — je logt de eerste keer dat je AI-assistent verbinding maakt in bij Linkly via je browser, en er is nergens een API-sleutel om te kopiëren of te 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 uitsluitend op app.linklyhq.com ingevoerd, en je AI-assistent ziet alleen een toegangstoken dat beperkt is tot je workspace. Het AI-model zelf krijgt je inloggegevens nooit te zien.

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

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

Hoe werk ik de MCP-server bij?

Er is niets bij te werken — we rollen continu verbeteringen uit naar de gehoste server en elke verbonden client krijgt ze automatisch.

Track 500 maandelijkse clicks met alle functies inbegrepen.

Geen creditcard nodig