Verbinden met de BC MCP Pro-connector
De BC MCP Pro-connector van Vangelder Solutions koppelt een AI-assistent aan Microsoft Dynamics 365 Business Central. Bij het starten leest hij in de MCP Guard-extensie de regel van de aangemelde gebruiker en past hij die toe: de toegestane bedrijven, het standaardbedrijf, de MCP-configuratie, de toegangsniveaus en de daglimieten. De connector kan ook het gebruik van elke gebruiker melden. Elke aanroep loopt nog altijd onder het eigen Business Central-account van de gebruiker, dus machtigingensets en beveiligingsfilters gelden onveranderd.
Voordat u begint
In elke omgeving waarin gebruikers werken:
- De extensie is geïnstalleerd. Zie De MCP Guard-extensie installeren.
- Elke gebruiker heeft een MCP Guard-licentie en de machtigingenset MCP GUARD - USER. Zie Licenties toewijzen.
- De MCP-configuraties die de regels noemen, bestaan en zijn Active. Zie MCP-configuraties.
Gebruik de nieuwste versie van de connector, en werk de connector bij voordat u de extensie bijwerkt. Sommige onderdelen van een regel vereisen een minimale versie van de connector. Een oudere connector negeert ze.
| Onderdeel van de regel | Vereist |
|---|---|
| Algemene toegang | Connector 0.8.0 of later, of de cloudeditie 0.11.0 of later. Zie Algemene toegang. |
| Gebruiksrapportage | De cloudeditie 0.12.0 of later, met rapportage ingeschakeld. Zie Gebruik per gebruiker. |
| Daglimiet aanroepen en Daglimiet wijzigingen | De cloudeditie 0.13.0 of later, met gebruiksrapportage ingeschakeld. De desktopconnector past ze niet toe. Zie Daglimieten. |
Wat de connector doet bij het starten
- Aanmelden. De gebruiker meldt zich één keer aan met Microsoft.
- Omgeving. De connector gebruikt de omgeving die ingevuld is. Anders neemt hij eerst de productieomgevingen, daarna de andere in alfabetische volgorde, en kiest hij de eerste waarin de gebruiker machtigingen heeft in minstens één bedrijf.
- Bedrijven. Voor elk bedrijf controleert de connector of de gebruiker er mag werken.
- Regel. De connector leest de regel van de gebruiker uit de API-pagina
mcpUserSettings. Deze aanroep is ook de licentiecontrole. - Verbinding. De connector maakt verbinding met de MCP-server van Business Central met het resulterende bedrijf en de resulterende MCP-configuratie, met het wisselen van bedrijf beperkt tot de toegestane bedrijven, en met de tools die de gebruiker niet mag gebruiken verborgen.
Wat de connector uit de extensie leest
De pagina MCP Guard User Settings API (73633179) geeft hoogstens één rij terug: de regel die op de aangemelde gebruiker van toepassing is.
GET https://api.businesscentral.dynamics.com/v2.0/{tenantId}/{environment}/api/vangelderSolutions/mcpguard/v1.0/companies({companyId})/mcpUserSettings
| Veld | Betekenis |
|---|---|
allowedCompanies | Bedrijfsnamen, gescheiden door puntkomma's. Leeg betekent elk bedrijf waarin de gebruiker machtigingen heeft. |
defaultCompany | Het bedrijf waarin de verbinding opent. Als het niet tot de toegestane bedrijven behoort, wordt het eerste toegestane bedrijf gebruikt. |
configurationName | De naam van de MCP-configuratie. Leeg betekent de standaardconfiguratie van de omgeving. |
settingSource | User of Group: waar de regel vandaan komt. |
licenceSource | Licensed, of SandboxRule voor een gebruiker zonder licentie in een sandboxomgeving. |
productionAccess, planningAccess, assemblyAccess, projectAccess | Het toegangsniveau per module. |
generalAccess | Het toegangsniveau voor alles buiten de eigen API-pagina's van de extensie. |
dailyCallLimit, dailyChangeLimit | De daglimieten. 0 betekent geen limiet. |
Geen rij betekent dat er geen regel van toepassing is: de gebruiker krijgt elk bedrijf waarin hij machtigingen heeft en de standaard-MCP-configuratie.
In een sandboxomgeving krijgt een gebruiker die de AI-assistent op de pagina Mijn MCP Guard heeft uitgeschakeld, een antwoord alsof er geen regel van toepassing is, en laat de connector die sandbox weg. Zie De AI-assistent in- of uitschakelen in een sandbox.
Meerdere omgevingen
De connector kan elke omgeving overhouden waarin de gebruiker machtigingen heeft en waarin de extensie de gebruiker toelaat. Hij leest de regel dan één keer per omgeving. Een omgeving zonder de extensie, of waarin de gebruiker geen licentie heeft, wordt overgeslagen. De gebruiker ziet alleen een melding als er geen enkele omgeving overblijft.
Regels gelden per omgeving. Installeer de extensie en maak de regels in elke omgeving die gebruikers moeten kunnen bereiken.
Toegangsniveaus in de connector
De connector leest de toegangsniveaus en verbergt wat de regel niet toelaat: een tool of actie van de API-pagina's van de extensie die een hoger niveau nodig heeft, staat niet in de lijst met tools. Business Central dwingt dezelfde niveaus af op de server, dus het resultaat is hetzelfde als een gebruiker met een andere MCP-client verbinding maakt. Zie Toegangsniveaus per module.
Voor Algemene toegang is de connector de enige handhaver. Hij verbergt en weigert de acties op de standaardpagina's van Business Central die boven het niveau liggen. Zie Algemene toegang.
Wat de connector toepast, en wat Business Central afdwingt
De bedrijven, het standaardbedrijf, de MCP-configuratie, Algemene toegang, de daglimieten, de gebruiksrapportage en de sandboxschakelaar worden toegepast door de connector. Ze zijn een beleid, geen beveiligingsgrens: een gebruiker die een andere MCP-client gebruikt, kan nog altijd een ander bedrijf of een andere configuratie kiezen, en wordt er niet door beperkt. De toegangsniveaus per module en alle machtigingen worden afgedwongen door Business Central.