> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Een app koppelen

> Koppel een zakelijke tool in enkele klikken via OAuth aan Hive, met providerspecifieke stappen voor PostHog-regio's en Sage 200-edities.

Een tool koppelen duurt een minuut. U meldt zich bij de provider aan in een beveiligd venster, Hive slaat
de verbinding op in zijn kluis en begint direct na het koppelen met lezen — zodat de eerste
antwoorden al binnen enkele ogenblikken beschikbaar kunnen zijn.

## Voordat u begint

* **Eigenaren en beheerders** kunnen elke provider in de catalogus koppelen. Als u een provider voor de
  eerste keer koppelt, wordt deze ook ingeschakeld voor de rest van de werkruimte.
* **Overige leden** kunnen hun eigen account koppelen zodra een eigenaar of beheerder die
  provider heeft ingeschakeld, en kunnen alleen een verbinding met een ingeschakelde provider gebruiken. Zie
  [Een provider inschakelen voor leden](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#enabling-a-provider-for-members).
* Voor het koppelen van een account is een **Pro**- of **Max**-licentie nodig; met een **Goedkeurder**-licentie kunt u geen accounts koppelen.
  Signalen monitort de accounts van leden met een Max-licentie, met één gemonitorde mailbox per Max-licentie:
  die van de licentiehouder zelf. De accounts van een Pro-lid worden gebruikt om gegevens live te lezen in Ask, agents en workflows.
  Een lid dat zijn licentie verliest, behoudt zijn verbindingen, maar Hive stopt met het lezen daarvan totdat het lid
  weer een licentie heeft. Zie [Facturering en abonnementen](https://docs.get-hive.ai/nl/admin/billing-and-plans.md#seats).
* Meld u aan met een account dat toegang heeft tot de gegevens die u door Hive wilt laten gebruiken. Hive kan alleen lezen wat
  dat account kan lezen.

## Indeling van het tabblad Connectors

**Integraties → Connectors** toont alleen uw eigen verbindingen, ongeacht uw rol: ook eigenaren en
beheerders zien hier geen verbindingen van collega's. Een tool die een collega heeft gekoppeld, staat voor u
net als elke andere tool in de galerij, met **Koppelen** om uw eigen account toe te voegen. Van boven naar beneden:

* **De aantallen.** Hoeveel tools u heeft gekoppeld (live) en hoeveel tools de onderstaande
  taakgroepen bevatten (het aantal tools in alle groepen samen; een gekoppelde tool wordt
  daar dus niet meer meegeteld), en, voor eigenaren en beheerders, wanneer Hive uw gekoppelde
  tools weer controleert.
* **Zoeken.** Eén zoekveld voor alle tools, op naam, categorie, taakgroep of URL. Groepen met
  een overeenkomst worden geopend en tonen het aantal overeenkomsten; groepen zonder overeenkomsten worden verborgen.
* **Aandacht nodig.** Alleen wanneer uw aandacht nodig is: een account van u waarvan de aanmelding
  is verlopen of mislukt, of een MCP-server van u met een fout. Het exacte account wordt vermeld, bijvoorbeeld
  “Gmail · [old@yourfirm.co.uk](mailto:old@yourfirm.co.uk)”, ook als uw andere accounts voor die tool wel werken. Elk account
  heeft een eigen knop **Opnieuw verbinden**.
* **Gekoppeld.** Uw verbindingen in compacte rijen, elk met status, account, laatste synchronisatie en
  bedieningsopties: **Lezen**, **Concept** of **Handelen** (zie
  [Accounts en autonomie](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)), **Accounts**, **+** om
  nog een account toe te voegen, en **Ontkoppelen**. Uw MCP-servers en inkomende webhooks staan hier
  ook. Een tool die u meerdere keren heeft gekoppeld (twee Gmail-mailboxen, twee Xero-organisaties) staat op één
  rij die het aantal accounts vermeldt; open deze om elk account op een eigen regel te zien, met een
  eigen status, laatste synchronisatie, instelling **Lezen** / **Concept** / **Handelen**, **Opnieuw verbinden** en
  **Ontkoppelen**. Met **Account toevoegen** op de rij koppelt u nog een account. Het aantal bovenaan telt
  tools, geen accounts.
* **Aanbevolen voor uw kantoor.** Maximaal zes tools die u nog niet heeft gekoppeld, elk met een reden:
  wat Hive op de website van uw kantoor heeft gevonden, een tool die gangbaar is voor uw type kantoor, of een tool die samenwerkt
  met een tool die u al heeft gekoppeld. Een durfkapitaal- of private-equityfirma krijgt de tools aangeboden
  die beleggingsondernemingen gebruiken, zoals Carta en Datasite, in plaats van algemene kantoorsoftware zoals Word of
  Excel. Als de website nog niet is onderzocht, kan een eigenaar of beheerder hier de
  website toevoegen; zie [Aanbevelingen op basis van uw website](https://docs.get-hive.ai/nl/integrations/overview.md#recommendations-from-your-website).
* **Bladeren op taak.** Alle overige tools in een taakgroep, zoals **E-mail en agenda**,
  **Boekhouding en belastingen** of **Openbare registers en gegevens**. Groepen zijn aanvankelijk gesloten; selecteer een groep om deze te openen,
  of **Alles tonen** om ze allemaal te openen. Hive onthoudt welke groepen u in deze
  browser heeft geopend. Tools die in geen enkele groep passen, staan onder **Overige tools**. Elke tool heeft één tegel, ongeacht het aantal
  aanmeldmethoden, en de regel onder de naam vermeldt het type tool, zoals
  **Boekhouding** of **CRM en verkoop**.

## Een tool koppelen

**1. Integraties openen**

Selecteer uw naam onderaan de zijbalk, kies **Integraties** en blijf op het
tabblad **Connectors**. Typ in het zoekvak bovenaan: hiermee doorzoekt u alle tools op naam,
categorie, functiegroep of URL en opent u de overeenkomende groepen. Of open een functiegroep, zoals
**Boekhouding & belastingen** of **Berichten & telefonie**, om deze te bekijken. Zie
[Hoe het tabblad Connectors is ingedeeld](#how-the-connectors-tab-is-laid-out).

**2. De tool kiezen**

Selecteer de tegel van de aanbieder en vervolgens **Koppelen**. Hive biedt alleen een MCP-server voor tools waarvoor het
geen reguliere integratie heeft, dus vrijwel elke tool wordt op één manier gekoppeld. Linear is de uitzondering:
**Koppelen** biedt **Beheerde OAuth**, **Linear MCP-server** of **Uw token gebruiken**, omdat Ask
Linear voorlopig via de MCP-server leest. Zie
[Tools die hun reguliere integratie gebruiken](https://docs.get-hive.ai/integrations/mcp-servers.md#tools-that-use-their-regular-integration).
Voor een tool die niet in de catalogus staat, selecteert u **Integratie toevoegen** om **Een connector toevoegen** te openen.

**3. Aanmelden en toegang goedkeuren**

Er wordt een beveiligd aanmeldvenster van de aanbieder geopend. Meld u aan en keur de gevraagde toegang goed.
Hive krijgt uw wachtwoord nooit te zien.

**4. De eerste synchronisatie laten uitvoeren**

Terug in Hive ziet u “Outlook gekoppeld. Hive leest het nu en u kunt meteen vragen
stellen.” (met de naam van de tool) zodra de verbinding is opgeslagen, met **Ask openen**
om naar de startpagina van Ask te gaan, waar **Uw gegevens voorbereiden** de eerste leesactie toont. De eerste synchronisatie
wordt vervolgens op de achtergrond uitgevoerd — bij een
eerste verbinding kan dit enkele minuten duren terwijl Hive het account leest en bepaalt wat het moet
volgen — en het tabblad Connectors en Signalen worden automatisch bijgewerkt zodra deze is voltooid. Een nieuw
account begint op **Handelen**: in Ask en Signalen voert Hive er acties in uit en vertelt het u wat het
heeft gedaan. Kies **Concept** om elke actie eerst goed te keuren, of **Lezen** zodat Hive alleen zoekt en
samenvat. Een bovengrens die een eigenaar of beheerder voor de app instelt, kan het niveau lager houden. Zie
[Accounts en autonomie](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md).

> [!NOTE]
>
> Als Hive de integratieaanbieder niet kan bereiken, toont **Integraties** de melding **De apps die u kunt toevoegen
> konden niet worden geladen** in plaats van de volledige galerij. Uw gekoppelde tools blijven werken. Selecteer na even wachten **Opnieuw proberen**.
> **Verbinding toevoegen** bij een workflowstap toont dezelfde melding op die plek.

Als het aanmelden in het venster niet wordt voltooid, vertelt Hive waar mogelijk waarom, bijvoorbeeld vanwege een geblokkeerde pop-up, en
wat u vervolgens kunt doen. Zie [Als het koppelen mislukt](https://docs.get-hive.ai/integrations/health-and-disconnect.md#if-connecting-fails).

### Koppelen vanuit een antwoord in Ask

Als Ask voor uw vraag een tool probeerde uit te lezen die u nog niet heeft gekoppeld, kan het antwoord eindigen
met **Een app koppelen om dit te beantwoorden** en een knop **Koppelen** voor die tool, zoals **HubSpot
koppelen**. Hiermee opent u hetzelfde aanmeldvenster als in Integraties; stel uw vraag opnieuw zodra de tool is gekoppeld.
Als u voor de tool eerst een keuze moet maken, zoals de regio voor PostHog of de editie voor Sage 200, wordt de
knop een link, zoals **PostHog koppelen in Integraties**. Die opent deze pagina met een zoekopdracht
naar de tool, zodat u hier die keuze kunt maken (zie
[Aanbiederspecifieke stappen](#provider-specific-steps)). Alleen u ziet deze knoppen, en Ask biedt
**Koppelen** alleen aan voor tools die een eigenaar of beheerder al voor de werkruimte heeft ingeschakeld. Bij een tool die uw
werkruimte toestaat maar nog niet heeft ingeschakeld, ziet een eigenaar of beheerder in plaats daarvan **Inschakelen** en de naam van de tool **in
Integraties**, bijvoorbeeld **Calendly inschakelen in Integraties**: hiermee opent u deze pagina met een zoekopdracht
naar de tool. Door de tool hier te koppelen, schakelt u deze in voor de werkruimte. Alle anderen zien dat een eigenaar
of beheerder de tool moet inschakelen voordat ze deze kunnen koppelen. Ask biedt WhatsApp Business nooit aan; Hive toont de
[voorwaarden](https://docs.get-hive.ai/integrations/messaging.md#whatsapp-terms) daarvan wanneer u deze hier koppelt. Een knop **Koppelen**
in Ask schakelt een tool nooit in voor de werkruimte, ook niet voor een eigenaar of beheerder: als de tool is
uitgeschakeld nadat het antwoord is geschreven, weigert Hive de koppeling met de melding “Een werkruimtebeheerder moet deze aanbieder inschakelen
voordat u een persoonlijk account kunt koppelen.” Dit wordt geleidelijk uitgerold. Zie
[Een app koppelen of opnieuw koppelen vanuit het antwoord](https://docs.get-hive.ai/nl/ask/ask-hive.md#connect-or-reconnect-an-app-from-the-answer).

> [!TIP]
>
> Tijdens de eerste inrichting koppelt u met **Uw werk koppelen** e-mail en bestanden tegelijk. Als slechts één van de
> twee wordt gekoppeld, bijvoorbeeld Outlook maar niet OneDrive, kiest u **Doorgaan met Outlook** om daarmee verder te gaan
> en de andere later hier toe te voegen. Elke tool onder **Later toevoegen** rondt de inrichting af en opent
> deze pagina gefilterd op die tool. Zie
> [Uw werk koppelen](https://docs.get-hive.ai/nl/get-started/set-up-your-workspace.md#connect-your-work).

## Stappen per aanbieder

> [accordion] PostHog: kies uw regio
>
> PostHog vraagt in welke regio uw project staat: **EU** (`eu.posthog.com`) of **US**
> (`us.posthog.com`). Kies de regio die uw PostHog-account gebruikt. De verkeerde regio verwijst naar een
> andere host, waardoor leesacties geen gegevens opleveren. Heeft Hive u bij het koppelen van
> PostHog niet om een regio gevraagd? Ontkoppel PostHog en koppel het opnieuw om uw regio vast te leggen.

> [accordion] Sage 200: kies uw editie
>
> Sage 200 vraagt naar uw editie: **Sage 200 Standard Online** of **Sage 200 Professional /
> Extra Online**. Na het aanmelden vindt Hive uw site en bedrijf. Het account waarmee u zich
> aanmeldt, heeft toegang tot de Sage 200 API en **Company Access** nodig; anders wordt de verbinding
> geweigerd met een melding die dit uitlegt.

> [accordion] Xero: machtigingen voor facturen
>
> De Xero-factuursignalen van Hive hebben de machtiging `accounting.invoices.read` nodig (een oudere
> verbinding met `accounting.transactions.read` werkt ook). Geef toestemming voor de
> toegang die Xero bij het aanmelden vraagt; heeft u beperktere toegang verleend, koppel dan opnieuw.

> [accordion] Microsoft 365: één tegel per onderdeel
>
> Microsoft 365 gebruikt afzonderlijke tegels, zodat u precies de benodigde toegang verleent: **Outlook**
> (e-mail en agenda), **Microsoft Teams** (chats en kanalen), **OneDrive** en
> **SharePoint Online** (bestanden), en **Microsoft Word** en **Microsoft Excel** (documenten).

> [accordion] Tools met een reguliere integratie worden niet via MCP aangeboden
>
> Stripe, GitHub, Intercom en Notion worden uitsluitend via hun reguliere integratie gekoppeld; Hive
> biedt MCP-servers voor tools waarvoor het geen reguliere integratie heeft. Een eerder gemaakte MCP-verbinding
> blijft werken. Zie [MCP-servers](https://docs.get-hive.ai/integrations/mcp-servers.md#tools-that-use-their-regular-integration).

## Meerdere accounts koppelen

U kunt meerdere accounts van dezelfde aanbieder koppelen, bijvoorbeeld een gedeelde mailbox `billing@`
en uw eigen Postvak IN. Ze verschijnen als één tegel met een paneel **Accounts**. Elk account:

* is eigendom van het lid dat het heeft gekoppeld;
* heeft een eigen autonomieniveau (Lezen, Concept of Handelen);
* staat in een terugvalvolgorde, met het primaire account voorop. Eigenaren en beheerders kunnen de volgorde wijzigen.

Als u hetzelfde account opnieuw koppelt, wordt de bestaande verbinding hersteld in plaats van een duplicaat toegevoegd; alleen defecte
tegels voor hetzelfde account worden vervangen. Zie [Accounts en autonomie](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)
en [Status en ontkoppelen](https://docs.get-hive.ai/integrations/health-and-disconnect.md#fix-a-connection).

### Boekhoudorganisaties

De eigen boekhoudorganisatie van uw werkruimte (Xero, QuickBooks, FreeAgent of Sage) telt als één
gekoppeld account. Elke andere boekhoudorganisatie die u koppelt, is een klantadministratie: deze telt nooit
als een extra gekoppeld account. U hoeft dus nooit [extra gekoppelde accounts](https://docs.get-hive.ai/nl/admin/billing-and-plans.md#add-ons) aan te schaffen
voor klantadministraties. Bij Starter tellen klantadministraties wel mee voor de 3 gekoppelde accounts per Pro-
of Max-licentie.

Voor klantadministraties is de Practice-add-on nodig. Zolang deze niet te koop is, wordt het koppelen van een tweede boekhoudorganisatie
geweigerd met een melding die dit uitlegt nadat u zich bij die organisatie heeft aangemeld. Reeds gekoppelde boekhoudorganisaties
blijven werken. Als een ander lid de eigen organisatie van uw werkruimte koppelt of opnieuw koppelt,
is dat geen tweede organisatie en verloopt het koppelen zoals gebruikelijk. Om over te stappen naar
een andere boekhoudaanbieder, ontkoppelt u eerst de reeds gekoppelde aanbieder.
[Neem contact met ons op](https://docs.get-hive.ai/help/support.md) om deel te nemen aan de Practice-bèta.

## Na het koppelen

* **Signalen**: bij de volgende uurlijkse cyclus leest Signalen het account in uw
  [zaken](https://docs.get-hive.ai/signals/matters.md) in en begint het te letten op zaken die uw aandacht vragen.
* **Ask**: u kunt meteen vragen stellen over de gegevens van de tool. Hive leest waar mogelijk live en
  vermeldt de bronnen die het heeft gelezen.
* **Bestanden en e-mail**: bij een documentopslag (Google Drive, Docs, Sheets, OneDrive, Word, Excel,
  SharePoint, Dropbox) of een mailbox (Gmail, Outlook) begint Hive meteen met lezen in plaats van
  te wachten op de uurlijkse synchronisatie. Het leest in batches van maximaal 500 items, gedurende ongeveer vier minuten per
  uitvoering, en gaat daarna nog maximaal zes uitvoeringen door; wat daarna overblijft, wordt meegenomen in de
  reguliere uurlijkse synchronisatie. In Ask toont **Uw gegevens voorbereiden** de voortgang. Na het eerste
  inhalen synchroniseert Hive alleen wat er is gewijzigd.
* **Acties**: in Ask en Signalen is het niveau van het account bepalend. Bij **Handelen** voert Hive de actie uit
  en vertelt het u wat het heeft gedaan; bij een onomkeerbare actie of een actie die door een veiligheidscontrole wordt tegengehouden,
  vraagt het nog steeds eerst om toestemming. Bij **Concept** wacht het op uw goedkeuring, en bij **Lezen** vertelt het u alleen
  wat het heeft gevonden. Een agent of workflow volgt hetzelfde niveau en dezelfde bovengrens voor de acties die
  ervoor zijn geselecteerd, en wacht zelfs bij **Handelen** op uw goedkeuring als de bestemming waarnaar een actie iets verstuurt niet door
  u is opgegeven.
  Zie
  [Wat agents en workflows zelfstandig doen](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#what-agents-and-workflows-do).

> [!TIP]
>
> Ziet u niet wat u verwachtte? De tegel toont wanneer Hive voor het laatst heeft gesynchroniseerd en hoeveel bestanden en
> e-mails het heeft gelezen. Staat er **Ontkoppeld** of **Opnieuw koppelen vereist**, selecteer dan
> **Opnieuw koppelen**. Zie [Status en ontkoppelen](https://docs.get-hive.ai/integrations/health-and-disconnect.md).

## Gerelateerd

> [card] [Integratiecatalogus](https://docs.get-hive.ai/integrations/catalog.md)
>
> Wat elke aanbieder ondersteunt.

> [card] [Accounts en autonomie](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)
>
> Lezen, Concept en Handelen per account.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.