> For the complete documentation index, see [llms.txt](https://docs.artific.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artific.nl/voor-beheerders/tools.md).

# Tools en integraties

Alles waarmee een assistent of een Toolbox-element iets kan doen in de buitenwereld.

Dit gedeelte is technischer dan de rest van de documentatie. Dat is onvermijdelijk. Een API koppelen valt niet uit te leggen zonder het over methodes, headers en authenticatie te hebben. Ben jij niet degene die dit gaat doen, geef deze pagina's dan door aan degene die jullie integraties beheert.

## Wat je hier vindt

| Pagina                                                         | Waar het over gaat                                                                |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [API-tools](/voor-beheerders/tools/api-tools.md)               | Vanuit een assistent een eigen API of die van een derde partij aanroepen.         |
| [Geheime sleutels](/voor-beheerders/tools/geheime-sleutels.md) | De inloggegevens bewaren die zulke aanroepen nodig hebben.                        |
| [API-toegang](/voor-beheerders/tools/api-toegang.md)           | Je eigen systemen het platform laten aanroepen, met service accounts en API keys. |

Twee verwante pagina's staan elders, omdat je ze per assistent instelt:

* [Tools](/voor-beheerders/assistenten/tools.md): tools aan- en uitzetten voor een assistent.
* [Connectors](/voor-beheerders/assistenten/connectors.md): verbinden met MCP-servers.

## Het juiste middel kiezen

| Je wilt…                                                   | Gebruik                                                                      |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Een assistent iets laten opzoeken in een van je systemen   | Een [API-tool](/voor-beheerders/tools/api-tools.md)                          |
| Verbinden met een server die al MCP spreekt                | Een [connector](/voor-beheerders/assistenten/connectors.md)                  |
| Een assistent een van je Toolbox-elementen laten uitvoeren | Een element-tool, via het tabblad Tools van de assistent                     |
| Een assistent je documenten laten doorzoeken               | Een [zoektool](/voor-beheerders/kennisbank/zoektools.md)                     |
| Je eigen software het platform laten aansturen             | Een [service account met een API key](/voor-beheerders/tools/api-toegang.md) |

Kies een connector als het doelsysteem MCP al ondersteunt: ontdekking, sturing per actie en autorisatie per gebruiker krijg je er dan gratis bij. Bouw een API-tool als dat niet zo is.

## Twee regels die de moeite waard zijn

**Beschrijf tools voor het model, niet voor mensen.** De assistent beslist of hij een tool gebruikt door de beschrijving te lezen. Een vage beschrijving levert een tool op die op de verkeerde momenten afgaat of helemaal nooit. Vertel wat hij doet, wat hij nodig heeft en wanneer hij gebruikt moet worden.

**Geef de kleinst mogelijke toegang die werkt.** Een tool is een mogelijkheid die je overhandigt aan een systeem dat zelf bepaalt wanneer het die gebruikt. Alleen-lezen endpoints, afgebakende inloggegevens en geblokkeerde acties zijn geen paranoia. Zo is het bedoeld.