MCP-Server und Inspector¶
Das Portal stellt seine Aktionen über einen Model-Context-Protocol-(MCP-)Server bereit. Dieselben Aktionen treiben die KI-Agenten an. Ein Entwickler kann auch einen Editor oder einen anderen Agenten damit verbinden und die Tools des Portals aus der täglichen Entwicklungsumgebung aufrufen.
Endpunkt¶
| Pfad | /api/mcp-actions/v1 auf der eigenen URL des Portals, zum Beispiel https://<portal-host>/api/mcp-actions/v1 |
| Transport | HTTP, wie vom Backstage-MCP-Actions-Backend bereitgestellt |
| Server | Das Backstage-MCP-Actions-Backend. Jedes Backend-Plugin registriert seine Tools als Actions. Tool-Namen haben kein Plugin-Präfix. |
| Lokale Entwicklung | http://localhost:7007/api/mcp-actions/v1 |
Beispielkonfiguration für einen Editor, der HTTP-MCP-Server unterstützt (lokales Portal gezeigt):
{
"servers": {
"portal": {
"url": "http://localhost:7007/api/mcp-actions/v1",
"type": "http"
}
}
}
Um die Tools eines Servers manuell aufzulisten, sende die MCP-Anfrage tools/list mit einem Authorization: Bearer <token>-Header. Der unten beschriebene Inspector macht dasselbe aus dem Browser.
Authentifizierung¶
| Mechanismus | Detail |
|---|---|
| Statisches Token | Die Konfiguration kann ein statisches Token für externe Aufrufer definieren, mit einem Subject für MCP-Clients. Das Token kommt aus einer App-Einstellung. Die Referenzkonfiguration der eigenen Umgebung des Anbieters tut das. |
| OAuth | Das Portal aktiviert Dynamic Client Registration und Client-ID-Metadatendokumente in seinem Auth-Backend, damit sich MCP-Clients als Benutzer anmelden können |
Tools laufen mit der Identität des Aufrufers, soweit das Token einen Benutzer trägt. Der eigentümerbasierte Zugriff gilt für MCP-Aufrufe genauso wie für die Webseiten (Authentifizierung und Zugriff). Welchen Mechanismus deine Clients nutzen, ist eine Plattform-Entscheidung. Frag dein Plattform-Team nach der URL und der Art der Authentifizierung.
Tools¶
Die Tools stammen aus diesen Plugins. Welche verfügbar sind, hängt von den in deiner Umgebung aktivierten Features ab.
| Bereich | Tools |
|---|---|
| Catalog und Suche | Die Tools der Backstage-Catalog-Actions und query, das alle indizierten Dokumenttypen und TechDocs durchsucht |
| Kosten | get-azure-costs (Kosten gruppiert nach Entity und Zeitauflösung) |
| 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 |
| Netzwerk | get-firewall-blocked-requests, get-application-gateway-logs |
| Spoke-Konfiguration | 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 |
| Konfiguration der Integrationsplattform | integration-list-files, integration-get-file-content, integration-validate-platform-config, integration-create-pr, integration-update-branch |
| Agent-Unterstützung | get-skill (lädt die Anweisungen eines Skills), current-date |
Die Spoke- und Integrations-Tools existieren nur, wenn der entsprechende Agent konfiguriert ist, weil sie die Repository-Einstellungen dieses Agenten brauchen. Tools, die pull requests erstellen, brauchen Schreibzugriff der Portal-Identität auf das Repository.
MCP Inspector¶
Die Seite MCP Inspector (unten im Menü, aktiviert mit dem Feature-Flag features.mcp_inspector) verbindet sich aus deinem
Browser mit einer MCP-Server-URL, die du eingibst. Sie listet die Tools, Ressourcen und Prompts des Servers auf, lässt dich ein Tool
mit eigener Eingabe aufrufen und zeigt das Verbindungslog. Nutze sie, um zu prüfen, was ein Tool zurückgibt, bevor du dich in einem Agenten darauf verlässt,
und um nach einem Deployment zu prüfen, dass die Tool-Liste nicht leer ist.