Skip to content

AI-assistent verbinden

This content is not available in your language yet.

Met de SamenstelFlow-assistent stelt u vanuit uw eigen AI-platform vragen over de administraties die u in SamenstelFlow al mag zien: welke werkstukken klaarliggen, hoe de BTW-positie ervoor staat, wat er in de jaarrekening staat. De assistent werkt met elk AI-platform dat het MCP-protocol spreekt, zoals Claude, Claude Code, Microsoft Copilot, GitHub Copilot in VS Code en ChatGPT.

U plakt nooit een sleutel of wachtwoord. Het enige dat u kopieert, is de connector-URL. Die is niet geheim.

Omgeving Connector-URL
SamenstelFlow (productie) https://mcp.samenstelflow.nl/mcp
Testomgeving (staging) https://mcp-stg.samenstelflow.nl/mcp

Gebruik de productie-URL, tenzij uw beheerder u vraagt de testomgeving te gebruiken. Kopieer de URL ook gerust via Kantoorgegevens → AI-assistent → Installatiehandleiding.

Controleer deze drie punten. Ontbreekt er één, dan ziet u straks geen kantoor om te kiezen.

  1. U heeft een eigen SamenstelFlow-account en een rol in het kantoor waarvoor u wilt werken. Iedere medewerker verbindt met zijn eigen account; een gedeelde verbinding is niet toegestaan.
  2. De assistent staat aan voor uw kantoor en uw platform. Een Eigenaar of Beheerder zet dit aan via Kantoorgegevens → AI-assistent, per platform (Claude, Copilot, GitHub Copilot, ChatGPT).
  3. Uw abonnement past bij wat het kantoor heeft toegestaan.
    • Een zakelijk abonnement (bij Claude Team of Enterprise, bij Copilot of ChatGPT het zakelijke equivalent, bij GitHub Copilot in VS Code GitHub Copilot Business of Enterprise) is het standaard en aanbevolen pad.
    • Een consumentenabonnement (Claude Free, Pro of Max, of een persoonlijk ChatGPT- of Copilot-account, bij GitHub Copilot Copilot Free, Pro of Pro+ (persoonlijk GitHub-account)) werkt alleen als uw kantoor dat risico expliciet heeft geaccepteerd. Er is dan geen verwerkersovereenkomst en de bewaartermijnen van het platform gelden, niet die van SamenstelFlow. Die keuze maakt de Eigenaar of Beheerder, nooit een medewerker zelf.

Voor de tools over werkstukken of de jaarrekening moet de bijbehorende module aanstaan voor de administratie.

Er zijn twee manieren. Doet uw kantoor Pad A, dan voegt een medewerker de connector niet nog een keer zelf toe; die verbindt alleen, zie Inloggen, kantoor kiezen en toestaan.

Pad A: de kantoorbeheerder verbindt eenmalig, organisatiebreed (aanbevolen)

Section titled “Pad A: de kantoorbeheerder verbindt eenmalig, organisatiebreed (aanbevolen)”

Voor kantoren met een zakelijk abonnement. De beheerder van het AI-platform voegt de connector één keer toe voor de hele organisatie.

  • Claude Team of Enterprise: een Eigenaar van de Claude-organisatie opent de organisatie-instellingen, onderdeel Connectors, kiest Add custom connector en vult als naam SamenstelFlow en als URL de connector-URL in. Laat de geavanceerde velden (OAuth client ID en secret) leeg. Medewerkers openen daarna Instellingen → Connectors, zoeken SamenstelFlow en klikken op Connect.
  • Microsoft Copilot: SamenstelFlow levert de assistent als kant-en-klare Copilot Studio-agent. Uw Microsoft 365-beheerder keurt die eenmalig goed. Medewerkers openen de assistent daarna in Teams, of noemen hem met @ in Microsoft 365 Copilot.
  • ChatGPT Business, Enterprise of Edu: uw ChatGPT-beheerder publiceert de connector eenmalig voor de hele workspace.

Voor wie zelf de connector toevoegt, bijvoorbeeld met een eigen Claude-abonnement of in Claude Code.

  • Claude Free, Pro of Max (claude.ai en de Claude-app): open Instellingen → Connectors → Add custom connector. Vul als naam SamenstelFlow en als URL de connector-URL in, laat de geavanceerde velden leeg, klik op Add en daarna op Connect.
  • ChatGPT: zet developer mode aan (Instellingen → Connectors → Advanced) en kies daarna Instellingen → Connectors → Create met de connector-URL.
  • Microsoft Copilot: zelf toevoegen kan niet; dit werkt alleen via Pad A.
  • GitHub Copilot in VS Code: zie GitHub Copilot in VS Code.

Voeg de server rechtstreeks toe aan Claude Code:

Terminal window
claude mcp add --transport http -s user samenstelflow https://mcp.samenstelflow.nl/mcp

Start Claude Code opnieuw, typ /mcp, kies samenstelflow en kies Authenticate. Uw browser opent het SamenstelFlow-inlogvenster.

Heeft u SamenstelFlow al als connector op claude.ai, dan ziet u in Claude Code ook een regel claude.ai SamenstelFlow. Die verbinding rondt u alleen op claude.ai zelf af, niet via /mcp in de terminal. Wilt u vanuit de terminal verbinden, gebruik dan het commando hierboven.

Meld u in VS Code aan met het GitHub-account van uw organisatie. Dat is voor een kantoor het zakelijke abonnement, GitHub Copilot Business of Enterprise. Een persoonlijk account (Copilot Free, Pro of Pro+ (persoonlijk GitHub-account)) werkt alleen als uw kantoor het consumentenrisico heeft geaccepteerd.

  1. Kies in het opdrachtenpalet MCP: Open User Configuration. Dit opent de mcp.json van uw gebruikersprofiel.

  2. Voeg de server toe. Er is geen sleutel of header nodig:

    {
    "servers": {
    "SamenstelFlow": {
    "type": "http",
    "url": "https://mcp.samenstelflow.nl/mcp"
    }
    }
    }
  3. Start de server via Start boven de regel in mcp.json. Uw browser opent het SamenstelFlow-inlogvenster.

Let op:

  • Zet de server in de mcp.json van uw gebruiker, nooit in een .vscode/mcp.json van een werkmap.
  • Zet het automatisch goedkeuren van tools niet aan (chat.tools.autoApprove, Always allow) en bevestig elke action-aanroep. VS Code heeft in dezelfde sessie ook een terminal, web-ophalen en andere MCP-servers.
  • VS Code verbindt via vaste poort 33418. Is die bezet, bijvoorbeeld door een tweede VS Code-venster, dan mislukt het inloggen. Sluit het andere venster of log in via vscode.dev.

Bij het verbinden opent het venster SamenstelFlow assistent verbinden.

  1. Inloggen. Bent u nog niet ingelogd, klik dan op Inloggen en log in met uw eigen SamenstelFlow-account. U komt daarna vanzelf terug op dit venster.
  2. Kies uw kantoor. De verbinding geldt voor één kantoor. Werkt u voor meerdere kantoren, verbind dan later opnieuw voor het tweede kantoor.
  3. Controleer wie toegang vraagt. Onder Wie vraagt toegang? staat de naam die de applicatie zelf opgeeft; die controleert SamenstelFlow niet. Kijk vooral naar het Antwoordadres: dat moet bij uw platform horen, bijvoorbeeld claude.ai voor Claude, localhost voor Claude Code of 127.0.0.1 of vscode.dev voor GitHub Copilot in VS Code. Herkent u het adres niet, klik dan op Weigeren.
  4. Lees wat de assistent mag en klik op Toestaan.

U gaat terug naar uw AI-platform; de connector staat nu op verbonden.

Start een nieuw gesprek, zet de SamenstelFlow-connector aan (bij Claude via + → Connectors) en vraag bijvoorbeeld:

  • Toon mijn administraties via SamenstelFlow.
  • Welke werkstukken liggen er klaar voor administratie X?
  • Maak een WKR-analyse over 2025.

Vraagt uw platform toestemming om een tool te gebruiken, sta die dan toe.

  • Lezen van alles wat u in SamenstelFlow zelf ook mag zien, voor het kantoor dat u bij het verbinden koos.
  • Wijzigen in rapporten: standaard aan. Een kantoorbeheerder zet dit uit in de kantoorinstellingen van de jaarrekening met de schakelaar Assistent mag wijzigingen doen in rapporten. Lezen blijft dan werken.
  • Samensteldossier: de assistent leest dossierdocumenten (PDF, Excel, CSV, Word en e-mail), stelt werkboeken op, bijvoorbeeld een aflossingsschema bij een leningovereenkomst, en plaatst bestanden onder een post. Elk geplaatst bestand wordt eerst op virussen gescand. In een definitief dossier schrijft de assistent nooit. Een document dat een medewerker heeft geplaatst, verwijdert of vervangt de assistent pas nadat u zijn voorstel hebt bevestigd.
Wat u ziet Wat het betekent Wat u doet
De assistent is nog niet ingeschakeld voor een kantoor waar u een rol heeft. Voor geen van uw kantoren staat de assistent aan voor dit platform, of uw consumentenabonnement is door het kantoor niet toegestaan. Vraag uw Eigenaar of Beheerder de assistent aan te zetten via Kantoorgegevens → AI-assistent, voor het juiste platform en abonnementstype. Bent u zelf Eigenaar of Beheerder, dan toont het inlogvenster uw kantoren met een knop Inschakelen: na het bevestigen van de voorwaarden gaat u direct verder met verbinden.
De assistent is tijdelijk uitgeschakeld voor dit platform. SamenstelFlow heeft dit platform tijdelijk uitgezet. Probeer het later opnieuw.
Dit verbindingsverzoek kan niet worden voltooid. Het verzoek van uw AI-platform is verlopen of onvolledig. Start het verbinden opnieuw vanuit uw AI-platform, niet door de pagina te verversen.
Ongeldig verzoek: deze pagina verwacht een volledige OAuth-autorisatieaanvraag. U opende de pagina los, zonder het verzoek van uw platform. Start het verbinden vanuit uw AI-platform.
Na het inloggen komt u op het SamenstelFlow-dashboard uit, niet bij de kantoorkeuze. Het inlogvenster is de weg terug kwijtgeraakt. Laat het tabblad ingelogd openstaan en start het verbinden opnieuw vanuit uw AI-platform. U slaat het inloggen dan over.
Claude Code toont bij claude.ai SamenstelFlow Needs authentication en /mcp lost het niet op. Dat is de claude.ai-connector; die verbindt u op claude.ai. Rond het verbinden af op claude.ai, of voeg de server rechtstreeks toe met het commando bij Claude Code.
De connector is verbonden, maar een vraag blijft langer dan een minuut laden. Er hapert iets tussen uw platform en SamenstelFlow. Start een nieuw gesprek. Blijft het hangen, meld het dan bij support met het tijdstip en het platform.