IA e MCP

A biblioteca é documentada para desenvolvedores e para agentes de IA a partir da mesma fonte: o JSDoc dos componentes e as stories do Storybook.

O que um agente encontra

• Manifest de componentes (manifests/components.json): descrições, props com tipos e valores padrão, e exemplos.
• Guias (manifests/docs.json): páginas de documentação sobre componentes e temas.
• Servidor MCP do Storybook, com ferramentas para consultar guias, componentes e exemplos.
• Storybook publicado em /storybook/: as mesmas stories, com controles para testar as props, a barra de marca × modo × densidade e o código de cada exemplo. É a fonte do manifest e do MCP.

Conectar ao MCP do portal

O portal publica os manifests em /manifests/components.json e /manifests/docs.json, e um servidor MCP (HTTP streamable, só leitura) responde em https://ui.idplugger.com/mcp, sempre com a documentação da versão publicada do portal:

claude mcp add --transport http idplugger-ui https://ui.idplugger.com/mcp

Em outros clientes (Cursor, VS Code, Codex), cadastre um servidor MCP do tipo HTTP com essa URL.

Conferir no Storybook

O Storybook publicado é o mesmo build que gera os manifests e o MCP, na mesma versão do portal. Use-o para ver uma story ao vivo, mexer nas props pelos controles e conferir o que o agente recebeu de docs-show. Cada página de componente do portal tem o link Abrir no Storybook.

Regras para agentes

• Nunca invente props: confirme em docs-show antes de usar.
• Se a prop não está documentada nem aparece numa story, não assuma: pergunte.
• Para trocar a marca, use o contrato --color-brand-* ou um preset; não sobrescreva tokens de componente.