Linkly MCP Server
De Linkly MCP Server stelt je in staat om AI-assistenten te verbinden met je Linkly-account via het Model Context Protocol. Eenmaal verbonden kun je verkorte links maken en beheren via natuurlijk gesprek.
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 te kopiëren en plakken tussen apps, kun je je AI-assistent vragen om direct acties uit te voeren.
Ondersteunde AI-assistenten
De Linkly MCP Server werkt met:
- Claude Desktop
- ChatGPT Desktop
- Andere MCP-compatibele clients (Cursor, Windsurf, etc.)
Wat je kunt doen
Eenmaal verbonden kun je je AI-assistent vragen om:
- Verkorte links maken - "Maak een verkorte link voor https://example.com"
- Prestaties volgen - "Hoeveel kliks hebben mijn links deze week gekregen?"
- Links beheren - "Werk de link genaamd 'promo' bij met een nieuwe bestemming"
- Analyses bekijken - "Toon me kliks per land voor de laatste 30 dagen"
- Links zoeken - "Vind alle links gerelateerd aan de productlancering"
- Domeinen beheren - "Toon mijn aangepaste domeinen"
- Webhooks instellen - "Abonneer
https://my-site.com/webhookom klikgebeurtenissen te ontvangen"
Aan de slag
De gehoste Linkly MCP Server is bereikbaar 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 er een browservenster waarin je wordt gevraagd om in te loggen 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"]
}
}
}
Herstart Claude Desktop. De eerste keer dat je een Linkly-tool gebruikt, opent er een browsertabblad waarin je kunt inloggen en toegang kunt goedkeuren.
Claude Code (CLI)
Claude Code ondersteunt remote MCP-servers standaard. Voeg Linkly toe met één commando:
claude mcp add --transport http linkly https://mcp.linklyhq.com
Voer daarna /mcp uit binnen 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
| Tool | Beschrijving |
|---|---|
create_link | Maak een nieuwe verkorte link met optionele UTM-parameters, pixels en meer |
update_link | Werk de instellingen van een bestaande link bij |
delete_link | Verwijder een link |
get_link | Verkrijg details van een specifieke link |
list_links | Toon alle links in je workspace |
search_links | Zoek links op naam, URL of notitie |
get_clicks | Verkrijg recente klikgegevens |
get_analytics | Verkrijg tijdreeks-klikgegevens voor grafieken |
get_analytics_by | Verkrijg kliks gegroepeerd per land, browser, platform, etc. |
list_domains | Toon je aangepaste domeinen |
list_webhooks | Toon workspace webhook-abonnementen |
subscribe_webhook | Abonneer een URL om klikgebeurtenissen te ontvangen |
Opties voor het maken van links
Bij het maken van links kun je specificeren:
- 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
"Could not connect to MCP server"
- Bevestig dat
https://mcp.linklyhq.combereikbaar is vanaf je computer - Als je client
mcp-remotegebruikt, zorg er dan voor dat Node.js v18 of later is geïnstalleerd - Voer in Claude Code
/mcpuit en kies linkly om de OAuth-flow opnieuw te starten
"Authentication failed" / browser blijft vragen om in te loggen
Wis de gecachte MCP-referenties van je client en autoriseer opnieuw. Voer in Claude Code /mcp → linkly → opnieuw verbinden uit. In Claude Desktop: sluit de app af, verwijder het gecachte mcp-remote-token in ~/.mcp-auth/, en start daarna opnieuw op.
Tools verschijnen niet
- Herstart je AI-assistent na het opslaan van de configuratie
- Controleer of de JSON-syntaxis in je configuratiebestand geldig is
- Verifieer dat de MCP-server actief is (controleer op het tools-pictogram in je assistent)
Gerelateerde bronnen
MCP Server veelgestelde vragen
Moet ik iets installeren om de MCP-server te gebruiken?
Nee. De gehoste server op https://mcp.linklyhq.com gebruikt OAuth — je logt één keer in via de browser en je AI-assistent blijft verbonden. Afgezien van je AI-assistent zelf is er niets te installeren op je computer.
Heb ik een API-sleutel nodig?
Nee. De MCP-server gebruikt OAuth — je logt de eerste keer dat je AI-assistent verbinding maakt in bij Linkly via je browser, en er is nergens een API-sleutel om te kopiëren of te plakken.
Welke AI-assistenten ondersteunen MCP?
Claude Desktop, Claude Code (CLI) en ChatGPT Desktop ondersteunen allemaal MCP. Andere tools zoals Cursor en Windsurf hebben ook MCP-ondersteuning.
Is mijn account veilig?
Ja. De gehoste server gebruikt OAuth 2.1 met PKCE — je Linkly-wachtwoord wordt uitsluitend op app.linklyhq.com ingevoerd, en je AI-assistent ziet alleen een toegangstoken dat beperkt is tot je workspace. Het AI-model zelf krijgt je inloggegevens nooit te zien.
Kan ik MCP gebruiken met de webversies van Claude of ChatGPT?
Nee, MCP vereist de desktopapplicaties of de Claude Code CLI. De webversies ondersteunen geen MCP-verbindingen.
Hoe werk ik de MCP-server bij?
Er is niets bij te werken — we rollen continu verbeteringen uit naar de gehoste server en elke verbonden client krijgt ze automatisch.