Voor wie zelf koppelt
De Twizy MCP server.
Twizy heeft een eigen MCP server. Daarmee koppel je Twizy aan Claude, Claude Code of een andere AI assistent die MCP ondersteunt. Je logt in met je eigen Twizy account en kiest zelf wat de assistent mag.
Probeer 14 dagen gratisVerbinden
Het adres van de server is altijd hetzelfde:
https://app.twizy.nl/mcp
claude.ai, Claude Desktop en Cowork
- Ga in Claude naar Instellingen, Connectors, en kies Custom connector toevoegen.
- Vul als naam Twizy in en als URL het adres hierboven. Laat de geavanceerde instellingen leeg.
- Klik Verbinden, log in bij Twizy en kies de organisatie en de rechten.
- Zet Twizy in een gesprek aan via het plusmenu.
Je hebt een Claude abonnement nodig waarmee je eigen connectors kunt toevoegen. Bij Team en Enterprise voegt de beheerder van je Claude organisatie de connector meestal eerst toe.
Claude Code
Voeg de server toe in je terminal:
claude mcp add --transport http twizy \
https://app.twizy.nl/mcp
Typ daarna /mcp in Claude Code en kies Twizy om in te loggen.
Andere MCP-clients
Maak in Twizy onder Instellingen, AI koppeling een persoonlijk token. Je kiest de rechten en hoe lang het geldig is: standaard 90 dagen, maximaal een jaar. Stuur het mee als header:
Authorization: Bearer twz_pat_...
Het token zie je maar één keer. Een token in de URL wordt nooit geaccepteerd.
Alle tools
Welke tools je assistent kan gebruiken, hangt af van de rechten van de koppeling en je rol in Twizy. De rechten worden bij elke aanroep opnieuw bepaald.
Lezen
Staat altijd aan.
| Tool | Wat het doet |
|---|---|
| whoami | Wie je bent, je organisatie, rol, rechten, werkschema en lopende timer |
| list_projects | Projecten met begrote en geschreven uren |
| list_clients | Klanten zoeken, ook op maildomein |
| list_boards | Borden en kolommen van een project |
| get_my_day | Je dag: capaciteit, afspraken, focustijd, planner, deadlines en follow-ups |
| get_my_week | Je week per dag, plus deadlines die nog niet zijn ingepland |
| search_tasks | Taken zoeken en filteren, standaard je eigen open taken |
| get_task | Een taak met checklist, bronnen en reacties |
| find_task_by_source | Controleren of er al een taak bestaat voor een mail of link |
| list_calendar_events | Je eigen gekoppelde agenda, tot 62 dagen |
| list_time_entries | Uren met totalen en groepering |
| get_priority_inputs | Feiten om te prioriteren: deadline, schatting, besteed, resterend en vrije tijd per taak |
Schrijven
Kies je per koppeling. Teamleden alleen voor hun eigen werk.
| Tool | Wat het doet |
|---|---|
| create_task | Taak aanmaken, met bron en zonder dubbele taken |
| update_task | Status, kolom, deadline, prioriteit, toewijzing, schatting of titel wijzigen |
| add_comment | Reactie plaatsen, standaard intern |
| log_time | Uren schrijven voor vandaag of eerder, maximaal 12 uur per keer |
| start_timer en stop_timer | Timer starten en stoppen |
| suggest_week_plan | Voorstel voor een weekplanning, slaat niets op |
| apply_week_plan | Het voorstel na akkoord in de planner zetten |
Financieel
Alleen voor eigenaar en beheerder.
| Tool | Wat het doet |
|---|---|
| get_project_budget_status | Begroot tegenover besteed, prognose en "loopt uit" |
| get_unbilled_time | Onbefactureerde uren en onkosten per klant of project |
| get_open_invoices | Openstaande en te late facturen |
| get_workload | Bezetting per teamlid deze en volgende week |
| get_revenue_forecast | Omzetprognose per maand |
| get_profitability | Rendement per klant: declarabiliteit, marge en effectief uurtarief |
Vaste opdrachten (prompts)
Dagstart, Weekplanning, Weekreview, Mail naar taak, Urenadvies en Financieel overzicht. Mail naar taak vraagt het recht schrijven, Financieel overzicht het recht financieel.
Wat niet kan
Via de koppeling kan niets verwijderd worden, worden geen facturen of offertes gemaakt en worden geen mails verstuurd. Klantbeheer, tickets en checklists aanpassen kan nog niet.
Veiligheid
De koppeling is gebouwd op OAuth, met dezelfde login en tweestapsverificatie als Twizy zelf.
- Een koppeling hoort bij precies één organisatie. Werk je voor twee organisaties, dan maak je twee koppelingen.
- Een reactie die de klant ziet en het opslaan van een weekplanning vragen een tweede bevestiging.
- Tekst uit mails en klantberichten markeert Twizy als niet vertrouwd, zodat je assistent het als gegevens behandelt en niet als opdracht.
- Vertrouwelijke cliëntnotities gaan nooit naar een AI.
- Intrekken onder Instellingen, AI koppeling stopt de toegang direct. Gaat iemand uit dienst, dan vervallen diens koppelingen automatisch.
- De eigenaar kan AI voor de hele organisatie uitzetten, en persoonlijke tokens apart.
Vragen over de MCP server
Alle veelgestelde vragenOf mail naar hallo@twizy.nl. We reageren binnen een werkdag.
Nee. Je voegt Twizy toe als eigen koppeling (custom connector) met het adres https://app.twizy.nl/mcp.
In de proefperiode en in alle betaalde plannen van Twizy. Is je abonnement opgeschort, dan kan je assistent alleen nog lezen.
Twizy is getest met Claude. Andere assistenten die MCP ondersteunen koppel je met een persoonlijk token. Of dat lukt, hangt af van je abonnement bij die assistent. Lukt het niet, laat het ons weten via hallo@twizy.nl.
Nee. Claude leest je mail met zijn eigen Gmail koppeling en geeft alleen de gegevens voor de taak door aan Twizy.
Klaar om je administratie op één plek te zetten?
Probeer Twizy 14 dagen gratis, zonder creditcard. Daarna vanaf € 9 per maand.