MCP-servers: Claude verbinden met je stack
Installeer en configureer MCP-servers om Claude live toegang te geven tot Slack, Supabase, Notion en GitHub. Geen glue code vereist.
Een skill is een markdown-bestand met frontmatter op ~/.claude/skills/. Claude ontdekt skills door hun beschrijvingsveld te lezen; wanneer je verzoek overeenkomt, laadt het de runbook en volgt het deze. Schrijf de instructies één keer, krijg elke keer dezelfde stappen.
---
name: translate-pi-jargon
description: Vertaal PI juridisch jargon naar eenvoudig Engels. Gebruik wanneer de gebruiker juridische tekst plakt of verwijst naar termen zoals UM/UIM, aanmaningsbrief of retentierecht.
---
# Vertaal PI Jargon
1. Herformuleer de term in één eenvoudige zin.
2. Geef een voorbeeld van één zin van wanneer het ertoe doet.
3. Markeer alles met tijdsdruk (statuten, deadlines).Schrijf een skill de derde keer dat je hetzelfde recept in Claude plakt.
De beschrijving is het ontdekkingsmechanisme. Claude leest beschrijvingen en beslist welke skill, indien van toepassing, van toepassing is op je verzoek.
Slecht: "Een skill voor het werken met documenten." Claude kan niet zien wanneer dit van toepassing is.
Goed: "Gebruik wanneer de gebruiker een contract plakt of vraagt om termen uit een PDF samen te vatten, te redlineren of te extraheren."
De formule: "Gebruik wanneer [specifieke trigger]. Van toepassing op [specifieke inhoudstypen]."
Skill of CLAUDE.md-regel? Skills zijn herhaalbare procedures met meerdere stappen; CLAUDE.md-regels zijn altijd-actieve beperkingen. Een 10-stappen implementatie-runbook is een skill. "Voer nooit migraties uit tegen productie zonder een back-up" is een regel. Beide horen in het systeem.
Een MCP (Model Context Protocol) server is een adapter die externe tools beschikbaar maakt voor Claude. Slack, Supabase, Notion, GitHub: Claude roept de MCP aan, de MCP roept de API aan, jij schrijft nul glue code. In plaats van gegevens te kopiëren en plakken in prompts, leest Claude live gegevens en onderneemt direct actie.
Database MCP: "Toon me gebruikers die vorige week zijn aangemeld maar nog niet zijn geactiveerd" wordt uitgevoerd als een live query.
Slack MCP: "Vat samen wat #engineering vandaag heeft besproken" haalt live berichten op.
Notion MCP: "Werk de projectwiki bij met de beslissingen van vandaag" schrijft direct.
GitHub MCP: "Lijst open PR's ouder dan 7 dagen" bevraagt de live repo-status.
Installatiepatroon: installeer de server (npx of uvx), voeg de configuratie toe aan ~/.claude/settings.json:
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@your-org/mcp-slack"],
"env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here" }
}
}
}Beveiligingsregels:
Plak nooit echte tokens in openbare bestanden; injecteer via omgevingsvariabele of geheime opslag.
Database MCP's krijgen alleen-lezen referenties die zijn afgestemd op de tabellen die Claude nodig heeft. Service role keys kunnen tabellen verwijderen.
Controleer welke tools elke MCP beschikbaar maakt voordat u implementeert.
MCP's die acties ondernemen, krijgen een goedkeuringspoort.
Kies je eerste MCP door te vragen: wat plak ik momenteel in Claude vanuit een extern systeem? Resultaten van databasequery's wijzen naar de Supabase MCP; PR-lijsten naar GitHub; kanaalsamenvattingen naar Slack; notities naar Obsidian. Eén geïnstalleerde en actief gebruikte MCP is beter dan vier geconfigureerde en genegeerde.
Test het: sluit en heropen Claude Code om de detectie te activeren en vraag vervolgens: "Welke tools heb je beschikbaar van [MCP-naam]?" Als de lijst leeg is, controleer dan de syntax van settings.json en bevestig dat npx of uvx op je PATH staat.
Skills en MCP's versterken elkaar. Een implementatie-runbook skill plus een GitHub MCP plus een Slack MCP: Claude volgt het runbook, leest de live PR-status, plaatst voortgangsupdates. Een handmatige implementatie van 20 minuten wordt 2 minuten. De instelkosten bedragen ongeveer 30 minuten per skill en 10 per MCP; de eerste vijf keer gebruik betaalt het terug.
Geen gepubliceerde MCP voor je tool? Een minimale aangepaste server met de officiële Python SDK maakt één tool beschikbaar in ongeveer 30-40 regels: definieer de naam, beschrijving en invoerschema van de tool en verwerk vervolgens de aanroep. Geef de toolbeschrijving dezelfde specificiteit als een skillbeschrijving. Bouw aangepaste MCP's voor live, veelgevraagde gegevens; voor statische referentiegegevens is een skill die je vraagt om deze te plakken voldoende.
Referentiebeheer voor teaminstellingen. Hardgecodeerde tokens in een gedeeld settings.json zijn een incident dat wacht om te gebeuren. Twee veiligere patronen: env pass-through ("SLACK_TOKEN": "$SLACK_TOKEN", met de echte waarde in je shellprofiel) of een geheime manager die de MCP-server bij het opstarten bevraagt (Vault, 1Password CLI), zodat er niets gevoelig op schijf blijft staan.
Bereik tot het minimum: een alleen-lezen Postgres-rol voor Supabase, een fijnmazige GitHub-token beperkt tot specifieke repo's, een Slack-bottoken beperkt tot de kanalen die Claude moet zien.
Audit: voor MCP's die kunnen schrijven, voeg een PostToolUse-hook toe die tijdstempel, toolnaam, argumenten en resultaatstatus logt.
Skills zijn markdown-runbooks die Claude ontdekt via de beschrijving; schrijf er een de derde keer dat je dezelfde instructies plakt. MCP's verbinden Claude met externe API's zonder glue code; gebruik alleen-lezen, minst-bevoorrechte referenties. Beste eerste skill: de procedure die je deze week twee keer hebt uitgelegd. Beste eerste MCP: het systeem waaruit je het meest kopieert en plakt.