Linkly MCP Server

De Linkly MCP Server laat je AI-assistenten met je Linkly-account verbinden via het Model Context Protocol. Eenmaal verbonden kun je korte links maken en beheren via natuurlijk spreken.

Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard die AI-assistenten in staat stelt veilig verbinding te maken met externe tools en gegevensbronnen. In plaats van kopiëren en plakken tussen apps, kun je je AI-assistent vragen 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.)

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 volgen - "Hoeveel clicks hebben mijn links deze week gekregen?"
• Links beheren - "Werk de link 'promo' bij met een nieuwe bestemming"
• Analytics bekijken - "Toon me clicks per land voor de afgelopen 30 dagen"
• Links zoeken - "Zoek alle links met betrekking tot de productlancering"
• Domeinen beheren - "Vermeld mijn aangepaste 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 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 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 browsertabblad zodat je je kunt aanmelden en toegang kunt goedkeuren.

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

Opties voor linkcreatie

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

Probleemoplossing

"Could not connect to 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 schakelen

"Authentication failed" / browser blijft vragen om aan te melden

Wis de gecachete MCP-referenties van je client en autoriseer opnieuw. Voer in Claude Code /mcp → linkly → opnieuw verbinden uit. Sluit de app in Claude Desktop af, verwijder het gecachete mcp-remote-token in ~/.mcp-auth/ en start opnieuw.

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 wordt uitgevoerd (controleer op het pictogram tools in je assistent)

Gerelateerde resources

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