Claude-agents beperken tot toegestane websites: allowed_domains

In het kort

• Wat: Bij Claude Managed Agents kun je nu per agent instellen welke websites de ingebouwde web_search- en web_fetch-tools mogen bezoeken. Dat doe je met een lijst allowed_domains (alleen deze sites mogen) óf blocked_domains (deze sites juist niet), ingesteld op de agent-toolset.
• Waarom relevant: Een agent die zelfstandig het web op mag, kan in theorie overal terechtkomen. Met een domeinlijst bepaal je zelf de grenzen — handig voor grip, focus en het beperken van risico's.
• Wat je ermee kunt: Een klantenservice- of onderzoeksagent laten werken binnen jouw eigen kennisbank, leveranciersdocumentatie of een paar vertrouwde bronnen, in plaats van het hele internet.

Wat is er precies nieuw?

Claude Managed Agents zijn agents die Anthropic voor je draait: ze kunnen zelfstandig stappen zetten, zoals het web opzoeken (web_search) of een specifieke pagina ophalen (web_fetch). Nieuw is dat je nu per agent kunt vastleggen welke sites die twee webtools mogen bereiken.

Je kiest per tool één van twee lijsten:

• allowed_domains — een witte lijst. De tool mag alleen naar deze sites.
• blocked_domains — een zwarte lijst. De tool mag overal heen, behalve naar deze sites.

Je combineert de twee niet: kies er één per tool. Elke tool heeft zijn eigen lijst, dus web_search en web_fetch mogen verschillende regels hebben. Volgens de documentatie van Anthropic geldt: een genoemd domein dekt ook alle subdomeinen (example.com dekt dus ook docs.example.com), en per lijst mogen maximaal 64 domeinen. Wat de agent probeert te bezoeken buiten de lijst, wordt geweigerd: web_fetch geeft een foutmelding terug, en web_search laat de niet-toegestane resultaten simpelweg weg.

Goed om te weten: dit is een instelling op agent-niveau via het Claude Developer Platform. Het staat los van de organisatie-instellingen in de Console — die gelden voor de Messages API, niet voor Managed Agents. Voor een agent regel je het dus op de agent zelf.

Dit past in een bredere lijn waarin je steeds meer controle krijgt over wat een agent zelfstandig mag. Zie ook ons eerdere artikel Managed Agents krijgen automatische permissie-policies: waar permissie-policies bepalen of een tool zonder bevestiging mag draaien, bepalen domeinlijsten waar die tool naartoe mag.

Waarom dit voor het MKB uitmaakt

Stel: je laat een Claude-agent vragen van klanten beantwoorden of research doen. Zonder grenzen mag zo'n agent in principe het hele web raadplegen. Dat is krachtig, maar niet altijd wenselijk. Een paar concrete voordelen van domeingrenzen:

• Focus en betrouwbaarheid. Een agent die alleen jouw eigen website, handleidingen en een handvol vertrouwde bronnen mag raadplegen, verdwaalt minder snel op willekeurige of verouderde pagina's.
• Minder risico. Beperk je waar een agent naartoe mag, dan verklein je de kans dat hij per ongeluk twijfelachtige of ongewenste sites bezoekt.
• Rust en uitlegbaarheid. Voor jou en je team is het overzichtelijker: je kunt precies benoemen binnen welke bronnen de agent werkt. Dat helpt ook als een klant of collega vraagt "waar haalt dit vandaan?".

Belangrijk om nuchter te blijven: een witte lijst is een grens, geen slot op alles. Het bepaalt welke domeinen bereikbaar zijn, niet elk detail van wat daar staat. Zie het als het afbakenen van de speelruimte, niet als een garantie tegen elke fout. Combineer het daarom met gezond verstand en menselijk toezicht op wat de agent doet.

Een voorbeeld uit de praktijk

Stel je runt een webshop in kookgerei en je wilt een research-agent die productinformatie samenvat. Je zou web_search kunnen beperken tot je eigen domein en de sites van je merken en leveranciers, zodat de agent binnen die bronnen blijft. Voor web_fetch — het ophalen van een specifieke pagina — kun je hetzelfde doen, of juist een paar storende domeinen blokkeren.

Een paar aandachtspunten die uit de documentatie naar voren komen:

• Je geeft domeinen op als kale hostnaam, dus voorbeeld.nl, niet https://voorbeeld.nl.
• Voor web_fetch mag een domein geen pad bevatten (dus voorbeeld.nl, niet voorbeeld.nl/blog).
• Domeinen moeten in ASCII; voor namen met bijzondere tekens gebruik je de zogeheten Punycode-vorm (xn--).
• www.voorbeeld.nl en voorbeeld.nl tellen als verschillende domeinen — noem de kale variant om beide te dekken.

Geen zorgen als dit technisch klinkt: dit is precies het soort instelling dat je samen met een specialist één keer goed inricht, waarna je agent er netjes binnen blijft.

Waar je op moet letten

Maak de lijst niet strakker dan nodig. Vergeet je een domein dat je agent echt nodig heeft, dan lopen taken vast omdat de tool die site niet mag bezoeken. Begin liever met een duidelijke set vertrouwde bronnen en breid uit op basis van wat de agent in de praktijk nodig heeft.

En onthoud: deze functie is onderdeel van het bredere pakket aan bedieningsknoppen rond agents — samen met permissies en budgetten bepaal je hiermee stap voor stap hoeveel vrijheid een agent krijgt. Voor het MKB is dat de kern: je hoeft niet te kiezen tussen "alles of niets", je kiest precies de ruimte die past.

Aan de slag?

Wil je verkennen of een Claude-agent met duidelijke grenzen iets voor jouw bedrijf is? Je hoeft dit niet alleen uit te zoeken. Vind een Claude-specialist die met je meedenkt over de juiste opzet.

Benieuwd naar de mogelijkheden? Plan een gratis kennismaking via [email protected] — dan kijken we samen wat er past bij jouw situatie.

Santa Claude is een onafhankelijke Nederlandse community van Claude-specialisten en niet gelieerd aan Anthropic.