{"title":"Codeunit 8351 MCP Config Implementation, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/8351-mcp-config-implementation/points/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-16","object":{"type":"codeunit","id":8351,"name":"MCP Config Implementation","app":"System Application","url":"https://jonas-paprotka.de/ref/codeunit/8351-mcp-config-implementation/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/8351-mcp-config-implementation/source/","path":"src/System Application/App/MCP/src/Configuration/Codeunits/MCPConfigImplementation.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"table:2000000292":{"name":"MCP Configuration","url":"https://jonas-paprotka.de/ref/table/2000000292-mcp-configuration/"},"table:2000000293":{"name":"MCP Configuration Tool","url":"https://jonas-paprotka.de/ref/table/2000000293-mcp-configuration-tool/"},"page:8355":{"name":"MCP Copy Config","url":"https://jonas-paprotka.de/ref/page/8355-mcp-copy-config/"},"page:8359":{"name":"MCP Config Warning List","url":"https://jonas-paprotka.de/ref/page/8359-mcp-config-warning-list/"},"page:8376":{"name":"MCP API Object Lookup","url":"https://jonas-paprotka.de/ref/page/8376-mcp-api-object-lookup/"},"table:8357":{"name":"MCP API Object Buffer","url":"https://jonas-paprotka.de/ref/table/8357-mcp-api-object-buffer/"},"table:8350":{"name":"MCP API Publisher Group","url":"https://jonas-paprotka.de/ref/table/8350-mcp-api-publisher-group/"},"page:8356":{"name":"MCP API Publisher Lookup","url":"https://jonas-paprotka.de/ref/page/8356-mcp-api-publisher-lookup/"},"page:8354":{"name":"MCP Tools By API Group","url":"https://jonas-paprotka.de/ref/page/8354-mcp-tools-by-api-group/"},"table:8354":{"name":"MCP API Version","url":"https://jonas-paprotka.de/ref/table/8354-mcp-api-version/"},"page:8366":{"name":"MCP API Version Lookup","url":"https://jonas-paprotka.de/ref/page/8366-mcp-api-version-lookup/"},"table:8351":{"name":"MCP Entra Application","url":"https://jonas-paprotka.de/ref/table/8351-mcp-entra-application/"},"page:8358":{"name":"MCP Connection String","url":"https://jonas-paprotka.de/ref/page/8358-mcp-connection-string/"},"codeunit:457":{"name":"Environment Information","url":"https://jonas-paprotka.de/ref/codeunit/457-environment-information/"},"codeunit:433":{"name":"Azure AD Tenant","url":"https://jonas-paprotka.de/ref/codeunit/433-azure-ad-tenant/"},"codeunit:3060":{"name":"Uri","url":"https://jonas-paprotka.de/ref/codeunit/3060-uri/"},"codeunit:3960":{"name":"Regex","url":"https://jonas-paprotka.de/ref/codeunit/3960-regex/"},"codeunit:4110":{"name":"Base64 Convert","url":"https://jonas-paprotka.de/ref/codeunit/4110-base64-convert/"},"codeunit:4100":{"name":"Temp Blob","url":"https://jonas-paprotka.de/ref/codeunit/4100-temp-blob/"},"codeunit:1590":{"name":"Microsoft User Feedback","url":"https://jonas-paprotka.de/ref/codeunit/1590-microsoft-user-feedback/"}},"procs":[{"name":"CreateConfiguration","line":87,"kind":"procedure","access":"internal","params":2,"steps":[[93,"write",2000000292,"Insert"],[94,"call","LogConfigurationCreated",1]]},{"name":"ActivateConfiguration","line":98,"kind":"procedure","access":"internal","params":2,"steps":[[105,"call","IsDefaultConfiguration",1],[108,"call","IsDesignatedDefaultConfiguration",1],[112,"write",2000000292,"Modify"]]},{"name":"AllowCreateUpdateDeleteTools","line":116,"kind":"procedure","access":"internal","params":2,"steps":[[127,"call","DisableCreateUpdateDeleteToolsInConfig",1],[130,"write",2000000292,"Modify"],[131,"call","LogConfigurationModified",2]]},{"name":"DisableCreateUpdateDeleteToolsInConfig","line":134,"kind":"procedure","access":"internal","params":1,"steps":[[143,"write",2000000293,"ModifyAll"],[144,"write",2000000293,"ModifyAll"],[145,"write",2000000293,"ModifyAll"],[146,"write",2000000293,"ModifyAll"]]},{"name":"DeleteConfiguration","line":149,"kind":"procedure","access":"internal","params":1,"steps":[[156,"call","IsDefaultConfiguration",1],[159,"call","IsDesignatedDefaultConfiguration",1],[160,"call","MarkSystemDefaultAsDefault",0],[162,"call","LogConfigurationDeleted",1],[163,"write",2000000292,"Delete"]]},{"name":"CopyConfiguration","line":166,"kind":"procedure","access":"internal","params":1,"steps":[[176,"ext","page",8355,"GetConfigName",0],[177,"ext","page",8355,"GetConfigDescription",0]]},{"name":"CopyConfiguration","line":182,"kind":"procedure","access":"internal","params":3,"steps":[[194,"write",2000000292,"Insert"],[196,"call","CopyTools",2],[198,"call","LogConfigurationCreated",1]]},{"name":"CopyTools","line":202,"kind":"procedure","access":"local","params":2,"steps":[[214,"write",2000000293,"Insert"]]},{"name":"EnableDynamicToolMode","line":218,"kind":"procedure","access":"internal","params":2,"steps":[[228,"call","IsDefaultConfiguration",1],[231,"call","IsAPIToolsEnabled",1],[237,"write",2000000292,"Modify"],[238,"call","LogConfigurationModified",2]]},{"name":"EnableDiscoverReadOnlyObjects","line":241,"kind":"procedure","access":"internal","params":2,"steps":[[251,"call","IsDefaultConfiguration",1],[258,"write",2000000292,"Modify"],[259,"call","LogConfigurationModified",2]]},{"name":"EnableAPITools","line":262,"kind":"procedure","access":"internal","params":2,"steps":[[277,"write",2000000292,"Modify"],[278,"call","LogConfigurationModified",2]]},{"name":"EnableDataQueryTools","line":281,"kind":"procedure","access":"internal","params":2,"steps":[[290,"write",2000000292,"Modify"],[291,"call","LogConfigurationModified",2]]},{"name":"CreateDefaultConfiguration","line":323,"kind":"procedure","access":"internal","params":0,"steps":[[327,"call","GetConfigurationIdByName",0],[337,"write",2000000292,"Insert"]]},{"name":"SetAsDefaultConfiguration","line":350,"kind":"procedure","access":"internal","params":1,"steps":[[362,"write",2000000292,"ModifyAll"],[365,"write",2000000292,"Modify"],[367,"call","GetDimensions",1]]},{"name":"ClearDefaultConfiguration","line":370,"kind":"procedure","access":"internal","params":0,"steps":[[377,"write",2000000292,"ModifyAll"],[381,"write",2000000292,"Modify"]]},{"name":"MarkSystemDefaultAsDefault","line":385,"kind":"procedure","access":"local","params":0,"steps":[[393,"write",2000000292,"Modify"]]},{"name":"ValidateConfiguration","line":405,"kind":"procedure","access":"internal","params":2,"steps":[[410,"call","FindWarningsForConfiguration",2],[421,"run","page",8359]]},{"name":"ApplyRecommendedActions","line":462,"kind":"procedure","access":"internal","params":1,"steps":[[468,"call","ApplyRecommendedAction",1]]},{"name":"CreateAPIPageTool","line":482,"kind":"procedure","access":"internal","params":3,"steps":[[490,"call","IsDefaultConfiguration",1],[493,"call","ValidateAPIPageTool",2],[499,"call","GetHighestAPIPageVersion",1],[500,"write",2000000293,"Insert"]]},{"name":"CreateAPIQueryTool","line":515,"kind":"procedure","access":"internal","params":2,"steps":[[523,"call","IsDefaultConfiguration",1],[526,"call","ValidateAPIQueryTool",1],[532,"call","GetHighestAPIQueryVersion",1],[533,"write",2000000293,"Insert"]]},{"name":"CreateAPICodeunitTool","line":537,"kind":"procedure","access":"internal","params":2,"steps":[[545,"call","IsDefaultConfiguration",1],[548,"call","ValidateAPICodeunitTool",1],[554,"call","GetHighestAPICodeunitVersion",1],[555,"write",2000000293,"Insert"]]},{"name":"DeleteTool","line":559,"kind":"procedure","access":"internal","params":1,"steps":[[566,"write",2000000293,"Delete"]]},{"name":"AllowRead","line":569,"kind":"procedure","access":"internal","params":2,"steps":[[580,"write",2000000293,"Modify"]]},{"name":"AllowCreate","line":583,"kind":"procedure","access":"internal","params":2,"steps":[[594,"call","CheckAllowCreateUpdateDeleteTools",1],[597,"write",2000000293,"Modify"]]},{"name":"AllowModify","line":600,"kind":"procedure","access":"internal","params":2,"steps":[[611,"call","CheckAllowCreateUpdateDeleteTools",1],[614,"write",2000000293,"Modify"]]},{"name":"AllowDelete","line":617,"kind":"procedure","access":"internal","params":2,"steps":[[628,"call","CheckAllowCreateUpdateDeleteTools",1],[631,"write",2000000293,"Modify"]]},{"name":"AllowActions","line":634,"kind":"procedure","access":"internal","params":2,"steps":[[645,"call","CheckAllowCreateUpdateDeleteTools",1],[648,"write",2000000293,"Modify"]]},{"name":"LookupAPIObjects","line":651,"kind":"procedure","access":"internal","params":3,"steps":[[656,"call","PopulateAPIObjects",1],[660,"ext","page",8376,"SetObjects",1],[668,"ext","page",8376,"GetSelectedObjects",1]]},{"name":"PopulateAPIObjects","line":672,"kind":"procedure","access":"local","params":1,"steps":[[677,"write",8357,"DeleteAll"],[680,"call","SetAPIPageFilters",1],[681,"call","AddAPIObjectsFromWebService",4],[685,"call","SetAPIQueryFilters",1],[686,"call","AddAPIObjectsFromWebService",4],[690,"call","SetAPICodeunitFilters",1],[691,"call","AddAPIObjectsFromWebService",4]]},{"name":"AddAPIObjectsFromWebService","line":694,"kind":"procedure","access":"local","params":4,"steps":[[700,"call","IsMicrosoftBetaAPI",1],[703,"write",8357,"Modify"],[713,"write",8357,"Insert"]]},{"name":"GetAPIPublishers","line":744,"kind":"procedure","access":"internal","params":1,"steps":[[746,"call","GetAPIPagePublishers",1],[747,"call","GetAPIQueryPublishers",1],[748,"call","GetAPICodeunitPublishers",1]]},{"name":"GetAPIPagePublishers","line":751,"kind":"procedure","access":"local","params":1,"steps":[[755,"call","SetAPIPageFilters",1],[762,"call","IsMicrosoftBetaAPI",1],[768,"write",8350,"Insert"]]},{"name":"GetAPIQueryPublishers","line":772,"kind":"procedure","access":"local","params":1,"steps":[[776,"call","SetAPIQueryFilters",1],[787,"write",8350,"Insert"]]},{"name":"GetAPICodeunitPublishers","line":791,"kind":"procedure","access":"local","params":1,"steps":[[795,"call","SetAPICodeunitFilters",1],[806,"write",8350,"Insert"]]},{"name":"LookupAPIPublisher","line":810,"kind":"procedure","access":"internal","params":3,"steps":[[812,"run","page",8356]]},{"name":"LookupAPIGroup","line":818,"kind":"procedure","access":"internal","params":3,"steps":[[824,"run","page",8356]]},{"name":"ResolvePublisherForGroup","line":828,"kind":"procedure","access":"internal","params":3,"steps":[[848,"run","page",8356]]},{"name":"AddToolsByAPIGroup","line":912,"kind":"procedure","access":"internal","params":1,"steps":[[922,"ext","page",8354,"GetAPIGroup",0],[923,"ext","page",8354,"GetAPIPublisher",0],[928,"call","AddAPIPageTools",3],[929,"call","AddAPIQueryTools",3],[930,"call","AddAPICodeunitTools",3]]},{"name":"AddAPIPageTools","line":933,"kind":"procedure","access":"local","params":3,"steps":[[938,"call","SetAPIPageFilters",1],[946,"call","IsMicrosoftBetaAPI",1],[948,"call","CheckAPIToolExists",3],[949,"call","CreateAPIPageTool",3]]},{"name":"AddAPIQueryTools","line":953,"kind":"procedure","access":"local","params":3,"steps":[[958,"call","SetAPIQueryFilters",1],[966,"call","CheckAPIToolExists",3],[967,"call","CreateAPIQueryTool",2]]},{"name":"AddAPICodeunitTools","line":971,"kind":"procedure","access":"local","params":3,"steps":[[976,"call","SetAPICodeunitFilters",1],[984,"call","CheckAPIToolExists",3],[985,"call","CreateAPICodeunitTool",2]]},{"name":"AddStandardAPITools","line":989,"kind":"procedure","access":"internal","params":1,"steps":[[994,"call","SetAPIPageFilters",1],[1000,"call","CheckAPIToolExists",3],[1001,"call","CreateAPIPageTool",3],[1005,"call","SetAPIQueryFilters",1],[1011,"call","CheckAPIToolExists",3],[1012,"call","CreateAPIQueryTool",2]]},{"name":"ValidateAPIPageVersion","line":1049,"kind":"procedure","access":"internal","params":2,"steps":[[1055,"call","CollectAPIObjectVersions",3]]},{"name":"ValidateAPIQueryVersion","line":1063,"kind":"procedure","access":"internal","params":2,"steps":[[1069,"call","CollectAPIObjectVersions",3]]},{"name":"ValidateAPICodeunitVersion","line":1077,"kind":"procedure","access":"internal","params":2,"steps":[[1083,"call","CollectAPIObjectVersions",3]]},{"name":"LookupAPIPageVersions","line":1091,"kind":"procedure","access":"internal","params":2,"steps":[[1096,"call","LookupAPIObjectVersions",4]]},{"name":"LookupAPIQueryVersions","line":1099,"kind":"procedure","access":"internal","params":2,"steps":[[1104,"call","LookupAPIObjectVersions",4]]},{"name":"LookupAPICodeunitVersions","line":1107,"kind":"procedure","access":"internal","params":2,"steps":[[1112,"call","LookupAPIObjectVersions",4]]},{"name":"GetHighestAPIPageVersion","line":1115,"kind":"procedure","access":"internal","params":1,"steps":[[1120,"call","GetHighestAPIObjectVersion",3]]},{"name":"GetHighestAPIQueryVersion","line":1123,"kind":"procedure","access":"internal","params":1,"steps":[[1128,"call","GetHighestAPIObjectVersion",3]]},{"name":"GetHighestAPICodeunitVersion","line":1131,"kind":"procedure","access":"internal","params":1,"steps":[[1136,"call","GetHighestAPIObjectVersion",3]]},{"name":"GetHighestAPIObjectVersion","line":1149,"kind":"procedure","access":"local","params":3,"steps":[[1153,"call","CollectAPIObjectVersions",3],[1157,"call","GetHighestVersion",1]]},{"name":"LookupAPIObjectVersions","line":1160,"kind":"procedure","access":"local","params":4,"steps":[[1166,"call","CollectAPIObjectVersions",3],[1169,"write",8354,"Insert"],[1172,"run","page",8366]]},{"name":"CollectAPIObjectVersions","line":1176,"kind":"procedure","access":"local","params":3,"steps":[[1184,"call","IsMicrosoftBetaAPI",1]]},{"name":"GetHighestVersion","line":1190,"kind":"procedure","access":"local","params":1,"steps":[[1206,"call","TryParseVersion",3]]},{"name":"CreateVSCodeEntraApplication","line":1249,"kind":"procedure","access":"internal","params":0,"steps":[[1259,"write",8351,"Insert"]]},{"name":"ShowConnectionString","line":1262,"kind":"procedure","access":"internal","params":1,"steps":[[1267,"call","GenerateConnectionString",1],[1268,"ext","page",8358,"SetConnectionString",2]]},{"name":"GenerateConnectionString","line":1273,"kind":"procedure","access":"internal","params":1,"steps":[[1284,"ext","codeunit",457,"IsSaaS",0],[1287,"call","GetMCPUrlAndPrefix",3],[1290,"ext","codeunit",433,"GetAadTenantId",0],[1291,"ext","codeunit",457,"GetEnvironmentName",0],[1294,"call","BuildConnectionStringJson",7]]},{"name":"GetMCPUrlAndPrefix","line":1297,"kind":"procedure","access":"local","params":3,"steps":[[1310,"call","IsTIEEnvironment",0]]},{"name":"IsTIEEnvironment","line":1319,"kind":"procedure","access":"local","params":0,"steps":[[1323,"ext","codeunit",3060,"AreURIsHaveSameHost",2]]},{"name":"BuildConnectionStringJson","line":1326,"kind":"procedure","access":"local","params":7,"steps":[[1342,"call","EncodeForMCPHeaderIfNonAscii",1],[1343,"call","EncodeForMCPHeaderIfNonAscii",1]]},{"name":"EncodeForMCPHeaderIfNonAscii","line":1349,"kind":"procedure","access":"internal","params":1,"steps":[[1354,"ext","codeunit",3960,"IsMatch",2],[1357,"ext","codeunit",4110,"ToBase64",2]]},{"name":"CreateEntraApplication","line":1360,"kind":"procedure","access":"internal","params":3,"steps":[[1367,"write",8351,"Insert"]]},{"name":"DeleteEntraApplication","line":1370,"kind":"procedure","access":"internal","params":1,"steps":[[1377,"write",8351,"Delete"]]},{"name":"ExportConfigurationToFile","line":1382,"kind":"procedure","access":"internal","params":2,"steps":[[1389,"ext","codeunit",4100,"CreateOutStream",2],[1390,"call","ExportConfiguration",2],[1391,"ext","codeunit",4100,"CreateInStream",2]]},{"name":"ImportConfigurationFromFile","line":1396,"kind":"procedure","access":"internal","params":0,"steps":[[1410,"ext","codeunit",4100,"CreateOutStream",2],[1412,"ext","codeunit",4100,"CreateInStream",2],[1414,"call","GetConfigFromJson",3],[1419,"ext","page",8355,"SetConfigName",1],[1420,"ext","page",8355,"SetConfigDescription",1],[1421,"ext","page",8355,"SetInstructionMessage",1],[1425,"ext","page",8355,"GetConfigName",0],[1426,"ext","page",8355,"GetConfigDescription",0],[1429,"ext","codeunit",4100,"CreateInStream",2],[1430,"call","ImportConfiguration",3]]},{"name":"ImportConfiguration","line":1494,"kind":"procedure","access":"internal","params":3,"steps":[[1524,"call","ConfirmDataQueryToolsOnImport",1],[1526,"write",2000000292,"Insert"],[1527,"call","LogConfigurationCreated",1],[1532,"call","ImportTool",2]]},{"name":"ImportTool","line":1552,"kind":"procedure","access":"local","params":2,"steps":[[1591,"write",2000000293,"Insert"]]},{"name":"TriggerNoActiveConfigsFeedback","line":1596,"kind":"procedure","access":"internal","params":0,"steps":[[1603,"ext","codeunit",1590,"WithCustomQuestion",2],[1604,"ext","codeunit",1590,"RequestDislikeFeedback",3],[1606,"call","GetTelemetryCategory",0]]},{"name":"TriggerGeneralFeedback","line":1609,"kind":"procedure","access":"internal","params":0,"steps":[[1613,"ext","codeunit",1590,"RequestFeedback",3],[1615,"call","GetTelemetryCategory",0]]},{"name":"GetDimensions","line":1629,"kind":"procedure","access":"local","params":1,"steps":[[1631,"call","GetTelemetryCategory",0]]},{"name":"LogConfigurationCreated","line":1645,"kind":"procedure","access":"internal","params":1,"steps":[[1647,"call","GetDimensions",1]]},{"name":"LogConfigurationModified","line":1651,"kind":"procedure","access":"internal","params":2,"steps":[[1655,"call","GetTelemetryCategory",0]]},{"name":"LogConfigurationDeleted","line":1685,"kind":"procedure","access":"internal","params":1,"steps":[[1687,"call","GetDimensions",1]]}]}