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"
Installatieopties
De Linkly MCP Server is op twee manieren beschikbaar:
Optie 1: Gehoste server (aanbevolen)
Gebruik onze gehoste MCP-server - geen installatie vereist:
https://mcp.linklyhq.com
Optie 2: npm-pakket
Installeer en voer lokaal uit met npx:
npx -y linkly-mcp-server
Of installeer globaal:
npm install -g linkly-mcp-server
Bekijk het pakket op npm.
Configuratie
Je API-referenties verkrijgen
- 1Log in op je Linkly-dashboard
- 2Ga naar Instellingen → API-sleutels
- 3Kopieer je API-sleutel en Workspace-ID
Claude Desktop-configuratie
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", "linkly-mcp-server"],
"env": {
"LINKLY_API_KEY": "your-api-key",
"LINKLY_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
ChatGPT Desktop-configuratie
Open je ChatGPT-configuratiebestand:
- macOS:
~/Library/Application Support/ChatGPT/mcp_servers.json - Windows:
%APPDATA%\ChatGPT\mcp_servers.json
Voeg de Linkly MCP-server toe:
Gebruik npx:
{
"servers": {
"linkly": {
"command": "npx",
"args": ["-y", "linkly-mcp-server"],
"env": {
"LINKLY_API_KEY": "your-api-key"
}
}
}
}
Gebruik gehoste server:
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com",
"env": {
"LINKLY_API_KEY": "your-api-key"
}
}
}
}
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
Omgevingsvariabelen
| Variabele | Vereist | Beschrijving |
|---|---|---|
LINKLY_API_KEY | Ja | Je Linkly API-sleutel |
LINKLY_WORKSPACE_ID | Nee | Je workspace-ID (sommige clients vereisen dit) |
Probleemoplossing
"Could not connect to MCP server"
- Controleer of je API-sleutel en Workspace-ID correct zijn
- Zorg ervoor dat je Node.js hebt geïnstalleerd (v18 of later)
- Probeer
npx linkly-mcp-serverin een terminal uit te voeren om eventuele fouten te zien
"Authentication failed"
- Verifieer je API-sleutel in het Linkly-dashboard bij Instellingen → API-sleutels
- Zorg ervoor dat er geen extra spaties in je referenties zitten
- Probeer je API-sleutel opnieuw te genereren
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)
Server is niet bereikbaar
- Bevestig dat het commandopad correct is
- Als je de gehoste server gebruikt, controleer je internetverbinding
- Verifieer dat de MCP-server handmatig vanuit de terminal werkt
Gerelateerde bronnen
MCP Server veelgestelde vragen
Moet ik iets installeren om de MCP-server te gebruiken?
Niet als je de gehoste server op https://mcp.linklyhq.com gebruikt. Als je liever lokaal draait, heb je Node.js v18 of later nodig.
Welke AI-assistenten ondersteunen MCP?
Claude Desktop en ChatGPT Desktop ondersteunen beide MCP. Andere tools zoals Cursor en Windsurf hebben ook MCP-ondersteuning.
Is mijn API-sleutel veilig?
Ja. Je API-sleutel wordt lokaal opgeslagen in het configuratiebestand van je AI-assistent en wordt alleen naar de servers van Linkly verzonden bij het maken van API-verzoeken. Het wordt nooit gedeeld met het AI-model zelf.
Kan ik MCP gebruiken met de webversies van Claude of ChatGPT?
Nee, MCP vereist de desktopapplicaties. De webversies ondersteunen geen MCP-verbindingen.
Hoe werk ik de MCP-server bij?
Bij gebruik van npx wordt automatisch de nieuwste versie opgehaald. Als je deze globaal hebt geïnstalleerd, voer dan npm update -g linkly-mcp-server uit.