BesluitBron 1.4.4-23 Status Sign in

Connector Register

Last changed on .

The connector register is the only place in the product that answers the question of which sources this installation offers. The address, the management console menu, the visitor selection page, the website footer, llms.txt, sitemap.xml, /health and the configuration page all read from that single register.

Why it has to be that one place

The requirement is not “a toggle in the settings” but “switched off means unavailable to everyone”. An address that no longer responds whilst a page still advertises it is worse than having no toggle at all. The visitor then receives an error message at the very place where the service itself has directed them. By addressing the issue in one place, a partially implemented change becomes impossible rather than simply a point requiring attention during checks.

The circuit

flowchart LR
    CFG["Settings<br/>BesluitBron:<br/>&lt;Platform&gt;:Enabled"] --> CAT["ConnectorCatalog<br/>on a one-off basis at<br/>starting"]
    CAT --> EP["MCP addresses"]
    CAT --> MENU["Menu of the<br/>management console"]
    CAT --> KIES["Selection page<br/>for visitors"]
    CAT --> FOOT["Footer:<br/>source citation<br/>and addresses"]
    DSP["Settings<br/>BesluitBron:<br/>&lt;Platform&gt;:Display"] -->|"just the addresses"| FOOT
    CAT --> LLM["llms.txt and<br/>sitemap.xml"]
    CAT --> HLT["/health"]

The register is calculated once at start-up and does not change thereafter. A change to the settings therefore requires a restart. This is the same rule as for the port and the certificate. The reason is that the address mapping can only be set once, whereas the pages can be reconfigured with every request. Both read from the same frozen register and therefore cannot diverge.

The lower limit

At least one source must remain active. If you switch everything off, Open Raadsinformatie will be restored, with a log entry under code ‘bbnsrv005’ and a note on the configuration page. This will not cause the service to fail: an incorrect setting should trigger a warning, not a fault.

Open Raadsinformatie is the go-to option, as it is the platform offering precise figures and boasting the longest track record for this product.

Offering and promoting

The register answers two separate questions. Enabled indicates whether a connector is offered. Display indicates whether the address is listed in the site’s footer. Both are listed per connector in the settings, so BesluitBron:Ori:Enabled appears alongside BesluitBron:Ori:Display.

From version 1.3.54 onwards, Display is enabled by default only for Alle Bronnen. As a result, the footer lists one MCP address instead of eight. What the seven source connectors do remains unchanged: their addresses are active, their connection pages exist and their explorers work. The source citation in the footer also remains, as it credits the platform rather than the address. Up to and including version 1.3.53, only Enabled was listed.

The configuration page of the management console displays both switches for each connector, along with the full path of the setting. See Beheerconsole.

Addresses and versions

The newer connectors include a version number in the address, for example /mcp/rechtspraak/v1. The older address without a version number will also remain accessible to anyone who has set up their assistant previously. The comparison is made against the entire segment, so that /mcp/opentk does not accidentally override /mcp/opentk/v1.

Open Raadsinformatie deliberately uses the address without a version number: /mcp/ori. That address is already in use, and an existing convention will not be broken for the sake of symmetry.