Praat met je project: maak kennis met de Todo4you MCP-server

Todo4you heeft nu een gehoste Model Context Protocol (MCP) server. Dat betekent dat je Claude, Cursor, Zed of een andere MCP-compatibele assistent kunt koppelen aan je project en er simpelweg tegen kunt praten in natuurlijke taal. Geen scripts, geen knip- en plakwerk tussen een chatvenster en je projecttool - je assistent leest en schrijft tickets rechtstreeks.

In deze post lees je wat de integratie nu kan, hoe je het in een paar minuten opzet, en welke prompts het meeste uit de koppeling halen.

Waarom MCP?

Als je toch al een groot deel van je dag in een AI-assistent werkt, breekt het naar een browsertab springen om een bug te loggen of een ticket te verplaatsen je flow. MCP lost dat op. Je assistent wordt de interface naar je project:

• Maak een ticket van een half idee zonder je editor uit te gaan.
• Vraag "wat staat er nog open in deze sprint?" en krijg een echt antwoord op basis van live data.
• Zet een ticket op "Review" zodra je een commit pusht, zonder het kanban-bord aan te raken.
• Start een timer op een ticket zodra je begint, en stop hem als je van taak wisselt.

Omdat alles via een scoped token loopt dat je zelf genereert, bepaal je precies welke projecten de assistent mag zien en of hij mag schrijven.

Wat de MCP-server kan

De set tools is in deze release flink uitgebreid. De server biedt nu 37 tools aan die de volledige ticket-lifecycle dekken - van lezen en zoeken tot tijdregistratie en checklistbeheer.

Projecten en metadata

• list_projects, project_stats, project_statuses - ontdekken wat het token mag zien en een project samenvatten.
• list_project_members, list_tags - gebruikers-ID's opzoeken voor toewijzing, en tag-ID's vinden.

Tickets

• list_tickets, search_tickets - het project doorbladeren of full-text doorzoeken.
• get_ticket - volledig detail: beschrijving, reacties, checklist, tags, toegewezen leden, blockers, bijlagen en tijdoverzicht.
• create_ticket, update_ticket - aanmaken of bewerken van titel, beschrijving, type, prioriteit, deadline, inschatting en tags.
• move_ticket, archive_ticket, delete_ticket - een ticket laten doorstromen of van het project halen.
• assign_member, unassign_member - beheren wie verantwoordelijk is.

Reacties

• list_comments, add_comment, update_comment, delete_comment - het gesprek op een ticket beheren.

Checklist en blockers

• add_checklist_item, toggle_checklist_item, update_checklist_item, delete_checklist_item - werk opsplitsen in subtaken.
• add_blocker, remove_blocker - afhankelijkheden tussen tickets bijhouden.

Tags

• create_tag, update_tag, delete_tag - de tags van een project beheren.

Tijdregistratie

• start_timer, stop_timer, pause_timer, resume_timer - een live timer op een ticket laten lopen.
• add_time_entry, update_time_entry, delete_time_entry - handmatig tijd loggen of aanpassen.
• list_time_entries, running_timer - zien wat er is geboekt en wat er nu loopt.

Alles loopt via dezelfde /api/v1-endpoints die de webapp gebruikt, dus rechten, aangepaste statussen en notificaties werken precies zoals in de UI.

Opzetten

1. Ga naar MCP-instellingen en maak een token aan. Kies alleen-lezen of lezen/schrijven, selecteer welke projecten het mag benaderen en stel eventueel een vervaldatum in.
2. Kopieer de token direct - het wordt gehasht opgeslagen en is daarna niet meer zichtbaar.
3. Voeg de URL van de gehoste server en je token toe aan je MCP-client. Op de instellingenpagina vind je kopieer-plak snippets voor Claude Code, Claude Desktop, Cursor, Zed, VS Code met Continue en een generieke HTTP-client.
4. Start een nieuwe chat in je assistent - de tools worden automatisch gevonden.

Voor een uitgebreidere uitleg en het securitymodel: zie de MCP-feature pagina.

Voorbeeldprompts

Het leuke deel. Hieronder prompts die goed werken zodra je assistent gekoppeld is.

Triage en planning

"Laat alle projecten zien waar ik bij kan, en vertel me welk project de meeste openstaande urgent-tickets heeft."

"Hoeveel tickets staan er nu in Review in het project todo4you? Als het er meer dan vijf zijn, stel een reviewronde voor."

"Zoek in webshop naar tickets waarin 'BTW' voorkomt en geef me per ticket een samenvatting van één regel."

Werk creëren en vormgeven

"Maak een bug in api met de titel 'PDF-factuur mist BTW-regel' en hoge prioriteit. Leg in de beschrijving uit dat klanten op het Nederlandse plan een lege BTW-regel zien op facturen die na 10 april zijn gegenereerd, en noem dat de reproductie in ticket API-214 staat."

"Open TDL-120, zet de prioriteit op urgent, wijs hem toe aan Bob en splits hem op in checklist-items: ontwerpen, implementeren, tests schrijven, changelog bijwerken."

"Voeg op TDL-88 een blocker toe die naar TDL-91 wijst, en zet er een reactie bij waarin je uitlegt waarom."

Je project bijhouden tijdens het programmeren

"Verplaats TDL-47 naar 'review' en voeg een reactie toe met wat ik heb gewijzigd: session cookie op SameSite=Lax gezet en een regressietest toegevoegd in tests/unit/AuthTest.php."

"Start een timer op TDL-47 - ik pak hem weer op."

"Hoeveel tijd heb ik deze sprint op TDL-47 geschreven, en welke entries waren langer dan een uur?"

Statusupdates voor stand-ups

"Schrijf mijn stand-up: wat is er in de afgelopen 24 uur op het project todo4you gewijzigd, wie is eigenaar van wat er loopt, en welke tickets lijken vast te staan."

Een paar tips

• Gebruik slugs, geen labels. Statussen worden op slug gematcht (in-progress, review, done). Als je assistent in de war raakt, laat hem eerst project_statuses aanroepen.
• Toewijzen vraagt om gebruikers-ID's. Laat je assistent aan het begin van de sessie één keer list_project_members aanroepen, dan heeft hij de ID's bij de hand.
• Scope strak. Geef elke assistent zijn eigen token met alleen de projecten die hij nodig heeft. Intrekken en opnieuw uitgeven kan in twee klikken.
• Begin alleen-lezen. Als je nog aan het ontdekken bent wat je wilt vragen, start dan met een alleen-lezen token. Upgraden kan later altijd.
• Controleer achteraf. AI-assistenten verzinnen af en toe een ticket-ID of prioriteit. Het project board is de bron van waarheid - controleer het even na een batch schrijfacties.

Zelf proberen?

Ga naar /profile/mcp-access om je eerste token aan te maken, of lees het volledige MCP-overzicht als je eerst meer context wilt. Bouw je er iets leuks mee, laat het weten - info@todo4you.nl.