Linkly MCP Server

De Linkly MCP Server stelt je in staat om AI-assistenten met je Linkly-account te verbinden met behulp van het Model Context Protocol. Zodra verbonden, kun je korte links maken en beheren door middel van 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 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:

• 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 gebruik van command-line tools, en de CLI biedt --json output op elk commando plus een linkly schema commando dat de volledige command tree weergeeft, 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 bijhouden - "Hoeveel clicks hebben mijn links deze week gekregen?"
• Links beheren - "Werk de link genaamd 'promo' bij met een nieuw doel"
• Analytics bekijken - "Toon me clicks per land voor de afgelopen 30 dagen"
• Links zoeken - "Zoek alle links met betrekking tot de productlancering"
• Domeinen beheren - "Geef mijn aangepaste domeinen weer"
• 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 in te stellen 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

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"]
    }
  }
}

Start Claude Desktop opnieuw. De eerste keer dat je een Linkly-tool gebruikt, opent een browser-tabblad zodat je je kunt aanmelden en toegang kunt goedkeuren.

Claude Code (CLI)

Claude Code ondersteunt remote MCP-servers ingebouwd. 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 als 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

Opties voor het maken van links

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

Probleemoplossing

"Kon niet verbinding maken met MCP-server"

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

"Verificatie mislukt" / browser blijft vragen om aan te melden

Wis de MCP-referenties in de cache van je client en autoriseer opnieuw. Voer in Claude Code /mcp → linkly → opnieuw verbinden uit. In Claude Desktop sluit je de app, verwijdert je de cached mcp-remote token in ~/.mcp-auth/ en start je het programma opnieuw.

Tools verschijnen niet

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

Gerelateerde bronnen

• Claude Desktop-integratie
• ChatGPT-integratie
• Linkly API-documentatie
• Linkly CLI
• Webhooks
• Model Context Protocol