fikst. MCP-connector: documentatie

Wat dit is

fikst. is CRM- en planningssoftware voor Nederlandse installatiebedrijven: HVAC, airco, warmtepompen, zonnepanelen en elektra. De fikst. MCP-connector op mcp.fikst.cloud geeft Claude toegang tot uw eigen fikst.-omgeving, zodat u klanten, offertes, planning, facturen en service kunt raadplegen en bijwerken in een gewoon gesprek, zonder tussen schermen te wisselen.

De connector is bedoeld voor beheerders, verkopers en planners die met Claude willen werken in plaats van in de app te klikken, en voor wie een eigen koppeling of automatisering op fikst. wil bouwen. Elke actie loopt door dezelfde vermogenslaag als de fikst.-app zelf: dezelfde organisatie-afscherming, dezelfde statusregels en dezelfde BTW-berekening gelden dus ook hier.

Hoe verbinden

Er zijn twee manieren om de connector te gebruiken.

Met uw eigen fikst.-inlog (OAuth). In Claude voegt u de connector toe via Instellingen, Connectors, met de URL https://mcp.fikst.cloud/mcp. Claude stuurt u door naar het inlogscherm van fikst.; na inloggen en toestemming geven verschijnen de tools in uw gesprek. De rechten die u krijgt volgen automatisch uw rol in fikst.: een beheerder krijgt het volledige pakket, een monteur krijgt alleen wat voor het eigen veldwerk nodig is.

Met een organisatiesleutel. Maak een sleutel aan in fikst. onder Instellingen, API-toegang. Kies daarbij zelf hoeveel de sleutel mag: alleen lezen, ook aanmaken en bijwerken, of ook de inrichting van uw organisatie wijzigen. Deze route is bedoeld voor uw eigen software of automatiseringen, niet alleen voor Claude: dezelfde sleutel werkt op https://mcp.fikst.cloud/api/v1.

Wat elke scope mag

Scope	Wat de koppeling mag
`read`	Gegevens opvragen: klanten, offertes, werkorders, facturen, servicemeldingen, planning. Wijzigt niets.
`write`	Alles van `read`, plus aanmaken en bijwerken: leads vastleggen, offertes opstellen, werkorders inplannen, e-mail versturen namens uw organisatie.
`config`	Alles van `write`, plus de inrichting van uw omgeving: instellingen, sjablonen, rollen, schermindelingen en automatiseringen.
`webhooks`	Uitsluitend het webhookkanaal voor externe automatiseringen. Geeft geen toegang tot de overige tools.

Bij een verbinding via uw eigen inlog (OAuth) geldt hetzelfde principe, maar dan afgeleid uit uw rol in fikst. in plaats van een gekozen scope.

Tools per domein

De connector telt meer dan 200 tools, gegroepeerd rond de onderdelen van fikst. Hieronder staat per domein een greep uit de beschikbare tools; de volledige, altijd actuele lijst met naam, omschrijving en verwacht schema vraagt u zelf op via de tool-index die de connector meestuurt (of, voor de HTTP-route, GET /api/v1/tools).

Leads en klanten

fikst_create_lead: legt een nieuwe lead vast met contactgegevens en gevraagde dienst.
fikst_convert_lead: zet een lead om naar een bedrijf of particuliere klant.
fikst_list_accounts / fikst_get_account: zoekt bedrijven op of haalt de details van één bedrijf op.
fikst_create_individual: legt een particuliere klant vast.
fikst_add_note: zet een notitie bij een klant, lead of ander record.

Offertes

fikst_create_quote: stelt een offerte op met regels, prijzen en eventuele korting.
fikst_update_quote_status: wijzigt de status, bijvoorbeeld naar verzonden.
fikst_get_quote / fikst_list_quotes: haalt een offerte op of zoekt offertes.
fikst_generate_quote_template: genereert een sjabloon op basis van eerdere offertes.

Werkorders en planning

fikst_create_work_order: maakt een werkorder aan, eventueel gekoppeld aan een offerte.
fikst_plan_work_order / fikst_assign_work_order: plant een werkorder in en wijst een monteur of baan toe.
fikst_update_work_order_status: doorloopt de statussen tot en met gereed voor facturatie.
fikst_list_lanes / fikst_get_lane_crew: toont de planbanen en wie er die week op staat.

Facturen en betalingen

fikst_create_invoice_from_work_order: maakt een factuur op basis van een afgeronde werkorder.
fikst_mark_invoice_paid: registreert een betaling op een factuur.
fikst_list_purchase_invoices / fikst_create_purchase_invoice: beheert inkomende inkoopfacturen.
fikst_get_moneybird_status: toont de status van de boekhoudkoppeling.

Service en contracten

fikst_create_ticket / fikst_list_tickets / fikst_update_ticket: legt servicemeldingen vast en volgt ze op.
fikst_get_ticket_conversation: toont het volledige gesprek achter een melding, inclusief inkomende mail.
fikst_list_installations / fikst_create_installation: houdt bij welke apparaten bij welke klant staan.
fikst_configure_contract_pricing: stelt de prijsregels voor onderhoudscontracten in.

Inrichting en beheer

fikst_update_company_settings: past de instellingen van uw organisatie aan.
fikst_create_api_key / fikst_list_api_keys / fikst_revoke_api_key: beheert programmeersleutels.
fikst_invite_user / fikst_create_employee: nodigt een gebruiker uit of legt een medewerker vast.
fikst_list_automations / fikst_create_automation: bekijkt en bouwt automatiseringen.
fikst_whoami / fikst_run_health_check: toont wat de huidige verbinding mag en controleert de gezondheid van uw inrichting.

De guardrails, in gewone taal

Voorstel-dan-bevestigen bij ingrijpende wijzigingen. Een aantal

inrichtingstools (zoals het herverdelen van planbanen of het wijzigen van statussen op een custom object) laat eerst zien wat er gaat gebeuren, met de gevolgen ervan (bijvoorbeeld hoeveel werkorders op een verdwijnende baan staan), en voert pas iets door na een aparte, expliciete bevestiging.

Organisatie-afscherming. Elke aanroep is gebonden aan de organisatie

achter uw inlog of sleutel. Er is geen manier om, per ongeluk of expres, bij gegevens van een andere organisatie te komen.

Auditlog. Elke wijziging die de connector doorvoert komt in de

wijzigingshistorie van fikst. te staan, herleidbaar naar de gebruiker of de sleutel die de actie deed. U ziet dus altijd terug wat een AI-gestuurde actie precies veranderde.

Verwijderen is zeldzaam. Bijna alles wat op "verwijderen" lijkt, werkt

in werkelijkheid met deactiveren: terug te draaien, niet permanent. Er is precies één tool die echt iets verwijdert, en die vraagt om expliciete bevestiging voordat hij iets doet.

Testomleiding voor e-mail. Uitgaande e-mailacties (zoals het versturen

van een offerte of een betalingsherinnering) volgen dezelfde instellingen van uw organisatie als in de app zelf, inclusief een eventuele testomleiding tijdens het inrichten van een nieuwe omgeving.

Snelheidslimiet. Per sleutel en per sessie geldt een limiet op het

aantal aanroepen per minuut, als bescherming tegen misbruik of een verkeerd lopende automatisering.

Support

Placeholder, in te vullen voor publicatie:

E-mail: info@fikst.app
Documentatie van de publieke HTTP-API (voor eigen koppelingen naast Claude): zie docs/PUBLIC-API.md in de fikst.-repository, of vraag uw contactpersoon.

fikst. MCP connector: documentation

What this is

fikst. is CRM and scheduling software for Dutch installation companies: HVAC, air conditioning, heat pumps, solar panels and electrical work. The fikst. MCP connector at mcp.fikst.cloud gives Claude access to your own fikst. environment, so you can look up and update customers, quotes, scheduling, invoices and service tickets in an ordinary conversation, without switching between screens.

The connector is meant for admins, salespeople and planners who want to work through Claude instead of clicking through the app, and for anyone who wants to build their own integration or automation on top of fikst. Every action runs through the same service layer as the fikst. app itself: the same organisation scoping, the same status rules and the same VAT calculation apply here too.

How to connect

There are two ways to use the connector.

With your own fikst. login (OAuth). In Claude, add the connector via Settings, Connectors, with the URL https://mcp.fikst.cloud/mcp. Claude redirects you to the fikst. login screen; after logging in and granting consent, the tools appear in your conversation. The rights you get automatically follow your role in fikst.: an admin gets the full set, a field technician gets only what their own field work needs.

With an organisation key. Create a key in fikst. under Settings, API access. You choose how much the key can do: read only, also create and update, or also change your organisation's setup. This route is meant for your own software or automations, not only for Claude: the same key works on https://mcp.fikst.cloud/api/v1.

What each scope allows

Scope	What the integration can do
`read`	Retrieve data: customers, quotes, work orders, invoices, service tickets, scheduling. Changes nothing.
`write`	Everything in `read`, plus creating and updating: recording leads, drafting quotes, scheduling work orders, sending email on behalf of your organisation.
`config`	Everything in `write`, plus your environment's setup: settings, templates, roles, screen layouts and automations.
`webhooks`	The webhook channel for external automations only. Grants no access to the other tools.

When connecting with your own login (OAuth), the same principle applies, but derived from your role in fikst. rather than a chosen scope.

Tools by domain

The connector counts more than 200 tools, grouped around fikst.'s main areas. Below is a selection per domain; the full, always current list with name, description and expected schema is available from the tool index the connector itself provides (or, on the HTTP route, GET /api/v1/tools).

Leads and customers

fikst_create_lead: records a new lead with contact details and requested service.
fikst_convert_lead: converts a lead into a company or individual customer.
fikst_list_accounts / fikst_get_account: searches companies or fetches the details of one company.
fikst_create_individual: records an individual (residential) customer.
fikst_add_note: adds a note to a customer, lead or other record.

Quotes

fikst_create_quote: drafts a quote with line items, prices and any discount.
fikst_update_quote_status: changes the status, for example to sent.
fikst_get_quote / fikst_list_quotes: fetches a quote or searches quotes.
fikst_generate_quote_template: generates a template based on past quotes.

Work orders and scheduling

fikst_create_work_order: creates a work order, optionally linked to a quote.
fikst_plan_work_order / fikst_assign_work_order: schedules a work order and assigns a technician or lane.
fikst_update_work_order_status: moves a work order through its statuses up to ready for invoicing.
fikst_list_lanes / fikst_get_lane_crew: shows the scheduling lanes and who is assigned to each that week.

Invoices and payments

fikst_create_invoice_from_work_order: creates an invoice from a completed work order.
fikst_mark_invoice_paid: registers a payment on an invoice.
fikst_list_purchase_invoices / fikst_create_purchase_invoice: manages incoming purchase invoices.
fikst_get_moneybird_status: shows the status of the accounting integration.

Service and contracts

fikst_create_ticket / fikst_list_tickets / fikst_update_ticket: records service tickets and follows up on them.
fikst_get_ticket_conversation: shows the full conversation behind a ticket, including inbound email.
fikst_list_installations / fikst_create_installation: tracks which devices are installed at which customer.
fikst_configure_contract_pricing: sets the pricing rules for maintenance contracts.

Setup and administration

fikst_update_company_settings: changes your organisation's settings.
fikst_create_api_key / fikst_list_api_keys / fikst_revoke_api_key: manages programmatic keys.
fikst_invite_user / fikst_create_employee: invites a user or records an employee.
fikst_list_automations / fikst_create_automation: reviews and builds automations.
fikst_whoami / fikst_run_health_check: shows what the current connection is allowed to do and checks the health of your setup.

The guardrails, in plain language

Propose-then-confirm for impactful changes. Several setup tools (such

as reshuffling scheduling lanes or changing statuses on a custom object) first show what would happen, including the consequences (for example how many work orders sit on a lane that would disappear), and only apply the change after a separate, explicit confirmation.

Organisation scoping. Every call is bound to the organisation behind

your login or key. There is no way, by accident or on purpose, to reach another organisation's data.

Audit log. Every change the connector makes is recorded in fikst.'s

change history, traceable to the user or key that performed it. You can always see exactly what an AI-driven action changed.

Deletion is rare. Almost everything that looks like deleting actually

deactivates: reversible, not permanent. There is exactly one tool that truly deletes something, and it requires explicit confirmation before it does anything.

Email test redirect. Outbound email actions (such as sending a quote

or a payment reminder) follow the same organisation settings as the app itself, including any test redirect configured while setting up a new environment.

Rate limit. A per-key and per-session limit caps how many calls are

allowed per minute, as protection against misuse or a runaway automation.

Support

Placeholder, to be filled in before publication:

Email: info@fikst.app
Documentation for the public HTTP API (for your own integrations alongside Claude): see docs/PUBLIC-API.md in the fikst. repository, or ask your contact person.