For the complete documentation index, see llms.txt. This page is also available as Markdown.

MCP do Dynamo

MCP significa Model Context Protocol (Protocolo de Contexto de Modelo). É um padrão aberto que permite que modelos de IA se conectem ao software por meio de um protocolo comum. Um servidor MCP disponibiliza as ferramentas e os dados de um programa para que um cliente de IA possa ler o contexto em tempo real, executar ações e retornar resultados estruturados.

O DynamoMCP é o servidor MCP integrado do Dynamo. Ele conecta o Autodesk Assistant à sessão ativa do Dynamo (gráfico, nós, conexões e estado do espaço de trabalho) para que a ajuda da IA seja baseada naquilo em que você está realmente trabalhando.

Para quem usa o Dynamo, isso significa que o Assistant pode fazer mais do que responder a perguntas gerais. Ele pode inspecionar o gráfico aberto, ajudar a solucionar problemas com nós e atualizar a tela com base no contexto real da sessão, em vez de copiar e colar manualmente.

O DynamoMCP está disponível no Dynamo 4.2.0 e versões posteriores.

Como usar o DynamoMCP

Você usa o DynamoMCP por meio do Autodesk Assistant; não há configuração separada nem interface independente. O Assistant é o ponto de entrada para fazer perguntas, obter ajuda com o gráfico e permitir que a IA trabalhe com o contexto ativo do Dynamo.

O local onde você abre o Assistant depende do ambiente em que está trabalhando:

  • Dynamo Sandbox — as ferramentas do DynamoMCP estão disponíveis no Autodesk Assistant dentro do Dynamo.

  • Revit — as ferramentas do DynamoMCP estão disponíveis no Autodesk Assistant dentro do Revit.

Em ambos os casos, você permanece na sessão atual e usa a mesma experiência do Assistant para acessar o DynamoMCP.

O que o DynamoMCP pode fazer

O DynamoMCP fornece ao Assistant um conjunto de ferramentas. Cada ferramenta executa uma tarefa no Dynamo, como ler a tela, colocar um nó ou executar o gráfico. Você nunca chama essas ferramentas diretamente. Basta descrever o que deseja em linguagem simples, e o Assistant selecionará as ferramentas necessárias.

Ainda assim, conhecer essas ferramentas é útil. Isso permite entender o que o Assistant é capaz de fazer e ajuda você a formular solicitações que ele possa executar.

Nomes de ferramentas que começam com get_ somente leem informações da sessão. Todas as outras ferramentas podem alterar o gráfico.

Ler o gráfico atual

Estas ferramentas permitem que o Assistant veja no que você está trabalhando antes de responder ou fazer uma alteração.

Ferramenta
O que faz?

get_workspace_info

Lista o que está na tela: nós, conexões, grupos, notas e detalhes do espaço de trabalho.

get_selection

Informa quais nós, conexões e grupos estão selecionados.

get_node_connections

Mostra a quais elementos cada nó está conectado, porta por porta.

get_node_property

Informa as configurações dos nós, como visualização, congelamento, visualização fixada e legendas.

get_node_lacing

Informa a configuração de amarra de um nó.

get_installation_info

Informa a versão do Dynamo, o hospedeiro em execução e um link para as notas de versão.

Exemplo de prompt: “O que está na minha tela no momento?”

Encontrar o nó correto

O Dynamo tem milhares de nós, incluindo os disponibilizados pelos pacotes instalados Estas ferramentas ajudam o Assistant a escolher o nó correto, em vez de fazer suposições.

Ferramenta
O que faz?

get_nodes_info

Pesquisa a biblioteca de nós, incluindo os nós de pacotes, e retorna o nó exato a ser colocado.

get_node_help

Retorna a ajuda escrita de um nó e o caminho para seu gráfico de exemplo, quando disponível.

get_type_schema

Retorna o formato de dados esperado para um tipo do Dynamo, como Ponto, Número ou Cor.

Exemplo de prompt: “Qual nó devo usar para obter a área de uma superfície?”

Criar e editar o gráfico

Estas ferramentas fazem o trabalho na tela.

Ferramenta
O que faz?

create_nodes

Coloca um ou mais nós na tela, com valores iniciais opcionais.

set_node_value

Define o valor dos nós de entrada, como Número, Sequência, Bloco de código e menus suspensos.

connect_nodes

Conecta uma porta de saída a uma porta de entrada.

disconnect_nodes

Remove conexões entre dois nós.

delete_node

Remove um nó da tela.

rename_node

Renomeia os nós de entrada e de inspeção para que sua finalidade fique clara. Os nós de função mantêm seus nomes originais.

select_nodes

Seleciona os nós na tela para indicar visualmente quais o Assistente está mencionando.

set_node_property

Ativa ou desativa as configurações dos nós: visualização, congelamento, visualização fixada, legendas e entrada ou saída.

set_node_lacing

Define o modo de amarração como Automático, Mais curto, Mais longo ou Produto cartesiano.

set_node_port_list_at_level

Define o nível da lista em uma porta de entrada.

Exemplo de prompt: “Adicione um controle deslizante numérico e conecte-o à entrada de raio de meu círculo.”

Organizar e documentar o gráfico

Um gráfico funcional nem sempre é legível. Estas ferramentas lidam com layout, agrupamento, cores e notas.

Ferramenta
O que faz?

create_group

Coloca um grupo em torno de um conjunto de nós.

create_groups

Cria vários grupos em uma etapa.

ungroup_by_guid

Remove um grupo, mantendo os nós na tela.

ungroup_by_title

Remove grupos pelo título, mantendo os nós na tela.

get_available_group_styles

Lista os estilos de grupo disponíveis, incluindo os estilos personalizados definidos nas preferências.

assign_group_styles

Aplica estilos de grupo, como Entradas, Ações, Saídas e Revisão.

get_notes

Lista as notas no gráfico.

create_notes

Adiciona notas para explicar partes do gráfico.

update_notes

Edita ou move o texto de uma nota.

delete_notes

Remove notas.

set_note_state

Fixa uma nota a um nó para que ambos se movam juntos ou desfaz essa associação.

auto_layout_workspace

Reorganiza os nós usando o layout automático integrado do Dynamo.

set_workspace_description

Grava uma descrição do gráfico nas propriedades do arquivo.

Exemplo de prompt: “Agrupe e aplique cores ao gráfico por entradas, ações e saídas e, em seguida, adicione notas curtas.”

Executar o gráfico e verificar os resultados

Ferramenta
O que faz?

run_workspace

Executa o gráfico atual. No modo automático, o gráfico já é executado novamente em cada alteração, portanto, essa etapa é ignorada.

get_workspace_warnings

Lista os nós com avisos ou erros, as mensagens correspondentes e as próximas etapas sugeridas. O gráfico precisa ser executado primeiro.

get_node_output_values_shapes

Resume os valores de saída de um nó ou de todos os nós do gráfico.

get_node_output_value

Lê a saída completa de um único nó, uma página por vez, para resultados que são muito grandes para serem resumidos.

*Exemplo de prompt: “Execute o gráfico e me diga por que o nó List.GetItemAtIndex está exibindo um aviso.”

Trabalhar com arquivos de gráficos

O Assistant também pode trabalhar com gráficos salvos no disco, não apenas com o gráfico aberto.

Ferramenta
O que faz?

new_workspace

Abre um novo gráfico vazio. Se o gráfico atual tiver alterações não salvas, você deverá salvá-las ou descartá-las primeiro.

save_workspace

Salva o gráfico atual. Se nenhuma localização for especificada, ele salva na pasta do Dynamo em Documentos.

edit_graph_from_path

Abre um gráfico salvo para edição, sem executá-lo.

insert_graph_from_path

Mescla um gráfico salvo na tela atual. É assim que os gráficos de exemplo de nós são inseridos.

run_graph_from_path

Executa um gráfico salvo, com valores de entrada opcionais fornecidos por você.

run_graph_from_json

Executa um gráfico fornecido como JSON do Dynamo, sem nenhum arquivo no disco.

get_graph_info_from_path

Lê as entradas, as saídas e os metadados de um gráfico salvo sem abri-lo.

get_graph_info_from_json

Lê os mesmos detalhes de um gráfico fornecido como JSON do Dynamo.

get_graphs_info_from_path

Examina uma pasta de gráficos e informa o que cada um contém.

get_available_graphs_folders

Lista as pastas conhecidas pelo Dynamo que podem conter gráficos.

Exemplo de prompt: “Examine minha pasta de gráficos do Dynamo e me diga quais gráficos colocam paredes”.

Last updated