Linkly MCP Server

Met de Linkly MCP Server kun je AI-assistenten verbinden met je Linkly-account met behulp van het Model Context Protocol. Na verbinding kun je korte links maken en beheren via natuurlijke conversatie.

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 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:

• Claude Desktop
• ChatGPT Desktop
• Andere MCP-compatibele clients (Cursor, Windsurf, enz.)

Waar je het kunt vinden

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

• Claude connector directory — eenmalige verbinding in Claude (web en Desktop)
• Officieel MCP-register — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — de Linkly-plugin voor Claude Code en Cowork
• Source op GitHub — MIT-licentie

MCP-server of de Linkly CLI?

Als je AI-assistent een codageragent is die shell-commando's kan uitvoeren — zoals Claude Code of Cursor — is de Linkly CLI vaak beter geschikt dan de MCP-server. Codeagenten kunnen al goed overweg met opdrachtregelprogramma's, en de CLI biedt --json-output op elk commando plus een linkly schema-commando dat de volledige opdrachtstructuur afdrukt, zodat de agent kan ontdekken wat het allemaal 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

Na verbinding kun je je AI-assistent vragen om:

• Korte links maken - "Maak een korte link voor https://example.com"
• Prestaties bijhouden - "Hoeveel klikken hebben mijn links deze week gekregen?"
• Links beheren - "Update de link genaamd 'promo' met een nieuwe bestemming"
• Analytics bekijken - "Toon me klikken per land voor de afgelopen 30 dagen"
• Links zoeken - "Vind alle links met betrekking tot de productlancering"
• Domeinen beheren - "Geef een overzicht van mijn aangepaste domeinen"
• Webhooks instellen - "Abonneer https://my-site.com/webhook om klikgebeurtenissen te ontvangen"

Aan de slag

De gehoste Linkly MCP Server bevindt zich op https://mcp.linklyhq.com. Er is niets om 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 een browservenster waarin je wordt gevraagd om 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 Connect op de Linkly-connector. Een browsertabblad opent zodat je je kunt aanmelden en toegang kunt goedkeuren. Claude Desktop blijft vervolgens verbonden — geen configuratiebestand of extra tooling nodig.

Claude code (CLI)

Claude Code ondersteunt externe MCP-servers van nature. Voeg Linkly toe met één commando:

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

Voer /mcp uit in Claude Code, selecteer linkly en autoriseer in de browser wanneer hierom 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

Opties voor link-creatie

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
• Vervaldatum: expiry_datetime, expiry_destination

Problemen oplossen

"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 selecteer je linkly om de OAuth-flow opnieuw in gang te zetten

"Authentication failed", "invalid_client", of browser vraagt steeds om aanmelden

Dit betekent dat je client een verouderde verbindingsregistratie vast heeft. Wis de in het cachegeheugen opgeslagen inloggegevens en autoriseer opnieuw. In Claude Code voer je /mcp → linkly → reconnect uit. In Claude Desktop verwijder je de Linkly-connector onder Settings → Connectors en voeg je deze opnieuw toe, en meld je je vervolgens opnieuw aan.

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
• Controleer of de MCP-server actief is (controleer op het toolspictogram in je assistent)

Gerelateerde bronnen

• Claude Desktop Integration
• ChatGPT Integration
• Linkly API Documentation
• Linkly CLI
• Webhooks
• Model Context Protocol