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 korte 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 acties direct uit te voeren.
Ondersteunde AI-assistenten
De Linkly MCP Server werkt met:
- Claude Desktop
- ChatGPT Desktop
- Andere MCP-compatibele clients (Cursor, Windsurf, enz.)
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 volgen - "Hoeveel clicks hebben mijn links deze week gekregen?"
- Links beheren - "Update de link genaamd 'promo' met een nieuwe bestemming"
- Analytics bekijken - "Toon me clicks per land voor de laatste 30 dagen"
- Links zoeken - "Vind alle links gerelateerd aan de productlancering"
- Domeinen beheren - "Lijst mijn aangepaste domeinen"
- Webhooks instellen - "Abonneer https://my-site.com/webhook om click-gebeurtenissen 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 draai lokaal met npx:
npx -y linkly-mcp-server
Of installeer globaal:
npm install -g linkly-mcp-server
Bekijk het pakket op npm.
Configuratie
Je API-inloggegevens 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": "jouw-api-sleutel",
"LINKLY_WORKSPACE_ID": "jouw-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:
Met npx:
{
"servers": {
"linkly": {
"command": "npx",
"args": ["-y", "linkly-mcp-server"],
"env": {
"LINKLY_API_KEY": "jouw-api-sleutel"
}
}
}
}
Met gehoste server:
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com",
"env": {
"LINKLY_API_KEY": "jouw-api-sleutel"
}
}
}
}
Beschikbare Tools
| Tool | Beschrijving |
|---|---|
create_link | Maak een nieuwe korte link met optionele UTM-parameters, pixels en meer |
update_link | Update de instellingen van een bestaande link |
delete_link | Verwijder een link |
get_link | Verkrijg details van een specifieke link |
list_links | Lijst alle links in je workspace |
search_links | Zoek links op naam, URL of notitie |
get_clicks | Verkrijg recente click-gegevens |
get_analytics | Verkrijg tijdreeks click-gegevens voor grafieken |
get_analytics_by | Verkrijg clicks gegroepeerd per land, browser, platform, enz. |
list_domains | Lijst je aangepaste domeinen |
list_webhooks | Lijst workspace webhook-abonnementen |
subscribe_webhook | Abonneer een URL om click-gebeurtenissen te ontvangen |
Opties voor het maken van links
Bij het maken van links kun je het volgende 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 hebben dit nodig) |
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 inloggegevens staan
- Probeer je API-sleutel opnieuw te genereren
Tools verschijnen niet
- Start je AI-assistent opnieuw op na het opslaan van de configuratie
- Controleer of de JSON-syntax in je configuratiebestand geldig is
- Verifieer dat de MCP-server draait (controleer het tools-icoon in je assistent)
Server niet bereikbaar
- Bevestig dat het commando-pad correct is
- Als je de gehoste server gebruikt, controleer dan je internetverbinding
- Verifieer dat de MCP-server handmatig draait vanuit de terminal
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 desktoptoepassingen. De webversies ondersteunen geen MCP-verbindingen.
Hoe update ik de MCP-server?
Als je npx gebruikt, haalt het automatisch de nieuwste versie op elke keer. Als je globaal hebt geïnstalleerd, voer dan npm update -g linkly-mcp-server uit.