Documentazione PULSE per Revit

Installa PULSE, collega il tuo assistente AI (Claude, Codex, opencode o qualsiasi altro client MCP · anche con modelli locali open-weight) e parla al modello Revit in linguaggio naturale. Questa documentazione copre installazione, configurazione, il catalogo completo dei comandi (Free e Premium) ed esempi pratici.

1. Installazione

PULSE è un plugin per Autodesk® Revit® 2023-2027. L'installazione richiede pochi minuti e non serve alcuna competenza tecnica.

Scarica PULSE Free dal sito: compila il modulo su pulse-ai.it e ricevi via email il link di download (valido 48 ore). Il file ZIP contiene Pulse-Setup.exe e la guida.
Chiudi Revit e Claude Desktop: l'installer deve poter sostituire i file del plugin e aggiornare la configurazione MCP.
Estrai completamente lo ZIP, avvia Pulse-Setup.exe e accetta la richiesta UAC. L'installer rileva automaticamente le versioni di Revit presenti (2023-2027) e installa il plugin per ciascuna.
Riavvia Revit. Comparirà la scheda PULSE nella barra multifunzione, con i pulsanti «Pulse Switch» (avvia/ferma il server, spento all'avvio) e «Settings».
Avvia il server: apri un progetto, clicca Pulse Switch per accendere il server locale. Da questo momento il tuo assistente AI può operare sul modello.

L'installer non è firmato digitalmente: al primo avvio Windows SmartScreen potrebbe mostrare un avviso «Editore sconosciuto». È normale · scegli «Ulteriori informazioni» → «Esegui comunque». Tutto gira in locale sul tuo PC, nulla viene esposto su internet.

2. Collegare l'assistente AI

PULSE espone un server MCP locale: il ponte tra Revit e l'assistente AI. Il server installato è %USERPROFILE%\.pulse\server\Pulse.Server.exe; sostituisci <TUO_UTENTE> con il tuo nome utente Windows nei blocchi manuali.

Stato: apri un progetto Revit e attiva Pulse Switch. Il bridge di produzione usa soltanto 127.0.0.1:8080; la porta 8081 è riservata al profilo di sviluppo. Le app web (claude.ai e chatgpt.com) non possono collegarsi a un server MCP locale.

Configurazione automatica

L'installer rileva e configura i client MCP presenti sul PC: Claude Desktop, Claude Code, Codex/ChatGPT desktop, OpenCode, Cursor, Windsurf, VS Code, Cline e LM Studio. Se un client non viene rilevato o il riepilogo dell'installer indica un errore, usa la configurazione manuale qui sotto.

Configurazione manuale

Claude Desktop: apri Settings → Developer → Edit Config. Il percorso classico è %APPDATA%\Claude\claude_desktop_config.json; alcune installazioni MSIX usano %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json. Aggiungi:

{
  "mcpServers": {
    "pulse-revit": {
      "command": "C:\\Users\\<TUO_UTENTE>\\.pulse\\server\\Pulse.Server.exe"
    }
  }
}

Claude Code: esegui nel terminale:

claude mcp add pulse-revit -- "C:\Users\<TUO_UTENTE>\.pulse\server\Pulse.Server.exe"

Codex / app ChatGPT desktop: aggiungi a %USERPROFILE%\.codex\config.toml:

[mcp_servers.pulse-revit]
command = "C:\\Users\\<TUO_UTENTE>\\.pulse\\server\\Pulse.Server.exe"

In alternativa: codex mcp add pulse-revit -- "C:\Users\<TUO_UTENTE>\.pulse\server\Pulse.Server.exe". OpenCode: aggiungi a %USERPROFILE%\.config\opencode\opencode.json:

{
  "mcp": {
    "pulse-revit": {
      "type": "local",
      "command": ["C:\\Users\\<TUO_UTENTE>\\.pulse\\server\\Pulse.Server.exe"],
      "enabled": true
    }
  }
}

Cursor: crea o modifica %USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "pulse-revit": {
      "command": "C:\\Users\\<TUO_UTENTE>\\.pulse\\server\\Pulse.Server.exe",
      "args": []
    }
  }
}

Attenzione al JSON. Se il file contiene già mcpServers, aggiungi soltanto la voce pulse-revit, senza incollare un secondo documento completo. Chiudi il client AI prima di salvare, poi riaprilo. I server MCP locali sono disponibili nelle app desktop, non sul web.

Modelli locali open-weight. OpenCode può usare Ollama, LM Studio o endpoint compatibili OpenAI. Scegli un modello con supporto tool/function calling; per le operazioni di scrittura sul modello sono preferibili modelli di fascia alta o cloud.

Per IT Manager

Distribuzione gestita. Pulse-Setup.exe non è firmato Authenticode e richiede UAC; SmartScreen, AppLocker o WDAC possono richiedere un'allowlist esplicita. Il plugin viene scritto in ProgramData con fallback in AppData; server, configurazioni MCP e log sotto %USERPROFILE%\.pulse sono per utente, quindi ogni profilo Windows va configurato separatamente. Il bridge usa solo 127.0.0.1:8080: non serve una regola firewall inbound. Consentire HTTPS verso dl.pulse-ai.it per aggiornamenti e licenza; Power BI Premium usa inoltre login.microsoftonline.com, api.powerbi.com e il listener locale localhost:27016. La telemetria Pulse è disattivata per default. La disinstallazione conserva settings, log e audit in %USERPROFILE%\.pulse, eliminabili manualmente dall'IT.

Checklist di connessione

Revit aperto con un documento attivo;
Pulse Switch acceso (icona ambra);
l'assistente AI riavviato dopo la modifica della configurazione.

3. Primi passi

Con il server acceso, scrivi all'assistente quello che vuoi ottenere come lo diresti a un collega. Parti da un comando di lettura, senza rischi: «Fai un health check del modello» oppure «Mostrami tutti i muri». PULSE traduce la richiesta in operazioni verificate sul modello e ti risponde con i risultati.

Anteprima prima di modificare. Le operazioni che cambiano il modello (creazione, modifica, cancellazione) mostrano prima un'anteprima e chiedono conferma con una finestra nativa di Revit. Puoi sempre annullare prima dell'esecuzione.

4. Catalogo comandi

PULSE per Revit offre 313 comandi. La versione FREE include 115 comandi di lettura (interrogazione, analisi, export), per sempre e senza scadenza. La versione PREMIUM sblocca i restanti 198 comandi di scrittura, automazione e Power BI.

Elementi e parametri ~35 comandi

ai_element_filterFREETrova elementi con filtri complessi (categoria, parametri, intervalli).

get_element_parametersFREELegge tutti i parametri di uno o più elementi.

export_elements_dataFREEEsporta dati di elementi filtrati.

set_element_parametersPREMIUMImposta valori di parametro su elementi.

bulk_modify_parameter_valuesPREMIUMModifica in blocco lo stesso parametro su N elementi.

sync_csv_parametersPREMIUMSincronizza parametri da un file CSV/Excel.

Viste, tavole e abachi ~28 comandi

get_current_view_infoFREEInformazioni sulla vista attiva.

get_schedule_dataFREELegge i dati di un abaco esistente.

create_sheetPREMIUMCrea una tavola con cartiglio.

place_viewportPREMIUMPosiziona una vista in tavola.

create_schedulePREMIUMCrea un nuovo abaco.

Analisi e QA ~7 comandi

check_model_healthFREEPunteggio di salute del modello e problemi rilevati.

analyze_model_statisticsFREEStatistiche complete del modello.

clash_detectionFREERileva interferenze tra discipline.

audit_familiesFREEVerifica le famiglie del progetto.

purge_unusedPREMIUMElimina elementi inutilizzati.

IFC e interoperabilità ~20 comandi

ifc_analyze_rebuildabilityFREEAnalizza quali elementi IFC diventano nativi Revit.

ifc_export_basicFREEEsporta in IFC.

ifc_rebuild_wallsPREMIUMRicostruisce muri nativi da un import IFC.

Armature e carpenteria metallica ~100 comandi

get_rebar_element_dataFREELegge i dati delle armature.

analyze_structural_steel_modelFREEAnalizza il modello in acciaio.

create_rebar_from_shapePREMIUMCrea armature da una sagoma.

create_steel_connectionPREMIUMCrea un collegamento in acciaio.

Power BI e workflow ~19 comandi

push_to_powerbiPREMIUMPubblica dati di elementi su Power BI.

select_from_powerbiPREMIUMRiseleziona in Revit gli elementi filtrati in Power BI.

workflow_model_auditPREMIUMAudit completo del modello in un unico flusso.

workflow_sheet_setPREMIUMGenera un set di tavole con viewport.

MEP, facciate continue e vie di fuga

get_mep_systemsFREELegge sistemi e connettività MEP.

connect_mep_elementsPREMIUMCollega elementi MEP compatibili.

get_curtain_gridFREEIspeziona la griglia di una facciata continua.

create_path_of_travelPREMIUMCrea percorsi di esodo.

Progetto e collegamenti

get_project_infoFREELegge le informazioni del progetto.

add_linked_filePREMIUMAggiunge un file collegato al modello.

set_project_infoPREMIUMAggiorna le informazioni del progetto.

Dynamo e impostazioni

dynamo_get_statusPREMIUMVerifica disponibilità e versione di Dynamo.

dynamo_generate_graphPREMIUMGenera un grafo Dynamo controllato.

manage_project_parametersPREMIUMGestisce parametri di progetto.

Questa pagina offre una panoramica aggiornata per tutte le aree del catalogo 1.2.2. Il riferimento completo dei 313 comandi, con descrizioni ed esempi, è nella guida utente PDF qui sotto.

5. Esempi pratici

Ecco richieste reali in linguaggio naturale. Quelle di sola lettura funzionano già nella versione Free; quelle di scrittura richiedono Premium.

«Fai un health check completo del modello e mostrami i primi 10 warning.»

FREE → check_model_health + get_warnings

«Esporta in Excel tutti i vani con area e altezza, solo quelli sopra i 15 m².»

FREE → filtro + export_room_data / export_to_excel

«Analizza quali elementi di questo import IFC possono diventare Revit nativi.»

FREE → ifc_analyze_rebuildability

«Trova tutte le porte senza contrassegno e assegna una numerazione progressiva per piano.»

PREMIUM → filter_by_parameter_value + renumber_elements (con anteprima)

«Aggiorna i parametri dei muri da questo Excel, prima in anteprima.»

PREMIUM → import_from_excel (dryRun) poi esecuzione

«Pubblica le travi su Power BI; quando ho filtrato quelle critiche, riselezionale in Revit e coloramele per tipo.»

PREMIUM → push_to_powerbi → select_from_powerbi → color_elements

6. Lingua del modello

PULSE rileva automaticamente la lingua di Revit (italiano, inglese, francese, tedesco) e usa i nomi corretti di parametri e categorie. Puoi scrivere all'assistente nella tua lingua: la traduzione verso le operazioni Revit è gestita da PULSE.

7. Guide PDF

Le stesse guide incluse nel pacchetto di installazione, consultabili online o scaricabili:

Guida all'installazione (PDF, ~70 KB) · requisiti, installer, configurazione dei client AI.
Guida utente completa (PDF) · tutti i 313 comandi per disciplina, con esempi di prompt.

← Scarica PULSE Free

PULSE for Revit Documentation

Install PULSE, connect your AI assistant (Claude, Codex, opencode or any other MCP client · including local open-weight models), and talk to your Revit model in plain language. This documentation covers installation, setup, the full command catalogue (Free and Premium), and practical examples.

1. Installation

PULSE is a plugin for Autodesk® Revit® 2023-2027. Installation takes a few minutes and needs no technical skills.

Download PULSE Free from the site: fill in the form on pulse-ai.it and get a download link by email (valid 48 hours). The ZIP contains Pulse-Setup.exe and the guide.
Close Revit and Claude Desktop: the installer must be able to replace plugin files and update the MCP configuration.
Fully extract the ZIP, run Pulse-Setup.exe, and approve the UAC prompt. The installer auto-detects your installed Revit versions (2023-2027) and installs the plugin for each.
Restart Revit. A PULSE ribbon tab appears, with "Pulse Switch" (starts/stops the server, off at launch) and "Settings".
Start the server: open a project, click Pulse Switch to turn on the local server. From now on your AI assistant can operate on the model.

The installer is not code-signed: on first launch Windows SmartScreen may warn "Unknown publisher". This is expected · choose "More info" → "Run anyway". Everything runs locally on your PC; nothing is exposed to the internet.

2. Connect the AI assistant

PULSE exposes a local MCP server: the bridge between Revit and your AI assistant. The installed server is %USERPROFILE%\.pulse\server\Pulse.Server.exe; replace <YOUR_USER> with your Windows user name in the manual blocks.

Status: open a Revit project and turn on Pulse Switch. The production bridge uses only 127.0.0.1:8080; port 8081 is reserved for the development profile. Web apps (claude.ai and chatgpt.com) cannot connect to a local MCP server.

Automatic configuration

The installer detects and configures MCP clients found on the PC: Claude Desktop, Claude Code, Codex/ChatGPT desktop, OpenCode, Cursor, Windsurf, VS Code, Cline, and LM Studio. If a client is not detected or the installer summary reports an error, use the manual setup below.

Manual configuration

Claude Desktop: open Settings → Developer → Edit Config. The classic path is %APPDATA%\Claude\claude_desktop_config.json; some MSIX installations use %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json. Add:

{
  "mcpServers": {
    "pulse-revit": {
      "command": "C:\\Users\\<YOUR_USER>\\.pulse\\server\\Pulse.Server.exe"
    }
  }
}

Claude Code: run in a terminal:

claude mcp add pulse-revit -- "C:\Users\<YOUR_USER>\.pulse\server\Pulse.Server.exe"

Codex / ChatGPT desktop app: add to %USERPROFILE%\.codex\config.toml:

[mcp_servers.pulse-revit]
command = "C:\\Users\\<YOUR_USER>\\.pulse\\server\\Pulse.Server.exe"

Alternatively: codex mcp add pulse-revit -- "C:\Users\<YOUR_USER>\.pulse\server\Pulse.Server.exe". OpenCode: add to %USERPROFILE%\.config\opencode\opencode.json:

{
  "mcp": {
    "pulse-revit": {
      "type": "local",
      "command": ["C:\\Users\\<YOUR_USER>\\.pulse\\server\\Pulse.Server.exe"],
      "enabled": true
    }
  }
}

Cursor: create or edit %USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "pulse-revit": {
      "command": "C:\\Users\\<YOUR_USER>\\.pulse\\server\\Pulse.Server.exe",
      "args": []
    }
  }
}

JSON warning. If the file already contains mcpServers, add only the pulse-revit entry; do not paste a second complete document. Quit the AI client before saving, then reopen it. Local MCP servers are available in desktop apps, not on the web.

Local open-weight models. OpenCode can use Ollama, LM Studio, or OpenAI-compatible endpoints. Choose a model with tool/function-calling support; high-end or cloud models are preferable for write operations.

For IT managers

Managed deployment. Pulse-Setup.exe is not Authenticode-signed and requests UAC; SmartScreen, AppLocker, or WDAC may require an explicit allowlist. The plugin is written to ProgramData with an AppData fallback; the server, MCP configs, and logs under %USERPROFILE%\.pulse are per-user, so each Windows profile must be configured separately. The bridge binds only to 127.0.0.1:8080: no inbound firewall rule is required. Allow outbound HTTPS to dl.pulse-ai.it for updates and licensing; Premium Power BI also uses login.microsoftonline.com, api.powerbi.com, and the local localhost:27016 listener. Pulse telemetry is off by default. Uninstall retains settings, logs, and audit data under %USERPROFILE%\.pulse, which IT may remove manually.

Connection checklist

Revit open with an active document;
Pulse Switch on (amber icon);
the AI assistant restarted after editing the config.

3. First steps

With the server on, tell the assistant what you want as you would tell a colleague. Start with a read-only command, risk-free: "Run a model health check" or "Show me all the walls". PULSE turns the request into verified operations on the model and replies with the results.

Preview before changing. Operations that modify the model (create, edit, delete) show a preview first and ask for confirmation with a native Revit dialog. You can always cancel before execution.

4. Command catalogue

PULSE for Revit offers 313 commands. The FREE version includes 115 read-only commands (query, analysis and export), forever and with no expiry. The PREMIUM version unlocks the remaining 198 commands for writing, automation and Power BI.

Elements & parameters ~35 commands

ai_element_filterFREEFind elements with complex filters (category, parameters, ranges).

get_element_parametersFREERead all parameters of one or more elements.

export_elements_dataFREEExport data for filtered elements.

set_element_parametersPREMIUMSet parameter values on elements.

bulk_modify_parameter_valuesPREMIUMBulk-edit the same parameter across N elements.

sync_csv_parametersPREMIUMSync parameters from a CSV/Excel file.

Views, sheets & schedules ~28 commands

get_current_view_infoFREEInfo about the active view.

get_schedule_dataFREERead data from an existing schedule.

create_sheetPREMIUMCreate a sheet with a title block.

place_viewportPREMIUMPlace a view on a sheet.

create_schedulePREMIUMCreate a new schedule.

Analysis & QA ~7 commands

check_model_healthFREEModel health score and detected issues.

analyze_model_statisticsFREEFull model statistics.

clash_detectionFREEDetect interferences between disciplines.

audit_familiesFREEAudit the project families.

purge_unusedPREMIUMRemove unused elements.

IFC & interoperability ~20 commands

ifc_analyze_rebuildabilityFREEAnalyse which IFC elements can become native Revit.

ifc_export_basicFREEExport to IFC.

ifc_rebuild_wallsPREMIUMRebuild native walls from an IFC import.

Rebar & structural steel ~100 commands

get_rebar_element_dataFREERead rebar data.

analyze_structural_steel_modelFREEAnalyse the steel model.

create_rebar_from_shapePREMIUMCreate rebar from a shape.

create_steel_connectionPREMIUMCreate a steel connection.

Power BI & workflows ~19 commands

push_to_powerbiPREMIUMPublish element data to Power BI.

select_from_powerbiPREMIUMRe-select in Revit the elements filtered in Power BI.

workflow_model_auditPREMIUMFull model audit in one flow.

workflow_sheet_setPREMIUMGenerate a sheet set with viewports.

MEP, curtain walls & egress

get_mep_systemsFREERead MEP systems and connectivity.

connect_mep_elementsPREMIUMConnect compatible MEP elements.

get_curtain_gridFREEInspect a curtain-wall grid.

create_path_of_travelPREMIUMCreate egress paths.

Project & links

get_project_infoFREERead project information.

add_linked_filePREMIUMAdd a linked file to the model.

set_project_infoPREMIUMUpdate project information.

Dynamo & settings

dynamo_get_statusPREMIUMCheck Dynamo availability and version.

dynamo_generate_graphPREMIUMGenerate a controlled Dynamo graph.

manage_project_parametersPREMIUMManage project parameters.

This page is an up-to-date overview of every 1.2.2 catalogue area. The complete reference for all 313 commands, with descriptions and prompt examples, is in the user guide PDF below.

5. Practical examples

Real natural-language requests. The read-only ones already work in Free; the write ones need Premium.

"Run a full model health check and show me the top 10 warnings."

FREE → check_model_health + get_warnings

"Export to Excel all rooms with area and height, only those over 15 m²."

FREE → filter + export_room_data / export_to_excel

"Analyse which elements of this IFC import can become native Revit."

FREE → ifc_analyze_rebuildability

"Find all doors without a mark and assign a progressive number per level."

PREMIUM → filter_by_parameter_value + renumber_elements (with preview)

"Update the walls' parameters from this Excel, preview first."

PREMIUM → import_from_excel (dryRun) then execute

"Push the beams to Power BI; once I've filtered the critical ones, re-select them in Revit and colour them by type."

PREMIUM → push_to_powerbi → select_from_powerbi → color_elements

6. Model language

PULSE auto-detects the Revit language (Italian, English, French, German) and uses the correct parameter and category names. You can write to the assistant in your own language: PULSE handles the translation into Revit operations.

7. PDF guides

The same guides shipped inside the installation package, readable online or downloadable:

Installation guide (PDF, ~70 KB) · requirements, installer, AI client setup.
Complete user guide (PDF) · all 313 commands by discipline, with prompt examples.

← Download PULSE Free