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. 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 verbinding maken met externe tools en gegevensbronnen. In plaats van kopiëren en plakken tussen apps, kun je je AI-assistent vragen 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-opdrachten kan uitvoeren — zoals Claude Code of Cursor — is de Linkly CLI vaak beter geschikt dan de MCP-server. Coding agents zijn al gewend aan command-line tools, en de CLI geeft hen --json-uitvoer op elke opdracht plus een linkly schema-opdracht die de volledige opdrachtboom afdrukt, zodat de agent alles kan ontdekken wat het kan doen. De MCP-server blijft de betere keuze voor assistenten die geen shell-opdrachten 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 clicks hebben mijn links deze week gehad?"
• Links beheren - "Update de link genaamd 'promo' 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 lijst van mijn aangepaste domeinen"
• Webhooks instellen - "Abonneer https://my-site.com/webhook om klik-gebeurtenissen 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 waar 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 van nature. Voeg Linkly toe met één opdracht:

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

Voer vervolgens /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 linkmaking

Bij het maken van links kun je het volgende opgeven:

• Basisch: 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
• Als je client mcp-remote gebruikt, zorg ervoor dat Node.js v18 of hoger is geïnstalleerd
• Voer in Claude Code /mcp uit en selecteer linkly om de OAuth-stroom opnieuw te activeren

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

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

Tools worden niet weergegeven

• Start je AI-assistent opnieuw op na het opslaan van de configuratie
• Controleer of de JSON-syntaxis in je configuratiebestand geldig is
• Verifieer dat 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