Ferramentas MCP

Os agentes trabalham com cerca de 190 ferramentas: ler o documento, alterá-lo, gerar páginas inteiras, importar, exportar e escrever código.

1Por onde um agente deve começar

get_editor_state retorna o documento aberto, a página e a seleção. ToolSearch encontra a ferramenta certa por palavra-chave, então o agente não precisa da lista inteira de antemão.

2O fluxo em camadas

design_skeleton monta a moldura da página e as seções dela.
design_content preenche uma seção de cada vez.
design_refine faz o acabamento de uma página pronta.
finalize_design executa passes fixos de correção na página inteira.

As correções só mexem no que o agente gerou, nunca nas suas próprias camadas. Novas páginas são colocadas à direita do trabalho existente, e não por cima dele.

3Grupos de ferramentas

Grupo	Exemplos
Documento	`open_document`, `save_document`, `lint_document`, `get_design_quality`
Leitura	`read_nodes`, `find_node_by_name`, `snapshot_layout`, `find_empty_space`
Edição	`insert_node`, `update_node`, `move_node`, `replace_all_matching_properties`
Seleção	`set_selection`, `align_selected`, `group_selected`, `boolean_op`, `undo`
Páginas	`add_page`, `duplicate_page`, `reorder_page`, `set_active_page`
Componentes	`create_component`, `instantiate_component`, `add_library`, 37 ferramentas de kit `insert_*`
Variáveis	`set_variables`, `set_themes`, `apply_design_system`, `save_theme_preset`
Orientação	`get_design_md`, `get_style_guide`, `get_guidelines`
Geração	`batch_design`, `execute`, `generate`, `enrich_images`, `run_design_agent`
Importação	`import_svg`, `import_html`, `import_html_url`, `import_pen_dev`
Exportação	`get_screenshot`, `export_nodes`, `export_frames`, `export_deck`
Código	`codegen_export`, `codegen_plan`, `codegen_assemble`
Visualização	`set_screen`, `set_slide_transition`, `capture_preview`, `browser`

de tools mostra todas as ferramentas com seus parâmetros, e de <tool> key=value chama uma delas pelo terminal.

4Scripts

execute executa JavaScript sobre o documento. Um script inteiro é um único passo de desfazer, então um agente pode fazer cem alterações e você pode revertê-las com um só Cmd+Z.

5Imagens e vetores

generate cria imagens com IA, encontra fotos de banco de imagens, desenha SVG, vetoriza uma imagem, remove ou substitui um fundo. enrich_images preenche espaços de imagem vazios com fotos do Openverse e, se necessário, do Wikimedia.

6Widgets de formulário

Os agentes podem inserir controles de formulário funcionais: campos de texto, áreas de texto, campos numéricos, seletores, grupos de opções, interruptores, caixas de seleção, controles deslizantes, barras de progresso e abas.

DocumentaçãoAgentes e IA