Linkly MCP Server

Met de Linkly MCP Server kun je AI-assistenten verbinden met je Linkly-account via het Model Context Protocol. Zodra verbonden, 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 tussen apps te kopiëren en plakken, kun je je AI-assistent vragen om acties rechtstreeks uit te voeren.

Ondersteunde AI-assistenten

De Linkly MCP Server werkt met:

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

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 beter geschikt dan de MCP server. Coding agents zijn al gewend aan het gebruiken van command-line tools, en de CLI geeft --json output voor elk commando plus een linkly schema commando dat de volledige commandostructuur 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

Zodra 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 ontvangen?"
• Links beheren - "Werk de link genaamd 'promo' bij met een nieuwe bestemming"
• Analytics bekijken - "Toon me clicks per land van de afgelopen 30 dagen"
• Links zoeken - "Vind alle links met betrekking tot de productlancering"
• Domeinen beheren - "Geef een overzicht van mijn custom domeinen"
• Webhooks instellen - "Abonneer https://my-site.com/webhook om click-events 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 wanneer je AI-assistent voor het eerst verbinding maakt, opent een browservenster waarin je wordt gevraagd om in te loggen op 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 (Linkly) en de externe MCP server URL in:

https://mcp.linklyhq.com

Klik op Add en vervolgens Connect op de Linkly connector. Een browsertabblad opent om je in te loggen en toegang goed te keuren. Claude Desktop blijft dan verbonden — geen config bestand of extra tools nodig.

Claude code (CLI)

Claude Code ondersteunt externe MCP servers standaard. 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 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 linkmaking

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

"Kan geen verbinding maken met MCP server"

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

"Verificatie mislukt", "invalid_client" of browser blijft vragen om in te loggen

Dit betekent dat je client een verouderde verbindingsregistratie heeft. Wis de cached referenties en autoriseer opnieuw. In Claude Code voer je /mcp → linkly → opnieuw verbinden uit. In Claude Desktop verwijder je de Linkly connector onder Settings → Connectors en voeg je deze opnieuw toe, sign dan opnieuw in.

Tools verschijnen niet

• Start je AI-assistent opnieuw na het opslaan van de configuratie
• Controleer of de JSON-syntaxis in je configuratiebestand geldig is
• Controleer of de MCP server wordt uitgevoerd (controleer op het tools-pictogram in je assistent)

Gerelateerde bronnen

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