Agentes · API y MCP
Tu design system, Agentico
Grails fue pensado desde los cimientos para que tu Design System soporte flujos agénticos.
Las herramientas MCP están específicamente diseñadas para proveer a agentes de diseño y desarrollo con el contexto exacto de tu DS, evitando saturación de contexto y optimizando el uso de tokens.
Durante la alpha cerrada, el acceso a la API y a MCP se activa por equipo. Para pedirlo, escribe a support [at] grails.design.
Tu librería de Figma
Grails
Figma Agent
Tu canvas
Conectar
Un comando o un archivo de configuración.
La misma API key abre MCP y REST. Agrega Grails a tu agente como servidor MCP con la URL y un header Authorization.
- Puede conectarse cualquier cliente MCP que admita Streamable HTTP y te deje definir un header Authorization: Claude Code, Cursor, Claude Desktop, VS Code y Gemini CLI, entre otros.
claude mcp add --transport http grails https://api.grails.design/mcp/v1 \
--header "Authorization: Bearer grails_sk_XXXXXXXX"{
"mcpServers": {
"grails": {
"type": "http",
"url": "https://api.grails.design/mcp/v1",
"headers": { "Authorization": "Bearer grails_sk_XXXXXXXX" }
}
}
}La API key es el marcador grails_sk_XXXXXXXX: crea la tuya en Team settings cuando tu equipo tenga acceso.
Qué puede usar un agente
Unas dos docenas de herramientas, en cinco grupos.
Cada herramienta lleva una descripción que el agente lee antes de llamarla. Los mismos datos están disponibles también por REST.
Buscar y leer
Busca por una frase o por un id, lista el catálogo con filtros y lee una entidad con la profundidad que necesites.
- findEntities
- listEntities
- getEntities
Construir
El spec de una variante y el orden para construir un componente compuesto.
- getComponentSpec
- getComponentBuildOrder
Tokens y estilos
Un mapa de las colecciones, sus modos y los tipos de estilo, y una comprobación de lo que llevaría un export DTCG. Los nombres y valores salen de listar el catálogo.
- describeTokens
- describeTokenExport
- describeStyles
Grafo y salud
Qué depende de qué, y qué componentes están desincronizados.
- getEntityGraph
- checkHealth
Documentación
Lee páginas y bloques. Con un scope de escritura, crea, actualiza y elimina páginas, escribe bloques, sube imágenes y organiza carpetas.
- getEntityDocumentation
- getDocumentationPage
- listDocumentationPages
- writeDocumentationBlocks
- createDocumentationPage
- describeDocumentationBlockTypes
- + 7 más
También REST
¿Prefieres una URL? REST sirve los mismos datos en
Referencia de la APIapi.grails.design/v1, descritos por un documento OpenAPI 3.1. Los scripts de build y las comprobaciones de CI pueden usarlo.
Keys y scopes
Una key por persona, tres scopes.
Una key lleva un conjunto de scopes, y la comprobación de scopes es exacta. Una key que lee tu design system y no puede tocar tu documentación es read:library más read:docs.
read:library
Componentes y sus specs, orden de construcción, tokens y sus valores por modo, estilos, el grafo, la salud y el drift, y el fragmento de documentación que coincidió con una búsqueda.
read:docs
La documentación en sí: bloques, con sus menciones resueltas. También valida una escritura, con un dry run que no escribe nada.
write:docs
Crea, actualiza y elimina documentación. Es el único scope que puede cambiar o destruir algo: todo lo demás es de solo lectura.
Sobre las keys
- Cualquier admin o editor crea su propia key, en Team settings → Integrations → Manage API keys.
- El secreto se muestra una sola vez y nunca se guarda: Grails conserva solo un hash.
- Una key vence a los 90 días por defecto, y recibes un correo antes de que ocurra.
- Quitar a un miembro del equipo elimina sus keys.
Dale a tus agentes el design system real.
Pide acceso, crea una key y conecta tu agente. Grails responde desde tu propia librería.
Durante la alpha trabajamos uno a uno con cada equipo para mejorar el producto. El acceso en este período es solo a pedido.