Linkly MCP Server
Met de Linkly MCP Server kun je AI-assistenten verbinden met je Linkly-account via het Model Context Protocol. Eenmaal verbonden kun je korte links maken en beheren via natuurlijk gesprek.
Wat is MCP?
Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten veilig verbinding kunnen maken 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, etc.)
Waar je het vindt
De Linkly MCP Server staat vermeld in de belangrijkste MCP-directories, dus je kunt het installeren vanaf waar je al naar connectors zoekt:
- Claude connector directory — klik eenmaal om verbinding te maken in Claude (web en Desktop)
- Official MCP registry —
com.linklyhq/linkly - Smithery
- Glama
- mcp.so
- ClaudePluginHub — de Linkly plugin voor Claude Code en Cowork
- Source on GitHub — MIT licensed
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 een beter alternatief dan de MCP server. Coding agents zijn al gewend aan het besturen van opdrachtregelprogramma's, en de CLI biedt --json output bij elk commando plus een linkly schema commando dat de volledige commandoboom afdrukt, zodat de agent alles kan ontdekken wat het 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
Eenmaal 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 gehad?"
- Links beheren - "Werk de link genaamd 'promo' bij met een nieuwe bestemming"
- Analytics bekijken - "Toon me clicks per land voor de afgelopen 30 dagen"
- Links zoeken - "Zoek alle links die met de productlancering te maken hebben"
- Domeinen beheren - "Vermeld mijn aangepaste domeinen"
- Webhooks instellen - "Abonneer
https://my-site.com/webhookom clickgebeurtenissen 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 wanneer je AI-assistent voor het eerst verbinding maakt, wordt er een browservenster geopend 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
In Claude Desktop ga je naar Settings → Connectors → Add custom connector. Voer een naam in (Linkly) en de externe MCP server-URL:
https://mcp.linklyhq.com
Klik op Add, vervolgens op Connect op de Linkly connector. Er opent een browsertabblad waarin je kunt aanmelden en toegang kunt goedkeuren. Claude Desktop blijft dan verbonden — geen configuratiebestand of extra tooling nodig.
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
| Tool | Beschrijving |
|---|---|
create_link | Maak een nieuwe korte 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 | Haal details op van een specifieke link |
list_links | Vermeld alle links in je workspace |
search_links | Zoek links op naam, URL of notitie |
get_clicks | Haal recente clickgegevens op |
get_analytics | Haal tijdsreeksclickgegevens op voor grafieken |
get_analytics_by | Haal clicks gegroepeerd op land, browser, platform, etc. |
list_domains | Vermeld je aangepaste domeinen |
list_webhooks | Vermeld workspace webhook-abonnementen |
subscribe_webhook | Abonneer een URL om clickgebeurtenissen te ontvangen |
Opties voor link-creatie
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 - Verloop:
expiry_datetime,expiry_destination - Je eigen gegevens:
metadata, sleutel-waardeparen zoals ID's van je systeem. Deze worden geretourneerd met de link en opgenomen in webhook-payloads. Zie link metadata
Probleemoplossing
"Could not connect to MCP server"
- Bevestig dat
https://mcp.linklyhq.combereikbaar is van je machine - In Claude Code voer je
/mcpuit en kies je linkly om de OAuth-stroom opnieuw te starten
"Authentication failed", "invalid_client", of browser blijft vragen om aan te melden
Dit betekent dat je client een verouderde verbindingsregistratie bevat. Wis de gecachete referenties en autoriseer opnieuw. In Claude Code voer je /mcp → linkly → herverbinding uit. In Claude Desktop verwijder je de Linkly connector onder Settings → Connectors en voeg je deze opnieuw toe, waarna je je opnieuw aanmeldt.
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 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 meldt je eenmaal in de browser aan en je AI-assistent blijft verbonden. Er is geen software om op je machine te installeren naast je AI-assistent zelf.
Heb ik een API-sleutel nodig?
Nee. De MCP server gebruikt OAuth — je meldt je voor het eerst in Linkly aan via je browser wanneer je AI-assistent verbinding maakt, en er is geen API-sleutel om ergens te kopiëren of 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 alleen ingevoerd op app.linklyhq.com, en je AI-assistent ziet alleen een toegangstoken met het bereik van je workspace. Het AI-model zelf ziet je referenties nooit.
Respecteert de MCP-server mijn rol in de workspace?
Ja. Je AI-assistent kan doen wat je rol toestaat en niets meer. Als je de Read-rol hebt, kan het links en analytics opzoeken, maar kan het niets maken, bewerken of verwijderen.
Beschikbaarheid per plan
Beschikbaar vanaf Pro
Track 500 maandelijkse klikken gratis.