Naar inhoud
Alle artikelen

mcpclaude-codeagents

Zo voeg je een URL-shortener toe aan Claude Code met MCP

Koppel Claude Code via MCP aan Linkdash: het maakt korte links, verdeelt verkeer, deelt bestanden en leest klikstatistieken zonder de terminal te verlaten.

Igor Kirnosov6 min. lezen

Claude Code roept de Linkdash MCP-server aan om de korte link lida.sh/pricing te maken

Claude Code kan korte links maken en beheren zodra je het via MCP aan een URL-shortener koppelt. Voeg de Linkdash MCP-server toe met één commando, log één keer in via je browser, en Claude kan URL’s verkorten, verkeer over pagina’s verdelen, bestanden delen met een vervaldatum en klikstatistieken lezen, allemaal vanuit dezelfde terminalsessie waarin het je code schrijft.

Deze gids behandelt de installatie, het delen met je team, kiezen welke tools Claude zonder te vragen mag uitvoeren, de workflows waar het zich terugbetaalt, en het gebruik in CI. Gebruik je Cursor of Codex? De MCP-docs bevatten de installatiecommando’s daarvoor.

Wat Claude Code ermee kan

De Linkdash MCP-server biedt dezelfde acties als de CLI en de HTTP API, als tools die Claude zelf ontdekt:

Tools Wat Claude kan doen
links_create, links_update, links_delete Links maken, wijzigen, pauzeren en verwijderen
variants_add, variants_update, variants_remove Verkeer verdelen of routeren op land, apparaat of besturingssysteem
links_list, links_get, links_stats Links vinden en bezoeken, landen en referrers lezen
files_upload_url Een bestand uploaden en als link delen
links_export, links_import Links in- en exporteren als CSV
domains_*, webhooks_* Eigen domeinen en webhooks beheren

Stap 1: voeg de server toe

claude mcp add --transport http linkdash \
  https://api.linkdash.dev/mcp

Dit voegt Linkdash toe voor het huidige project. Voeg --scope user toe om het in elk project op je machine beschikbaar te maken.

Stap 2: log in

claude mcp login linkdash

Je browser opent de inlogpagina van Linkdash. Heb je nog geen account, dan kun je er daar een maken met het Free-abonnement. Na het inloggen vraagt een toestemmingsscherm of Claude Code je account mag gebruiken. Klik op Toestaan, en Claude Code bewaart de toegangstoken en vernieuwt die zelf.

Je kunt ook vanuit een sessie inloggen: voer /mcp uit, kies linkdash en kies voor authenticeren. Controleer de verbinding met:

claude mcp list

linkdash hoort te staan als ✔ Connected. Probeer het daarna:

Verkort https://example.com/pricing als lida.sh/pricing.

Claude roept links_create aan en antwoordt met de nieuwe korte link.

Stap 3: deel de installatie met je team

Wil je iedereen in een repository dezelfde server geven, voeg dan een bestand .mcp.json toe aan de root van het project:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp"
    }
  }
}

Er staat niets geheims in het bestand, dus je kunt het veilig committen. De eerste keer dat een teamgenoot het project opent, vraagt Claude Code hem de server goed te keuren, en elke persoon logt in met zijn eigen Linkdash-account, zodat elke link terechtkomt in het account van degene die erom vroeg.

Stap 4: bepaal wat zonder vragen draait

Standaard vraagt Claude Code toestemming voordat het een MCP-tool aanroept. Statistieken lezen is onschuldig, dus dat kun je beter toestaan; links verwijderen kun je beter helemaal blokkeren. Voeg rechtenregels toe aan .claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__linkdash__links_list",
      "mcp__linkdash__links_get",
      "mcp__linkdash__links_stats"
    ],
    "deny": [
      "mcp__linkdash__links_delete",
      "mcp__linkdash__variants_remove"
    ]
  }
}

MCP-tools heten mcp__<server>__<tool>, dus deze regels gaan ervan uit dat je de server in stap 1 linkdash hebt genoemd. Voor links maken en bijwerken wordt nog steeds elke keer om toestemming gevraagd, zodat je betrokken blijft bij alles wat verandert waar een link naartoe gaat.

Workflows die zich terugbetalen in de terminal

Maak korte links voor elke URL in CHANGELOG.md onder 2.4.0, tag ze met release-2.4 en vervang de URL’s in het bestand.

Claude leest het bestand, roept links_create één keer per URL aan met de tag, en bewerkt de changelog. De tag houdt de links van de release bij elkaar in het dashboard en bij latere vragen over statistieken.

Verdeel verkeer over een pagina die je net hebt gebouwd

Maak lida.sh/pricing die bezoekers 50/50 verdeelt over /pricing en /pricing-v2, met utm_content ingesteld op de naam van elke variant.

Claude maakt één link met twee varianten, elk getagd zodat je analysetool de groepen uit elkaar kan houden. De gids over A/B-testen met een link behandelt hoe lang je de test laat lopen en hoe je het resultaat leest.

Deel een build die verloopt

Deel dist/app-1.4.2.dmg als een link die over 3 dagen verloopt en na 5 openingen stopt.

Omdat Claude Code een shell heeft, kan het met bestanden werken: het roept files_upload_url aan, uploadt het bestand met curl naar de teruggegeven URL en roept daarna links_create aan met het geüploade bestand, expires: "3d" en maxOpenings: 5. Het bestand gaat nooit door het gesprek zelf.

Welke links met de tag release-2.4 kregen de afgelopen 7 dagen de meeste bezoeken, en waar kwamen die bezoeken vandaan?

Claude toont de getagde links en roept daarna voor elke link links_stats aan met last: "7d". Elk resultaat bevat bezoeken, landen en referrers. Met de rechtenregels uit stap 4 draaien deze leesacties zonder prompt.

Claude Code in CI draaien

Voor inloggen is een persoon achter een browser nodig, dus headless runs, zoals claude -p in een CI-job, gebruiken in plaats daarvan een API-sleutel. Maak er een aan onder API-sleutels (sleutels beginnen met ldash_), sla hem op als CI-secret met de naam LINKDASH_API_KEY en geef hem mee als header:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${LINKDASH_API_KEY}"
      }
    }
  }
}

Claude Code vult ${LINKDASH_API_KEY} in vanuit de omgeving, dus de sleutel zelf wordt nooit gecommit. De tools en rechtenregels werken in beide gevallen hetzelfde.

MCP of de CLI?

Claude Code kan de linkdash-CLI ook via zijn shell uitvoeren, en beide komen bij hetzelfde account uit:

  • MCP hoef je niet te installeren. Claude ziet getypeerde tools en hun parameters, en daardoor is het de makkelijkste keuze als je Claude gewoon links wilt laten beheren.
  • De CLI (npm i -g linkdash-cli) geeft JSON terug, wat past bij scripts die Claude voor je schrijft. Wil je Claude de CLI leren, installeer dan de Linkdash-agentskill met npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Problemen oplossen

  • linkdash toont ! Needs authentication. Voer claude mcp login linkdash uit en log opnieuw in. Dit gebeurt ook nadat je Claude Code in het dashboard hebt ontkoppeld.
  • Een server uit .mcp.json blijft in afwachting. Start claude in het project en keur hem goed. claude mcp reset-project-choices wist eerdere keuzes.
  • Tools mislukken met een 401-fout in CI. LINKDASH_API_KEY ontbreekt of is onjuist in die omgeving, of de sleutel is verwijderd.

FAQ

Ziet Claude mijn wachtwoord of een sleutel?

Nee. Je logt in op linkdash.dev in je browser, en Claude Code ontvangt een token die het in zijn eigen configuratie bewaart. Je wachtwoord en de token hoeven nooit in het gesprek te verschijnen.

Hoe ontkoppel ik Claude Code?

Open in het Linkdash-dashboard API-sleutels en klik op Ontkoppelen naast Claude Code onder Gekoppelde apps. De toegang stopt meteen. Met claude mcp logout linkdash verwijder je ook de opgeslagen token van je machine.

Alleen als je dat toestaat. De deny-regels uit stap 4 blokkeren links_delete en variants_remove, ook als Claude het probeert.

Is het gratis?

Ja, met het Free-abonnement, dat 5.000 events per maand bevat. Zie prijzen voor hogere limieten.

Kan ik ook Cursor, Codex of ChatGPT koppelen?

Ja. Dezelfde server werkt met allemaal, en de meeste hebben alleen de URL en een login nodig. De MCP-docs bevatten de stappen voor elk ervan.