Linkly MCP Server

Met de Linkly MCP Server kun je AI-assistenten verbinden met je Linkly-account met behulp van 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 worden verbonden met externe tools en gegevensbronnen. In plaats van heen en weer te kopiëren tussen apps, 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 Linkly CLI?

Als je AI-assistent een codeeringsagent is die shell-opdrachten kan uitvoeren — zoals Claude Code of Cursor — is de Linkly CLI vaak een betere keuze dan de MCP-server. Codeersagenten zijn al gewend om opdrachtregelhulpmiddelen te gebruiken, en de CLI geeft hen --json-uitvoer op elke opdracht plus een linkly schema-opdracht die de volledige opdrachtstructuur 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

Zodra verbonden, kun je je AI-assistent vragen om:

• Korte links maken - "Maak een korte link voor https://example.com"
• Prestaties volgen - "Hoeveel klikken hebben mijn links deze week gekregen?"
• Links beheren - "Werk de link genaamd 'promo' bij met een nieuwe bestemming"
• Analytics bekijken - "Toon me klikken 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 klikgebeurtenissen 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 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 op. 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 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 kunt je opgeven:

• Standaard: 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 geen verbinding maken met MCP-server"

• Controleer of https://mcp.linklyhq.com bereikbaar is van 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 selecteer linkly om de OAuth-stroom opnieuw te activeren

"Verificatie mislukt" / browser blijft om aanmelding vragen

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

Tools verschijnen niet

• Start je AI-assistent opnieuw op nadat je de configuratie hebt opgeslagen
• Controleer dat de JSON-syntaxis in je configuratiebestand geldig is
• Controleer dat de MCP-server actief is (zoek naar het toolspictogram in je assistent)

Gerelateerde bronnen

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