MCP-server en inspector¶
Het portaal stelt zijn acties beschikbaar via een Model Context Protocol (MCP)-server. Dezelfde acties sturen de AI-agents aan. Een developer kan er ook een editor of een andere agent op aansluiten en de tools van het portaal aanroepen vanuit de dagelijkse ontwikkelomgeving.
Endpoint¶
| Pad | /api/mcp-actions/v1 op de eigen URL van het portaal, bijvoorbeeld https://<portal-host>/api/mcp-actions/v1 |
| Transport | HTTP, zoals aangeboden door de Backstage MCP actions-backend |
| Server | De Backstage MCP actions-backend. Elke backendplugin registreert zijn tools als actions. Toolnamen krijgen geen prefix van de plugin. |
| Lokale ontwikkeling | http://localhost:7007/api/mcp-actions/v1 |
Voorbeeldconfiguratie voor een editor die HTTP MCP-servers ondersteunt (lokaal portaal getoond):
{
"servers": {
"portal": {
"url": "http://localhost:7007/api/mcp-actions/v1",
"type": "http"
}
}
}
Om de tools van een server handmatig op te vragen, stuur je het MCP-verzoek tools/list met een Authorization: Bearer <token>-header. De Inspector hieronder doet hetzelfde vanuit een browser.
Authenticatie¶
| Mechanisme | Detail |
|---|---|
| Statisch token | De configuratie kan een statisch token voor externe aanroepers definiëren, met een subject voor MCP-clients. Het token komt uit een app setting. De referentieconfiguratie van de eigen omgeving van de leverancier doet dit. |
| OAuth | Het portaal schakelt dynamic client registration en client ID metadata documents in op zijn auth-backend, zodat MCP-clients als gebruiker kunnen aanmelden |
Tools draaien met de identity van de aanroeper, voor zover het token een gebruiker bevat. Toegang op basis van eigenaarschap geldt voor MCP-aanroepen op dezelfde manier als voor de webpagina's (Authenticatie en toegang). Welk mechanisme jouw clients gebruiken is een platformbeslissing. Vraag je platformteam om de URL en de manier van authenticeren.
Tools¶
De tools komen uit deze plugins. Welke beschikbaar zijn, hangt af van de functies die in jouw omgeving zijn ingeschakeld.
| Gebied | Tools |
|---|---|
| Catalog en zoeken | De tools van de Backstage catalog actions, en query, dat alle geïndexeerde documenttypen en TechDocs doorzoekt |
| Kosten | get-azure-costs (kosten gegroepeerd per entiteit en tijdsresolutie) |
| Security | get-azure-security-summary, get-azure-security-recommendations, get-azure-security-sync-status |
| Compliance | get-azure-regulatory-compliance-status, get-azure-regulatory-compliance-policies, get-azure-regulatory-compliance-sync-status |
| Netwerk | get-firewall-blocked-requests, get-application-gateway-logs |
| Spokeconfiguratie | spoke-list-files, spoke-get-file-content, spoke-get-json-schema, spoke-get-cidrs, spoke-check-cidr-availability, spoke-get-next-free-cidr, spoke-validate-json, spoke-create-pr |
| Configuratie van het integratieplatform | integration-list-files, integration-get-file-content, integration-validate-platform-config, integration-create-pr, integration-update-branch |
| Agentondersteuning | get-skill (laadt de instructies van een skill), current-date |
De spoke- en integratietools bestaan alleen wanneer de bijbehorende agent is geconfigureerd, omdat ze de repositoryinstellingen van die agent nodig hebben. Tools die pull requests aanmaken, hebben schrijftoegang van de identity van het portaal op de repository nodig.
MCP inspector¶
De pagina MCP Inspector (onderaan het menu, ingeschakeld met de feature flag features.mcp_inspector) maakt vanuit je
browser verbinding met een MCP-server-URL die je invoert. Hij toont de tools, resources en prompts van de server, laat je een tool
aanroepen met je eigen invoer en toont het verbindingslog. Gebruik hem om te controleren wat een tool teruggeeft voordat je erop vertrouwt in een agent,
en om na een uitrol te controleren dat de toollijst niet leeg is.