Het connectorregister is de enige plaats in het product die de vraag beantwoordt welke bronnen deze installatie aanbiedt. Het adres, het menu van de beheerconsole, de keuzepagina voor bezoekers, de voettekst van de website, llms.txt, sitemap.xml, /health en de configuratiepagina lezen alle uit dat ene register.
Waarom dat één plaats moet zijn
De eis is niet "een schakelaar in de instellingen" maar "uitgezet betekent afwezig voor iedereen". Een adres dat niet meer luistert terwijl een pagina het nog aanprijst, is slechter dan geen schakelaar. De bezoeker krijgt dan een foutmelding op een plek waar de dienst zelf hem naartoe heeft gestuurd. Door de vraag op één plaats te beantwoorden, is een half doorgevoerde schakeling onmogelijk in plaats van een aandachtspunt bij de controle.
De schakeling
flowchart LR
CFG["Instellingen<br/>BesluitBron:<br/><Platform>:Enabled"] --> CAT["ConnectorCatalog<br/>eenmalig bij<br/>het starten"]
CAT --> EP["MCP-adressen"]
CAT --> MENU["Menu van de<br/>beheerconsole"]
CAT --> KIES["Keuzepagina<br/>voor bezoekers"]
CAT --> FOOT["Voettekst:<br/>bronvermelding<br/>en adressen"]
DSP["Instellingen<br/>BesluitBron:<br/><Platform>:Display"] -->|"alleen de adressen"| FOOT
CAT --> LLM["llms.txt en<br/>sitemap.xml"]
CAT --> HLT["/health"]
Het register wordt eenmalig bij het starten berekend en verandert daarna niet meer. Een wijziging in de instellingen vraagt dus een herstart. Dat is dezelfde afspraak als voor de poort en het certificaat. De reden: de adrestoewijzing kan maar één keer worden vastgelegd, terwijl de pagina's dat wel elk verzoek opnieuw kunnen. Beide lezen uit hetzelfde bevroren register en kunnen daardoor niet uiteenlopen.
De ondergrens
Ten minste één bron blijft aan. Wie alles uitschakelt, krijgt Open Raadsinformatie terug, met een melding in het logboek onder code bbnsrv005 en een vermelding op de configuratiepagina. De dienst valt daar niet door uit: een verkeerde instelling hoort een melding op te leveren en geen storing.
Open Raadsinformatie is de terugval, want dat is het platform met exacte totalen en met de langste staat van dienst binnen dit product.
Aanbieden en aanprijzen
Het register beantwoordt twee vragen die uit elkaar worden gehouden. Enabled zegt of een connector wordt aangeboden. Display zegt of het adres in de voettekst van de site wordt genoemd. Beide staan per connector in de instellingen, dus BesluitBron:Ori:Enabled naast BesluitBron:Ori:Display.
Vanaf versie 1.3.54 staat Display standaard alleen aan voor Alle Bronnen. De voettekst noemt daardoor één MCP-adres in plaats van acht. Wat de zeven bronconnectoren doen, verandert niet: hun adres luistert, hun aansluitpagina bestaat en hun verkenner werkt. De bronvermelding in de voettekst blijft ook staan, want die crediteert het platform en niet het adres. Tot en met versie 1.3.53 was er alleen Enabled.
De configuratiepagina van de beheerconsole toont per connector beide schakelaars, met het volledige pad van de instelling erbij. Zie Beheerconsole.
Adressen en versies
De nieuwere connectoren dragen een versie in het adres, bijvoorbeeld /mcp/rechtspraak/v1. Het oudere adres zonder versie blijft daarnaast bereikbaar voor wie zijn assistent eerder heeft ingesteld. De vergelijking gaat over het volledige segment, zodat /mcp/opentk niet per ongeluk /mcp/opentk/v1 opslokt.
Open Raadsinformatie houdt met opzet het adres zonder versie, /mcp/ori. Dat adres is in gebruik, en een bestaande afspraak wordt niet gebroken om de symmetrie.