Cómo funciona
Prism, la consola de los clientes, sirve un punto de acceso MCP en https://app.gluonify.io/mcp (JSON-RPC sobre HTTP, solo herramientas). Cada herramienta ejecuta el mismo código que la pantalla correspondiente de Prism, con los mismos controles: solo su organización, los roles del token y las aplicaciones que usted eligió. Gauge sigue siendo el servidor MCP de los operadores de la plataforma.
Antes de empezar
- Una cuenta de propietario (org:owner) de su organización en Prism: solo un propietario crea, lista y revoca los tokens de IA.
- Un repositorio que el builder sepa compilar, o una aplicación ya desplegada en la plataforma.
- Un cliente MCP compatible con HTTP «Streamable» y un token portador, como Claude Code.
- curl y jq para intercambiar el secreto del token (o cualquier cliente HTTP).
1. Crear un token de IA en Prism
En Prism, abra Accesos y luego la sección Tokens de IA:
- Dé un nombre al token (el asistente o el proyecto al que sirve).
- Marque sus roles, agrupados por repositorios (leer, cambiar, poner tokens Git), pipelines (leer, lanzar, aprobar promociones), aplicaciones (leer, suspender y despertar, eliminar, volver a una versión, redimensionar), configuración (leer, cambiar), secretos (solo escritura), consumo y contrato (leer, sin precios) y métricas (leer). Marque solo lo que el asistente necesita.
- Conserve todas las aplicaciones de la organización, o elija algunas: el token solo alcanza entonces esas, en todas partes.
- Elija su duración, de 1 a 90 días, y deje marcada «Las acciones destructivas esperan aquí la aprobación de un propietario».
- Créelo, copie enseguida su secreto (gai_…) y guárdelo en el almacén de secretos de su cliente: Prism solo lo muestra una vez.
2. Intercambiar el secreto por un token de acceso
El secreto no se envía al propio punto de acceso MCP: el cliente lo intercambia por un token de acceso corto (unos diez minutos) y luego usa ese token. Prism reenvía el intercambio a Charm, así que el cliente solo necesita la dirección de Prism:
Intercambio (el secreto en GLUONIFY_AI_TOKEN, el token de acceso en 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)Cuando el token de acceso caduque (401), intercambie de nuevo el secreto. Un token de IA revocado o caducado ya no se intercambia. Prism nunca registra el secreto.
3. Conectar su cliente MCP
Declare Prism como servidor MCP HTTP, con el token de acceso en la cabecera Authorization:
Configuración del cliente MCP (por ejemplo .mcp.json para Claude Code)
{ "mcpServers": { "gluonify": { "type": "http", "url": "https://app.gluonify.io/mcp", "headers": { "Authorization": "Bearer ${GLUONIFY_ACCESS_TOKEN}" } } } }Para comprobar la conexión, liste las herramientas a mano: solo se listan las que permiten los roles del token.
Listar las herramientas
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"}'Lo que el asistente puede hacer
- Repositorios: repos_list, repo_get, repo_set (URL, rama, subdirectorio), repo_git_token_set (solo escritura, nunca se vuelve a leer), workflows_standard_copy (copia los workflows estándar Build y Promotion en su repositorio, en una rama nueva para fusionar).
- Pipelines: pipelines_list, pipeline_set (Build o Promotion, referencia Git, cuatro ojos), build_start, build_cancel, builds_list, build_logs, executions_list, execution_get, approval_decide (de QUA a PRD).
- Aplicaciones: apps_list, app_status, app_logs, app_sleep (congelada o detenida), app_wake, app_sleep_settings, app_delete.
Las herramientas MCP propias de su aplicación
Una aplicación del cliente puede exponer sus propias herramientas MCP. La plataforma las retransmite a su asistente de IA por el punto de acceso MCP de Prism, con el nombre <code>app__<aplicación>__<herramienta></code>.
Java (Quarkus)
Añada la dependencia <code>io.gluonify.plasma:gluonify-plasma-mcp</code> y anote un método público de un bean que implemente <code>McpToolbox</code> con <code>@McpTool(name, description, write = false)</code>. Los argumentos son un 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
Importe <code>mcp_tool</code> desde <code>gluonify.fastapi</code>, decore una función y llame a <code>create_app(..., mcp=True)</code>.
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)- El builder detecta el SDK y despliega la aplicación con MCP activado.
- Las herramientas de lectura requieren el permiso de IA para leer aplicaciones. Las de escritura se proponen a un propietario para su aprobación (en producción).
- La aplicación solo acepta las llamadas retransmitidas por la plataforma.
- Límites: 50 herramientas, argumentos de 64 KiB, respuesta de 256 KiB, 10 s por llamada.
- Las herramientas aparecen en la consola (vista de la aplicación, «Herramientas MCP») y un propietario puede actualizarlas.
Las salvaguardas
Un token de IA no es una persona: Prism lo limita aún más.
- Nunca un poder de propietario: un token de IA no gestiona los accesos, los tokens de IA, la auditoría ni los dominios, nunca ve un precio, y solo funciona en el punto de acceso MCP.
- Solo su organización, y solo las aplicaciones elegidas: todo lo demás responde como si no existiera.
- Sin autoaprobación: un token nunca aprueba la promoción de una ejecución que él mismo inició.
- Un límite de llamadas por token (60 por minuto y 1000 por hora por defecto); más allá, el cliente debe esperar.
- Modo aprobación: eliminar una aplicación, aprobar una promoción, poner un token Git, escribir o eliminar un secreto, volver a una versión o redimensionar una aplicación se convierte en una propuesta que un propietario aprueba o rechaza en Accesos; aprobada, se ejecuta con los roles del propio token.
Auditoría
Cada llamada de un token de IA queda registrada en el módulo Auditoría de Prism: qué token (su nombre), qué herramienta, qué aplicación y el resultado, nunca un secreto. Marque «Solo tokens de IA» para ver solo esas. La lista de tokens muestra su último uso.
Buenas prácticas
- Un token por asistente y por proyecto, con los menos roles posibles y una duración corta.
- Empiece por los roles de lectura y luego añada los cambios que realmente quiera.
- Conserve el modo aprobación para las acciones destructivas y apruebe usted mismo las promociones.
- Revoque un token en cuanto deje de usarse, o si su secreto pudo filtrarse.
Partir de gluonify-source
gluonify-source es la aplicación de partida para los clientes: un servicio Quarkus en el que cada decisión está explicada, con un CLAUDE.md que resume las reglas de la plataforma para un asistente de IA. Inicie su asistente a partir de él y luego conéctelo a Prism para compilar y desplegar lo que escribe.
¿Y Gauge?
Gauge es el servidor MCP de los operadores de la plataforma, con sus propios roles y políticas. Como cliente, usted conecta su asistente a Prism, que lo mantiene todo dentro de su organización.
Límites
El modo aprobación, las propuestas y los contadores de llamadas se guardan en memoria en cada réplica de Prism: tras un reinicio, un token vuelve al modo aprobación. El consumo, el contrato y las cuotas abarcan toda la organización: un token limitado a algunas aplicaciones no puede leerlos. El punto de acceso MCP solo responde en JSON (sin flujo de eventos).