So funktioniert es
Prism, die Konsole der Kunden, stellt unter https://app.gluonify.io/mcp einen MCP-Endpunkt bereit (JSON-RPC über HTTP, nur Werkzeuge). Jedes Werkzeug führt denselben Code aus wie die entsprechende Ansicht von Prism, mit denselben Prüfungen: nur Ihre Organisation, die Rollen des Tokens und die Anwendungen, die Sie gewählt haben. Gauge bleibt der MCP-Server der Betreiber der Plattform.
Bevor Sie beginnen
- Ein Eigentümerkonto (org:owner) Ihrer Organisation in Prism: Nur ein Eigentümer erstellt, listet und widerruft KI-Token.
- Ein Repository, das der Builder bauen kann, oder eine bereits auf der Plattform bereitgestellte Anwendung.
- Ein MCP-Client mit Unterstützung für „Streamable HTTP“ und ein Bearer-Token, etwa Claude Code.
- curl und jq, um das Geheimnis des Tokens zu tauschen (oder ein beliebiger HTTP-Client).
1. Ein KI-Token in Prism erstellen
Öffnen Sie in Prism Zugriff und dann den Abschnitt KI-Token:
- Geben Sie dem Token einen Namen (den Assistenten oder das Projekt, dem es dient).
- Kreuzen Sie seine Rollen an, gruppiert nach Repositories (lesen, ändern, Git-Token setzen), Pipelines (lesen, starten, Promotionen freigeben), Anwendungen (lesen, schlafen legen und aufwecken, löschen, zurücksetzen, Größe ändern), Konfiguration (lesen, ändern), Geheimnisse (nur schreiben), Verbrauch und Vertrag (lesen, ohne Preise) und Metriken (lesen). Kreuzen Sie nur an, was der Assistent braucht.
- Behalten Sie alle Anwendungen der Organisation oder wählen Sie einige: Das Token erreicht dann nur diese, überall.
- Wählen Sie seine Dauer, 1 bis 90 Tage, und lassen Sie „Destruktive Aktionen warten hier auf die Zustimmung eines Eigentümers“ angehakt.
- Erstellen Sie es, kopieren Sie sofort sein Geheimnis (gai_…) und legen Sie es im Geheimnisspeicher Ihres Clients ab: Prism zeigt es nur einmal.
2. Das Geheimnis gegen ein Zugriffstoken tauschen
Das Geheimnis wird nicht an den MCP-Endpunkt selbst gesendet: Der Client tauscht es gegen ein kurzes Zugriffstoken (etwa zehn Minuten) und verwendet dann dieses. Prism reicht den Tausch an Charm weiter, sodass der Client nur die Adresse von Prism braucht:
Tausch (das Geheimnis in GLUONIFY_AI_TOKEN, das Zugriffstoken in GLUONIFY_ACCESS_TOKEN)
export GLUONIFY_ACCESS_TOKEN=$(curl -s -X POST https://app.gluonify.io/api/v1/ai/exchange \
-H 'Content-Type: application/json' \
-d "{\"refreshToken\":\"$GLUONIFY_AI_TOKEN\"}" | jq -r .access_token)Wenn das Zugriffstoken abläuft (401), tauschen Sie das Geheimnis erneut. Ein widerrufenes oder abgelaufenes KI-Token lässt sich nicht mehr tauschen. Prism protokolliert das Geheimnis nie.
3. Ihren MCP-Client verbinden
Binden Sie Prism als HTTP-MCP-Server an, mit dem Zugriffstoken im Authorization-Header:
Konfiguration des MCP-Clients (zum Beispiel .mcp.json für Claude Code)
{ "mcpServers": { "gluonify": { "type": "http", "url": "https://app.gluonify.io/mcp", "headers": { "Authorization": "Bearer ${GLUONIFY_ACCESS_TOKEN}" } } } }Um zu prüfen, ob sich der Client anbinden ließ, listen Sie die Werkzeuge von Hand: Es erscheinen nur die Werkzeuge, die die Rollen des Tokens erlauben.
Werkzeuge auflisten
curl -s https://app.gluonify.io/mcp -H "Authorization: Bearer $GLUONIFY_ACCESS_TOKEN" \
-H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Was der Assistent tun kann
- Repositorys: repos_list, repo_get, repo_set (URL, Branch, Unterverzeichnis), repo_git_token_set (nur schreibend, nie wieder gelesen), workflows_standard_copy (kopiert die Standard-Workflows Build und Promotion in Ihr Repository, auf einen neuen Branch zum Zusammenführen).
- Pipelines: pipelines_list, pipeline_set (Build oder Promotion, Git-Referenz, Vier-Augen-Prinzip), build_start, build_cancel, builds_list, build_logs, executions_list, execution_get, approval_decide (von QUA nach PRD).
- Anwendungen: apps_list, app_status, app_logs, app_sleep (eingefroren oder gestoppt), app_wake, app_sleep_settings, app_delete.
Die eigenen MCP-Werkzeuge Ihrer Anwendung
Eine Kundenanwendung kann eigene MCP-Werkzeuge bereitstellen. Die Plattform leitet sie über den MCP-Endpunkt von Prism als <code>app__<Anwendung>__<Werkzeug></code> an Ihren KI-Assistenten weiter.
Java (Quarkus)
Fügen Sie die Abhängigkeit <code>io.gluonify.plasma:gluonify-plasma-mcp</code> hinzu und annotieren Sie eine öffentliche Methode einer Bean, die <code>McpToolbox</code> implementiert, mit <code>@McpTool(name, description, write = false)</code>. Die Argumente bilden ein Record.
// pom.xml: io.gluonify.plasma:gluonify-plasma-mcp
@ApplicationScoped
public class OrdersToolbox implements McpToolbox {
public record OrderQuery(String customer, int limit) {}
@McpTool(name = "orders_list", description = "List the latest orders of a customer", write = false)
public List<Order> ordersList(OrderQuery query) {
return orders.latest(query.customer(), query.limit());
}
}Python
Importieren Sie <code>mcp_tool</code> aus <code>gluonify.fastapi</code>, dekorieren Sie eine Funktion und rufen Sie <code>create_app(..., mcp=True)</code> auf.
from gluonify.fastapi import create_app, mcp_tool
@mcp_tool(name="orders_list", description="List the latest orders of a customer", write=False)
def orders_list(customer: str, limit: int = 10) -> list[dict]:
return latest_orders(customer, limit)
app = create_app(__name__, mcp=True)- Der Builder erkennt das SDK und stellt die Anwendung mit aktiviertem MCP bereit.
- Lesewerkzeuge benötigen die KI-Berechtigung zum Lesen von Anwendungen. Schreibwerkzeuge werden einem Eigentümer zur Genehmigung vorgeschlagen (in Produktion).
- Die Anwendung akzeptiert nur von der Plattform weitergeleitete Aufrufe.
- Grenzen: 50 Werkzeuge, Argumente 64 KiB, Antwort 256 KiB, 10 s pro Aufruf.
- Die Werkzeuge erscheinen in der Konsole (Anwendungsansicht, „MCP-Werkzeuge“); ein Eigentümer kann sie aktualisieren.
Die Schutzmechanismen
Ein KI-Token ist keine Person: Prism schränkt es weiter ein.
- Nie eine Eigentümerbefugnis: ein KI-Token verwaltet weder Zugriffe noch KI-Token, Audit oder Domains, sieht nie einen Preis und funktioniert nur am MCP-Endpunkt.
- Nur Ihre Organisation und nur die gewählten Anwendungen: Alles andere antwortet, als gäbe es es nicht.
- Keine Selbstfreigabe: Ein Token gibt nie die Promotion einer Ausführung frei, die es selbst gestartet hat.
- Eine Grenze an Aufrufen pro Token (standardmäßig 60 pro Minute und 1000 pro Stunde); darüber muss der Client warten.
- Freigabemodus: eine Anwendung löschen, eine Promotion freigeben, ein Git-Token setzen, ein Geheimnis schreiben oder löschen, eine Anwendung zurücksetzen oder ihre Größe ändern wird zu einem Vorschlag, den ein Eigentümer unter Zugriff annimmt oder ablehnt; angenommen, läuft er mit den Rollen des Tokens selbst.
Audit
Jeder Aufruf eines KI-Tokens wird im Audit-Modul von Prism festgehalten: welches Token (sein Name), welches Werkzeug, welche Anwendung und das Ergebnis, nie ein Geheimnis. Haken Sie „Nur KI-Token“ an, um nur diese zu sehen. Die Liste der Token zeigt ihre letzte Nutzung.
Gute Praxis
- Ein Token pro Assistent und Projekt, mit so wenigen Rollen wie möglich und einer kurzen Dauer.
- Beginnen Sie mit Leserollen und fügen Sie dann die Änderungen hinzu, die Sie wirklich wollen.
- Behalten Sie den Zustimmungsmodus für destruktive Aktionen bei und geben Sie Promotions selbst frei.
- Widerrufen Sie ein Token, sobald es nicht mehr gebraucht wird oder sein Geheimnis durchgesickert sein könnte.
Mit gluonify-source beginnen
gluonify-source ist die Startanwendung für Kunden: ein Quarkus-Dienst, in dem jede Entscheidung erklärt ist, mit einer CLAUDE.md, die die Regeln der Plattform für einen KI-Assistenten zusammenfasst. Starten Sie Ihren Assistenten damit und verbinden Sie ihn dann mit Prism, um zu bauen und zu deployen, was er schreibt.
Und Gauge?
Gauge ist der MCP-Server der Betreiber der Plattform, mit eigenen Rollen und Richtlinien. Als Kunde verbinden Sie Ihren Assistenten mit Prism, das alles in Ihrer Organisation hält.
Grenzen
Der Freigabemodus, die Vorschläge und die Aufrufzähler werden von jedem Replikat von Prism im Speicher gehalten: nach einem Neustart ist ein Token wieder im Freigabemodus. Verbrauch, Vertrag und Kontingente gelten für die ganze Organisation: ein auf einige Anwendungen beschränktes Token kann sie nicht lesen. Der MCP-Endpunkt antwortet nur mit JSON (kein Ereignisstrom).