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 gratis

Verbinden

Het adres van de server is altijd hetzelfde:

https://app.twizy.nl/mcp

claude.ai, Claude Desktop en Cowork

  1. Ga in Claude naar Instellingen, Connectors, en kies Custom connector toevoegen.
  2. Vul als naam Twizy in en als URL het adres hierboven. Laat de geavanceerde instellingen leeg.
  3. Klik Verbinden, log in bij Twizy en kies de organisatie en de rechten.
  4. 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.

Tools met het recht lezen
ToolWat 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.

Tools met het recht schrijven
ToolWat 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.

Tools met het recht financieel
ToolWat 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 vragen

Of 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.