Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

docs(i18n): review es, pt-BR, fr, it, de READMEs against English (#88)

A. Sam Mohammad9d3f456c88f7
diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md
index 39f701e..fa31c63 100644
--- a/docs/i18n/README.de.md
+++ b/docs/i18n/README.de.md
@@ -23,7 +23,13 @@ Open-Source-MCP-Server und natives Add-in für Revit 2024 – 2027. Funktioniert
<img src="../images/readme/demo.gif" alt="Demo: Ein KI-Assistent findet 12 Türen ohne Mark und entwirft einen Plan. Der Plan wartet im Revit-Panel auf Ihre Freigabe, danach werden die Werte zur Kontrolle zurückgelesen. Beispielwerte, simulierte Sitzung." width="900">
</p>
-Verbinden Sie Claude, Codex oder einen anderen MCP-Client mit dem Revit-Modell, das Sie geöffnet haben. AEC Model Bridge kombiniert einen MCP-Server in Python mit einem nativen Revit-Add-in: Schreibgeschützte Werkzeuge untersuchen das Modell sofort, und Änderungen am Modell erfordern standardmäßig einen freigegebenen Plan. [So funktioniert die Freigabe](#so-funktioniert-die-freigabe).
+AEC Model Bridge ist der Open-Source-Revit-MCP-Server, mit dem Claude, Codex, Cursor und andere KI-Assistenten Ihr geöffnetes Revit-Modell lesen und bearbeiten können – jede Änderung erst nach Ihrer Freigabe. Er kombiniert einen MCP-Server in Python mit einem nativen Revit-Add-in: Schreibgeschützte Werkzeuge untersuchen das Modell sofort, und Änderungen am Modell erfordern standardmäßig einen freigegebenen Plan. [So funktioniert die Freigabe](#so-funktioniert-die-freigabe).
+
+<p align="center">
+ <img src="../images/readme/works-with.svg" alt="Funktioniert mit: Für Claude Desktop, VS Code mit GitHub Copilot, Cursor und Codex gibt es eine dokumentierte Einrichtung. Andere MCP-Clients wie Claude Code, Windsurf, Cline, Continue, Zed und Gemini CLI sollten ebenfalls funktionieren. Anwendungen: Revit 2024 bis 2027, Rhino, Grasshopper, Navisworks (in Arbeit). Daten: IFC, Speckle, Excel, SQLite. Protokoll: MCP über stdio mit Freigabe-Schranke." width="900">
+</p>
+
+Die Einrichtung ist für Claude Desktop, VS Code mit GitHub Copilot, Cursor und Codex dokumentiert. Es handelt sich um einen Standard-MCP-Server über stdio, daher sollten auch andere Clients wie Claude Code, Windsurf, Cline, Continue, Zed und Gemini CLI funktionieren. Was dokumentiert und was ungetestet ist, steht unter [Kompatibilität](../compatibility.md).
Derselbe Server enthält außerdem IFC-Prüfung, Rhino- und Grasshopper-Automatisierung sowie die Speckle-Anbindung. Der [Status der Integrationen](#weitere-integrationen) trennt verfügbare Provider von solchen, die noch in Arbeit sind.
@@ -35,7 +41,7 @@ Für BIM-Koordinatoren: Modellqualität prüfen, betroffene Elemente ansehen, ei
| --- | --- | --- |
| Modellprüfung | "Zeige das aktive Dokument, liste die Warnungen auf und finde die betroffenen Elemente." | `revit_get_document_info`, `revit_get_warnings`, `revit_get_elements_by_type` |
| Parameteraktualisierung | "Finde die Wände auf Level 02, zeige ihre Comments-Werte und schlage eine Stapelaktualisierung vor." | `revit_get_elements_by_type`, `revit_get_element_parameters`, `revit_batch_set_parameters` |
-| Planerstellung | "Erstelle aus dieser CSV eine Plan-Liste und schlage vor, die Pläne anzulegen und die Ansichten zu platzieren." | `revit_batch_create_sheets_from_csv`, `revit_place_viewport_on_sheet` |
+| Planerstellung | "Erstelle aus dieser CSV eine Planliste und schlage vor, die Pläne anzulegen und die Ansichten zu platzieren." | `revit_batch_create_sheets_from_csv`, `revit_place_viewport_on_sheet` |
| IFC-Prüfung | "Zeige die Geschosse dieser IFC-Datei, prüfe die Wandeigenschaften und melde Probleme bei der Schemavalidierung." | `ifc_get_spatial_structure`, `ifc_get_properties`, `ifc_validate` |
Für einen ersten Versuch in Revit probieren Sie:
@@ -55,7 +61,7 @@ the plan in Revit, apply it and read the values back to confirm the result.
Für Änderungen erstellt der Assistent mit `plan_actions` einen Plan; Sie prüfen ihn im Revit-Panel, bevor `execute_plan` ihn anwendet. Die IFC-Prüfung läuft ohne Revit.
-Die Snapshot-basierten QA/QC- und Berichtsmodule benötigen einen kompatiblen gespeicherten Snapshot. Die aktuelle Übergabe des Snapshots von Revit an das Modul erfordert übereinstimmende Dateinamen und Arbeitsbereiche; ohne `snapshot_id` können generierte Beispieldaten zurückkommen. Für die Live-Prüfung nutzen Sie die direkten Revit-Werkzeuge oben. [Geplante Korrekturen und Demo](../roadmap.md).
+Die Snapshot-basierten QA/QC- und Berichtsmodule benötigen einen kompatiblen gespeicherten Snapshot. Die aktuelle Übergabe des Snapshots von Revit an das Modul erfordert übereinstimmenden Dateinamen und Arbeitsbereich; ohne `snapshot_id` können generierte Beispieldaten zurückkommen. Für die Live-Prüfung nutzen Sie die direkten Revit-Werkzeuge oben. [Geplante Korrekturen und Demo](../roadmap.md).
## Schnellstart
@@ -100,7 +106,7 @@ Sie nutzen VS Code? Der [Quellcode der Erweiterung und die lokalen Installations
| Bereich | Werkzeuge | Was sie tun |
| --- | --- | --- |
| Revit | 103 | Modell lesen, Elemente, Parameter, Ansichten, Pläne und Bauteillisten erstellen und bearbeiten, Exporte, Worksharing |
-| Freigabe | 6 | Modelländerungen planen, prüfen, freigeben, ausführen und zurückrollen |
+| Freigabe | 6 | Modelländerungen planen, prüfen, freigeben, ausführen und zurücksetzen |
| Module | 34 | Snapshot-Prüfung, Parametertabellen, QA/QC-Prüfungen, Rezepte, Berichte, Auswahlen |
| Rhino und Grasshopper | 19 | Geometrie, Layer, Materialien, boolesche Operationen |
| Speckle | 17 | Projekte, Modelle, Versionen, Senden und Empfangen |
@@ -112,7 +118,7 @@ In der Standardkonfiguration werden 219 Werkzeuge aufgelistet (gezählt am aktue
### Erweiterte Revit-Automatisierung
-Neben Modellabfragen und Parameteraktualisierungen erstellen die Revit-Werkzeuge Bauelemente, Ansichten, Pläne, Bauteillisten, Tags und Bemaßungen und exportieren IFC-, DWG-, Bild- und Navisworks-Dateien. Unterstützte Operationen und Eingaben finden Sie in der [Werkzeugreferenz](../tools-generated.md).
+Neben Modellabfragen und Parameteraktualisierungen erstellen die Revit-Werkzeuge Bauteile, Ansichten, Pläne, Bauteillisten, Beschriftungen und Bemaßungen und exportieren IFC-, DWG-, Bild- und Navisworks-Dateien. Unterstützte Operationen und Eingaben finden Sie in der [Werkzeugreferenz](../tools-generated.md).
Für alles, was der Werkzeugkatalog nicht abdeckt, arbeiten `revit_invoke_method`, `revit_reflect_get` und `revit_reflect_set` mit öffentlichen Mitgliedern der Revit-API, und `revit_execute_python` führt IronPython in Revit aus. Diese erweiterten Werkzeuge haben dieselben Berechtigungen wie der Revit-Prozess. Verwenden Sie sie nur mit MCP-Clients und Prompts, denen Sie vertrauen.
@@ -151,9 +157,9 @@ Der Hub stoppt jeden Werkzeugaufruf, der das Modell ändert, sofern er keinen fr
<sub>Diagrammquelle: [approval-flow.mmd](../diagrams/approval-flow.mmd). Die Bilder erzeugen Sie mit `python scripts/render_diagrams.py` neu.</sub>
-Wenn sich ein freigegebener Plan später als falsch erweist, macht `rollback_plan` ihn rückgängig. Der Rollback nutzt Rückgängig in Revit innerhalb derselben Sitzung oder umgekehrte Parameterwerte. Nicht umkehrbare Vorgänge, etwa die Dateiausgabe, verlangen eine zweite Bestätigung. Der Ablauf ist in [ADR 0008](../0008-approval-gate-lifecycle.md) beschrieben.
+Wenn sich ein freigegebener Plan später als falsch erweist, macht `rollback_plan` ihn rückgängig. Das Zurücksetzen nutzt Rückgängig in Revit innerhalb derselben Sitzung oder umgekehrte Parameterwerte. Nicht umkehrbare Vorgänge, etwa das Schreiben von Dateien, verlangen eine zweite Bestätigung. Der Ablauf ist in [ADR 0008](../0008-approval-gate-lifecycle.md) beschrieben.
-Für unbeaufsichtigte Pipelines können Sie `MCP_REVIT_APPROVAL_MODE=auto` setzen. Das schaltet die menschliche Prüfung ab; verwenden Sie es daher nur in einer kontrollierten Umgebung.
+Für unbeaufsichtigte Pipelines können Sie `MCP_REVIT_APPROVAL_MODE=auto` setzen. Das schaltet die Prüfung durch den Menschen ab; verwenden Sie es daher nur in einer kontrollierten Umgebung.
## Unterstützte Revit-Versionen
@@ -178,6 +184,8 @@ Außerdem benötigen Sie Windows 10 oder 11, Python 3.11 oder neuer und eine liz
| Power BI | In Arbeit. Provider und Werkzeug existieren, sind aber nicht im Hub registriert. |
| Excel, Parquet und DuckDB | Geplant. |
+Produktnamen und Logos gehören ihren jeweiligen Inhabern. Das Banner verwendet sie nur, um zu zeigen, womit dieses Projekt zusammenarbeitet.
+
## Revit-Add-in installieren
**Am einfachsten (Windows):** Laden Sie `AECModelBridge-Setup-<version>.exe` vom [neuesten Release](https://github.com/Sam-AEC/aec-model-bridge/releases/latest) herunter, starten Sie es per Doppelklick, wählen Sie Ihre Revit-Versionen und starten Sie Revit neu. Es installiert das Add-in, den mitgelieferten Python-Server und, wenn Sie das Kontrollkästchen aktivieren, die Einstellungen für Claude Desktop und VS Code, mit einer Sicherung Ihrer aktuellen Einstellungen. Deinstalliert wird über die Windows-Einstellungen. Die folgenden Schritte sind für den Build aus dem Quellcode.
@@ -278,10 +286,10 @@ Die Antwort sollte `healthy` und die laufende Revit-Version melden. Suchen Sie i
## Sicherheit
-- Die Revit-Bridge lauscht nur auf localhost.
+- Die Revit-Bridge ist nur über localhost erreichbar.
- Der Server liest und schreibt nur in den Ordnern aus `MCP_REVIT_ALLOWED_DIRECTORIES`.
- Werkzeuge, die das Modell ändern, benötigen einen freigegebenen Plan, sofern Sie die Freigabe nicht abschalten.
-- Werkzeugaufrufe werden in ein Audit-Protokoll geschrieben, Geheimnisse werden geschwärzt.
+- Werkzeugaufrufe werden in ein Audit-Protokoll geschrieben, Secrets (Zugangsdaten) werden maskiert.
Details stehen in [docs/security.md](../security.md). Um eine Sicherheitslücke zu melden, folgen Sie [SECURITY.md](../../SECURITY.md).
@@ -293,7 +301,7 @@ Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Assistente
### Mit welchen KI-Assistenten funktioniert es?
-Mit jedem MCP-Client, der einen lokalen stdio-Server starten kann. Dokumentiert sind Claude Desktop, VS Code mit GitHub Copilot und Clients, die eine Standard-`mcpServers`-Konfiguration lesen. Der Panel-Chat kann auch einen Anthropic-API-Schlüssel oder die Kommandozeilenwerkzeuge `claude` oder `codex` nutzen, sofern sie installiert sind. Siehe [ADR 0012](../0012-native-agent-chat-backend.md).
+Mit jedem MCP-Client, der einen lokalen stdio-Server starten kann. Dokumentiert sind Claude Desktop, VS Code mit GitHub Copilot, Cursor und Codex sowie Clients, die eine Standard-`mcpServers`-Konfiguration lesen. Windsurf, Cline, Roo Code, Continue, Zed, Claude Code und Gemini CLI sollten auf dieselbe Weise funktionieren, wurden aber nicht getestet. Siehe [Kompatibilität](../compatibility.md). Der Panel-Chat kann auch einen Anthropic-API-Schlüssel oder die Kommandozeilenwerkzeuge `claude` oder `codex` nutzen, sofern sie installiert sind. Siehe [ADR 0012](../0012-native-agent-chat-backend.md).
### Kann die KI mein Modell ohne Rückfrage ändern?
@@ -301,7 +309,7 @@ Im Standardmodus nicht. Werkzeuge, die das Modell ändern, sind gesperrt, bis ei
### Wird mein Modell in die Cloud gesendet?
-Server und Add-in laufen auf Ihrem Rechner, und die Bridge lauscht auf localhost. Was der KI-Assistent sieht, hängt vom verwendeten Client ab: Die Werkzeugergebnisse gehen an den Modellanbieter dieses Clients. Cloud-Provider wie Speckle laufen nur, wenn Sie sie konfigurieren und ihre Werkzeuge aufrufen.
+Server und Add-in laufen auf Ihrem Rechner, und die Bridge ist nur über localhost erreichbar. Was der KI-Assistent sieht, hängt vom verwendeten Client ab: Die Werkzeugergebnisse gehen an den Modellanbieter dieses Clients. Cloud-Provider wie Speckle laufen nur, wenn Sie sie konfigurieren und ihre Werkzeuge aufrufen.
### Funktioniert es mit IFC-Dateien ohne Revit?
diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md
index 147e97b..58606f1 100644
--- a/docs/i18n/README.es.md
+++ b/docs/i18n/README.es.md
@@ -23,10 +23,20 @@ Servidor MCP de código abierto y complemento nativo para Revit 2024 – 2027. F
<img src="../images/readme/demo.gif" alt="Demostración: un asistente de IA encuentra 12 puertas sin Mark y redacta un plan. El plan espera en el panel de Revit hasta que lo apruebes; después se leen los valores para comprobarlos. Valores de ejemplo, sesión simulada." width="900">
</p>
-Conecta Claude, Codex u otro cliente MCP al modelo de Revit que tienes abierto.
-AEC Model Bridge combina un servidor MCP en Python con un complemento nativo de Revit:
-las herramientas de solo lectura inspeccionan el modelo al instante y, por defecto,
-los cambios en el modelo exigen un plan aprobado. [Consulta el flujo de aprobación](#cómo-funciona-la-aprobación).
+AEC Model Bridge es el servidor MCP de código abierto para Revit que permite a Claude,
+Codex, Cursor y otros asistentes de IA leer y editar el modelo de Revit que tienes abierto,
+con cada cambio aprobado antes por ti. Combina un servidor MCP en Python con un complemento
+nativo de Revit: las herramientas de solo lectura inspeccionan el modelo al instante y, por
+defecto, los cambios en el modelo exigen un plan aprobado. [Consulta el flujo de aprobación](#cómo-funciona-la-aprobación).
+
+<p align="center">
+ <img src="../images/readme/works-with.svg" alt="Compatible con: Claude Desktop, VS Code con GitHub Copilot, Cursor y Codex tienen configuración documentada. Otros clientes MCP, como Claude Code, Windsurf, Cline, Continue, Zed y Gemini CLI, también deberían funcionar. Aplicaciones: Revit 2024 a 2027, Rhino, Grasshopper, Navisworks (en desarrollo). Datos: IFC, Speckle, Excel, SQLite. Protocolo: MCP sobre stdio con una puerta de aprobación." width="900">
+</p>
+
+La configuración está documentada para Claude Desktop, VS Code con GitHub Copilot, Cursor y
+Codex. Es un servidor MCP estándar por stdio, así que otros clientes, como Claude Code,
+Windsurf, Cline, Continue, Zed y Gemini CLI, también deberían funcionar. Consulta la
+[compatibilidad](../compatibility.md) para ver qué está documentado y qué no se ha probado.
El mismo servidor incluye inspección de IFC, automatización de Rhino y Grasshopper
e integración con Speckle. El [estado de las integraciones](#otras-integraciones) distingue
@@ -40,12 +50,12 @@ Estos ejemplos usan herramientas del [catálogo actual](../tools-generated.md).
| Flujo de trabajo | Solicitud de ejemplo | Herramientas utilizadas |
| --- | --- | --- |
-| Revisión del modelo | "Muestra el documento activo, lista sus avisos y encuentra los elementos afectados." | `revit_get_document_info`, `revit_get_warnings`, `revit_get_elements_by_type` |
+| Revisión del modelo | "Muestra el documento activo, lista sus advertencias y encuentra los elementos afectados." | `revit_get_document_info`, `revit_get_warnings`, `revit_get_elements_by_type` |
| Actualización de parámetros | "Busca los muros del Level 02, muestra los valores de Comments y propón una actualización por lotes." | `revit_get_elements_by_type`, `revit_get_element_parameters`, `revit_batch_set_parameters` |
| Producción de planos | "Prepara una lista de hojas a partir de este CSV y propón crear las hojas y colocar las vistas." | `revit_batch_create_sheets_from_csv`, `revit_place_viewport_on_sheet` |
| Revisión de IFC | "Muestra las plantas de este archivo IFC, inspecciona las propiedades de los muros e informa de los problemas de validación del esquema." | `ifc_get_spatial_structure`, `ifc_get_properties`, `ifc_validate` |
-Para una primera prueba en Revit, prueba con:
+Para empezar en Revit, prueba esto:
```text
Read the active model's warnings. Group them by description and show the
@@ -79,12 +89,12 @@ herramientas directas de Revit indicadas arriba para la inspección en vivo. [Co
Los botones solo necesitan [uv](https://docs.astral.sh/uv/getting-started/installation/)
y ninguna otra configuración: el servidor usa `~/Documents/AEC Model Bridge` como
espacio de trabajo salvo que definas el tuyo. Para Claude Desktop, descarga el archivo `.mcpb`
-de la última versión y ábrelo. Trabajar con Revit en vivo sigue requiriendo Revit y
+de la última versión y ábrelo. El trabajo en vivo con Revit sigue requiriendo Revit y
[el complemento](#instalar-el-complemento-de-revit); el modo mock no necesita nada.
**Configuración manual**
-Para la automatización de Revit en vivo necesitas Windows, una licencia de Revit 2024 a 2027,
+Para la automatización de Revit en vivo necesitas Windows, Revit 2024 a 2027 con licencia,
Python 3.11 o superior, [uv](https://docs.astral.sh/uv/getting-started/installation/) y el complemento de Revit
([pasos de instalación](#instalar-el-complemento-de-revit)). Después añade esto a tu
`claude_desktop_config.json` (Codex, Cursor y VS Code usan los mismos valores;
@@ -194,12 +204,12 @@ con una transacción con nombre.
Si un plan se aprueba y después resulta ser erróneo, `rollback_plan` lo revierte.
La reversión usa Deshacer de Revit en la misma sesión o los valores de parámetros inversos.
-Las operaciones que no se pueden revertir, como la salida a archivos, piden una segunda
+Las operaciones que no se pueden revertir, como la escritura de archivos, piden una segunda
confirmación. El ciclo de vida está descrito en
[ADR 0008](../0008-approval-gate-lifecycle.md).
Para pipelines desatendidos puedes definir `MCP_REVIT_APPROVAL_MODE=auto`. Eso desactiva
-la comprobación humana, así que úsalo solo en un entorno controlado.
+la revisión humana, así que úsalo solo en un entorno controlado.
## Versiones de Revit compatibles
@@ -224,7 +234,9 @@ lo que resulta útil para desarrollo y pruebas.
| Speckle | Disponible. Requiere un ID de cliente de Speckle en tu entorno. |
| Navisworks Manage | En desarrollo. El proveedor y sus herramientas están registrados. El complemento de Navisworks no está terminado. |
| Power BI | En desarrollo. El proveedor y la herramienta existen, pero no están registrados en el hub. |
-| Excel, Parquet y DuckDB | Previsto. |
+| Excel, Parquet y DuckDB | Planificado. |
+
+Los nombres de producto y los logotipos pertenecen a sus respectivos propietarios. El banner los usa solo para mostrar con qué trabaja este proyecto.
## Instalar el complemento de Revit
@@ -353,7 +365,7 @@ y About.
- El puente de Revit escucha solo en localhost.
- El servidor lee y escribe únicamente dentro de las carpetas de `MCP_REVIT_ALLOWED_DIRECTORIES`.
- Las herramientas que modifican el modelo necesitan un plan aprobado, salvo que desactives la aprobación.
-- Las llamadas a herramientas se registran en un log de auditoría y los secretos se ocultan.
+- Las llamadas a herramientas se registran en un registro de auditoría y los secretos se enmascaran.
Los detalles están en [docs/security.md](../security.md). Para notificar una
vulnerabilidad, sigue [SECURITY.md](../../SECURITY.md).
@@ -370,8 +382,9 @@ dentro de Revit.
### ¿Con qué asistentes de IA funciona?
Con cualquier cliente MCP capaz de iniciar un servidor stdio local. Documentamos Claude
-Desktop, VS Code con GitHub Copilot y los clientes que leen una configuración estándar de
-`mcpServers`. El chat del panel también puede usar una clave de API de Anthropic
+Desktop, VS Code con GitHub Copilot, Cursor y Codex, y los clientes que leen una configuración estándar de
+`mcpServers`. Windsurf, Cline, Roo Code, Continue, Zed, Claude Code y Gemini CLI deberían funcionar
+de la misma manera, pero no se han probado. Consulta la [compatibilidad](../compatibility.md). El chat del panel también puede usar una clave de API de Anthropic
o las herramientas de línea de comandos `claude` o `codex`, si están instaladas. Consulta
[ADR 0012](../0012-native-agent-chat-backend.md).
diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md
index 566dce3..af632d8 100644
--- a/docs/i18n/README.fr.md
+++ b/docs/i18n/README.fr.md
@@ -23,13 +23,19 @@ Serveur MCP open source et add-in natif pour Revit 2024 – 2027. Fonctionne ave
<img src="../images/readme/demo.gif" alt="Démo : un assistant IA trouve 12 portes sans Mark et prépare un plan. Le plan attend dans le panneau Revit que vous l'approuviez, puis les valeurs sont relues pour vérification. Valeurs d'exemple, session simulée." width="900">
</p>
-Connectez Claude, Codex ou un autre client MCP au modèle Revit que vous avez ouvert. AEC Model Bridge associe un serveur MCP en Python à un add-in Revit natif : les outils en lecture seule inspectent le modèle immédiatement, et les modifications du modèle exigent par défaut un plan approuvé. [Voir le processus d'approbation](#fonctionnement-de-lapprobation).
+AEC Model Bridge est le serveur MCP open source pour Revit qui permet à Claude, Codex, Cursor et à d'autres assistants IA de lire et de modifier le modèle Revit que vous avez ouvert, chaque modification étant d'abord approuvée par vous. Il associe un serveur MCP en Python à un add-in Revit natif : les outils en lecture seule inspectent le modèle immédiatement, et les modifications du modèle exigent par défaut un plan approuvé. [Voir le processus d'approbation](#fonctionnement-de-lapprobation).
+
+<p align="center">
+ <img src="../images/readme/works-with.svg" alt="Compatible avec : Claude Desktop, VS Code avec GitHub Copilot, Cursor et Codex disposent d'une configuration documentée. D'autres clients MCP, comme Claude Code, Windsurf, Cline, Continue, Zed et Gemini CLI, devraient aussi fonctionner. Applications : Revit 2024 à 2027, Rhino, Grasshopper, Navisworks (en cours). Données : IFC, Speckle, Excel, SQLite. Protocole : MCP sur stdio avec une porte d'approbation." width="900">
+</p>
+
+La configuration est documentée pour Claude Desktop, VS Code avec GitHub Copilot, Cursor et Codex. Il s'agit d'un serveur MCP stdio standard : d'autres clients, comme Claude Code, Windsurf, Cline, Continue, Zed et Gemini CLI, devraient donc fonctionner aussi. Consultez la [compatibilité](../compatibility.md) pour savoir ce qui est documenté et ce qui n'a pas été testé.
Le même serveur inclut l'inspection IFC, l'automatisation de Rhino et Grasshopper, et l'intégration Speckle. L'[état des intégrations](#autres-intégrations) distingue les fournisseurs disponibles de ceux qui sont en cours de développement.
## Exemples de flux de travail
-Pour les BIM coordinateurs : contrôler la qualité du modèle, examiner les éléments concernés, approuver une correction de paramètres, puis vérifier les résultats et exporter un rapport. Ces exemples utilisent des outils du [catalogue actuel](../tools-generated.md).
+Pour les coordinateurs BIM : contrôler la qualité du modèle, examiner les éléments concernés, approuver une correction de paramètres, puis vérifier les résultats et exporter un rapport. Ces exemples utilisent des outils du [catalogue actuel](../tools-generated.md).
| Flux de travail | Exemple de demande | Outils utilisés |
| --- | --- | --- |
@@ -38,14 +44,14 @@ Pour les BIM coordinateurs : contrôler la qualité du modèle, examiner les él
| Production de plans | "Prépare une liste de feuilles à partir de ce CSV, puis propose de créer les feuilles et de placer les vues." | `revit_batch_create_sheets_from_csv`, `revit_place_viewport_on_sheet` |
| Contrôle IFC | "Affiche les niveaux de ce fichier IFC, inspecte les propriétés des murs et signale les problèmes de validation du schéma." | `ifc_get_spatial_structure`, `ifc_get_properties`, `ifc_validate` |
-Pour un premier essai dans Revit, essayez :
+Pour un premier essai dans Revit, testez ceci :
```text
Read the active model's warnings. Group them by description and show the
affected element IDs. Then suggest which issues to investigate first.
```
-Essayez ensuite une correction de paramètre, en remplaçant le niveau et la valeur par ceux de votre projet :
+Testez ensuite une correction de paramètre, en remplaçant le niveau et la valeur par ceux de votre projet :
```text
Find walls on Level 02 and show their current Comments values. Propose setting
@@ -55,7 +61,7 @@ the plan in Revit, apply it and read the values back to confirm the result.
Pour les modifications, l'assistant crée un plan avec `plan_actions` ; vous l'examinez dans le panneau Revit avant que `execute_plan` ne l'applique. Le contrôle IFC fonctionne sans Revit.
-Les modules de QA/QC et de rapports basés sur des instantanés (snapshots) nécessitent un snapshot enregistré compatible. Le transfert actuel du snapshot de Revit vers le module exige une cohérence entre le nom de fichier et l'espace de travail ; si vous omettez `snapshot_id`, des données d'exemple générées peuvent être renvoyées. Pour l'inspection en direct, utilisez les outils Revit directs ci-dessus. [Correctifs prévus et démo](../roadmap.md).
+Les modules de QA/QC et de rapports basés sur des snapshots nécessitent un snapshot enregistré compatible. Le transfert actuel du snapshot de Revit vers le module exige que le nom de fichier et l'espace de travail concordent ; si vous omettez `snapshot_id`, des données d'exemple générées peuvent être renvoyées. Pour l'inspection en direct, utilisez les outils Revit directs ci-dessus. [Correctifs prévus et démo](../roadmap.md).
## Démarrage rapide
@@ -153,7 +159,7 @@ Le hub bloque tout appel d'outil qui modifie le modèle s'il n'est pas accompagn
Si un plan approuvé se révèle erroné par la suite, `rollback_plan` l'annule. L'annulation utilise la fonction Annuler de Revit dans la même session, ou les valeurs de paramètres inverses. Les opérations irréversibles, comme l'écriture de fichiers, demandent une seconde confirmation. Le cycle de vie est décrit dans l'[ADR 0008](../0008-approval-gate-lifecycle.md).
-Pour les pipelines sans surveillance, vous pouvez définir `MCP_REVIT_APPROVAL_MODE=auto`. Cela désactive la vérification humaine ; ne l'utilisez donc que dans un environnement maîtrisé.
+Pour les pipelines sans surveillance, vous pouvez définir `MCP_REVIT_APPROVAL_MODE=auto`. Cela désactive la vérification par un humain ; ne l'utilisez donc que dans un environnement maîtrisé.
## Versions de Revit prises en charge
@@ -178,6 +184,8 @@ Il vous faut aussi Windows 10 ou 11, Python 3.11 ou plus récent, et une install
| Power BI | En cours. Le fournisseur et l'outil existent, mais ne sont pas enregistrés dans le hub. |
| Excel, Parquet et DuckDB | Prévu. |
+Les noms de produits et les logos appartiennent à leurs propriétaires respectifs. La bannière ne les utilise que pour montrer avec quoi ce projet fonctionne.
+
## Installer l'add-in Revit
**Le plus simple (Windows) :** téléchargez `AECModelBridge-Setup-<version>.exe` depuis la [dernière version](https://github.com/Sam-AEC/aec-model-bridge/releases/latest), double-cliquez dessus, choisissez vos versions de Revit et redémarrez Revit. Il installe l'add-in, le serveur Python fourni et, si vous cochez la case, les paramètres de Claude Desktop et de VS Code, avec une sauvegarde de vos paramètres actuels. Désinstallez-le depuis les Paramètres de Windows. Les étapes ci-dessous servent à compiler depuis les sources.
@@ -278,7 +286,7 @@ La réponse doit indiquer `healthy` et la version de Revit en cours d'exécution
## Sécurité
-- Le pont Revit écoute uniquement sur localhost.
+- Le pont Revit n'est accessible que via localhost.
- Le serveur lit et écrit uniquement dans les dossiers listés dans `MCP_REVIT_ALLOWED_DIRECTORIES`.
- Les outils qui modifient le modèle exigent un plan approuvé, sauf si vous désactivez l'approbation.
- Les appels d'outils sont consignés dans un journal d'audit, et les secrets sont masqués.
@@ -293,7 +301,7 @@ Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants
### Avec quels assistants IA cela fonctionne-t-il ?
-Avec tout client MCP capable de lancer un serveur stdio local. Nous documentons Claude Desktop, VS Code avec GitHub Copilot, et les clients qui lisent une configuration `mcpServers` standard. Le chat du panneau peut aussi utiliser une clé d'API Anthropic ou les outils en ligne de commande `claude` ou `codex`, s'ils sont installés. Voir l'[ADR 0012](../0012-native-agent-chat-backend.md).
+Avec tout client MCP capable de lancer un serveur stdio local. Nous documentons Claude Desktop, VS Code avec GitHub Copilot, Cursor et Codex, ainsi que les clients qui lisent une configuration `mcpServers` standard. Windsurf, Cline, Roo Code, Continue, Zed, Claude Code et Gemini CLI devraient fonctionner de la même façon, mais n'ont pas été testés. Voir la [compatibilité](../compatibility.md). Le chat du panneau peut aussi utiliser une clé d'API Anthropic ou les outils en ligne de commande `claude` ou `codex`, s'ils sont installés. Voir l'[ADR 0012](../0012-native-agent-chat-backend.md).
### L'IA peut-elle modifier mon modèle sans demander ?
@@ -301,7 +309,7 @@ Pas dans le mode par défaut. Les outils qui modifient le modèle sont bloqués
### Mon modèle est-il envoyé dans le cloud ?
-Le serveur et l'add-in s'exécutent sur votre machine, et le pont écoute sur localhost. Ce que voit l'assistant IA dépend du client utilisé : les résultats des outils sont transmis au fournisseur de modèle de ce client. Les fournisseurs orientés cloud, comme Speckle, ne s'exécutent que lorsque vous les configurez et appelez leurs outils.
+Le serveur et l'add-in s'exécutent sur votre machine, et le pont n'est accessible que via localhost. Ce que voit l'assistant IA dépend du client utilisé : les résultats des outils sont transmis au fournisseur de modèle de ce client. Les fournisseurs orientés cloud, comme Speckle, ne s'exécutent que lorsque vous les configurez et appelez leurs outils.
### Cela fonctionne-t-il avec des fichiers IFC sans Revit ?
diff --git a/docs/i18n/README.it.md b/docs/i18n/README.it.md
index c8ca216..c2216f0 100644
--- a/docs/i18n/README.it.md
+++ b/docs/i18n/README.it.md
@@ -23,13 +23,19 @@ Server MCP open source e add-in nativo per Revit 2024 – 2027. Funziona con Cla
<img src="../images/readme/demo.gif" alt="Demo: un assistente IA trova 12 porte senza Mark e prepara un piano. Il piano attende nel pannello di Revit finché non lo approvi, poi i valori vengono riletti per verifica. Valori di esempio, sessione simulata." width="900">
</p>
-Collega Claude, Codex o un altro client MCP al modello Revit che hai aperto. AEC Model Bridge unisce un server MCP in Python a un add-in Revit nativo: gli strumenti di sola lettura ispezionano subito il modello, mentre le modifiche al modello richiedono, per impostazione predefinita, un piano approvato. [Vedi il flusso di approvazione](#come-funziona-lapprovazione).
+AEC Model Bridge è il server MCP open source per Revit che permette a Claude, Codex, Cursor e ad altri assistenti IA di leggere e modificare il modello Revit che hai aperto, con ogni modifica approvata prima da te. Unisce un server MCP in Python a un add-in Revit nativo: gli strumenti di sola lettura ispezionano subito il modello, mentre le modifiche al modello richiedono, per impostazione predefinita, un piano approvato. [Vedi il flusso di approvazione](#come-funziona-lapprovazione).
+
+<p align="center">
+ <img src="../images/readme/works-with.svg" alt="Compatibile con: Claude Desktop, VS Code con GitHub Copilot, Cursor e Codex hanno una configurazione documentata. Anche altri client MCP, come Claude Code, Windsurf, Cline, Continue, Zed e Gemini CLI, dovrebbero funzionare. Applicazioni: Revit 2024-2027, Rhino, Grasshopper, Navisworks (in sviluppo). Dati: IFC, Speckle, Excel, SQLite. Protocollo: MCP su stdio con un punto di approvazione." width="900">
+</p>
+
+La configurazione è documentata per Claude Desktop, VS Code con GitHub Copilot, Cursor e Codex. È un server MCP stdio standard, quindi dovrebbero funzionare anche altri client come Claude Code, Windsurf, Cline, Continue, Zed e Gemini CLI. Consulta la [compatibilità](../compatibility.md) per sapere cosa è documentato e cosa non è stato testato.
Lo stesso server include l'ispezione IFC, l'automazione di Rhino e Grasshopper e l'integrazione con Speckle. Lo [stato delle integrazioni](#altre-integrazioni) distingue i provider disponibili da quelli ancora in sviluppo.
## Flussi di lavoro di esempio
-Per i BIM coordinator: controllare la qualità del modello, esaminare gli elementi interessati, approvare una correzione dei parametri, poi verificare i risultati ed esportare un report. Questi esempi usano strumenti del [catalogo attuale](../tools-generated.md).
+Per i coordinatori BIM: controllare la qualità del modello, esaminare gli elementi interessati, approvare una correzione dei parametri, poi verificare i risultati ed esportare un report. Questi esempi usano strumenti del [catalogo attuale](../tools-generated.md).
| Flusso di lavoro | Richiesta di esempio | Strumenti usati |
| --- | --- | --- |
@@ -38,14 +44,14 @@ Per i BIM coordinator: controllare la qualità del modello, esaminare gli elemen
| Produzione degli elaborati | "Prepara un elenco di tavole (sheet) da questo CSV, poi proponi di creare le tavole e di posizionare le viste." | `revit_batch_create_sheets_from_csv`, `revit_place_viewport_on_sheet` |
| Verifica IFC | "Mostra i piani di questo file IFC, ispeziona le proprietà dei muri e segnala i problemi di validazione dello schema." | `ifc_get_spatial_structure`, `ifc_get_properties`, `ifc_validate` |
-Per una prima prova in Revit, prova con:
+Per una prima prova in Revit, usa questo prompt:
```text
Read the active model's warnings. Group them by description and show the
affected element IDs. Then suggest which issues to investigate first.
```
-Poi prova una correzione di parametro, sostituendo livello e valore con quelli del tuo progetto:
+Poi prova con una correzione di parametro, sostituendo livello e valore con quelli del tuo progetto:
```text
Find walls on Level 02 and show their current Comments values. Propose setting
@@ -55,7 +61,7 @@ the plan in Revit, apply it and read the values back to confirm the result.
Per le modifiche, l'assistente crea un piano con `plan_actions`; lo esamini nel pannello di Revit prima che `execute_plan` lo applichi. La verifica IFC funziona senza Revit.
-I moduli di QA/QC e di report basati su snapshot richiedono uno snapshot salvato compatibile. L'attuale passaggio dello snapshot da Revit al modulo richiede che nome del file e workspace coincidano; omettendo `snapshot_id` possono essere restituiti dati di esempio generati. Per l'ispezione dal vivo usa direttamente gli strumenti Revit indicati sopra. [Correzioni previste e demo](../roadmap.md).
+I moduli di QA/QC e di report basati su snapshot richiedono uno snapshot salvato compatibile. L'attuale passaggio dello snapshot da Revit al modulo richiede che nome del file e workspace coincidano; omettendo `snapshot_id` possono essere restituiti dati di esempio generati. Per l'ispezione in tempo reale usa direttamente gli strumenti Revit indicati sopra. [Correzioni previste e demo](../roadmap.md).
## Avvio rapido
@@ -65,11 +71,11 @@ I moduli di QA/QC e di report basati su snapshot richiedono uno snapshot salvato
[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-111111?style=for-the-badge)](https://cursor.com/en/install-mcp?name=aec-model-bridge&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL1NhbS1BRUMvYWVjLW1vZGVsLWJyaWRnZSNzdWJkaXJlY3Rvcnk9cGFja2FnZXMvbWNwLXNlcnZlci1yZXZpdCIsImFlYy1tb2RlbC1icmlkZ2UiXSwiZW52Ijp7Ik1DUF9SRVZJVF9NT0RFIjoiYnJpZGdlIn19)
[![Claude Desktop bundle](https://img.shields.io/badge/Claude_Desktop-.mcpb_bundle-D97757?style=for-the-badge)](https://github.com/Sam-AEC/aec-model-bridge/releases/latest)
-I pulsanti richiedono solo [uv](https://docs.astral.sh/uv/getting-started/installation/) e nessun'altra configurazione: il server usa `~/Documents/AEC Model Bridge` come workspace, a meno che tu non ne imposti uno tuo. Per Claude Desktop, scarica il file `.mcpb` dall'ultima release e aprilo. Per lavorare dal vivo con Revit servono comunque Revit e [l'add-in](#installare-ladd-in-di-revit); la modalità mock non richiede nulla.
+I pulsanti richiedono solo [uv](https://docs.astral.sh/uv/getting-started/installation/) e nessun'altra configurazione: il server usa `~/Documents/AEC Model Bridge` come workspace, a meno che tu non ne imposti uno tuo. Per Claude Desktop, scarica il file `.mcpb` dall'ultima release e aprilo. Per lavorare con Revit in esecuzione servono comunque Revit e [l'add-in](#installare-ladd-in-di-revit); la modalità mock non richiede nulla.
**Configurazione manuale**
-Per l'automazione dal vivo di Revit servono Windows, Revit 2024-2027 con licenza, Python 3.11 o successivo, [uv](https://docs.astral.sh/uv/getting-started/installation/) e l'add-in di Revit ([passaggi di installazione](#installare-ladd-in-di-revit)). Poi aggiungi questo al tuo `claude_desktop_config.json` (Codex, Cursor e VS Code usano gli stessi valori; le due variabili di directory sono facoltative e, per impostazione predefinita, puntano al workspace indicato sopra):
+Per automatizzare Revit in tempo reale servono Windows, Revit 2024-2027 con licenza, Python 3.11 o successivo, [uv](https://docs.astral.sh/uv/getting-started/installation/) e l'add-in di Revit ([passaggi di installazione](#installare-ladd-in-di-revit)). Poi aggiungi questo al tuo `claude_desktop_config.json` (Codex, Cursor e VS Code usano gli stessi valori; le due variabili di directory sono facoltative e, per impostazione predefinita, puntano al workspace indicato sopra):
```json
{
@@ -153,7 +159,7 @@ L'hub blocca qualsiasi chiamata a uno strumento che modifica il modello, a meno
Se un piano approvato si rivela poi sbagliato, `rollback_plan` lo annulla. Il rollback usa Annulla di Revit nella stessa sessione oppure i valori inversi dei parametri. Le operazioni che non si possono annullare, come la scrittura di file, chiedono una seconda conferma. Il ciclo di vita è descritto nell'[ADR 0008](../0008-approval-gate-lifecycle.md).
-Per le pipeline non presidiate puoi impostare `MCP_REVIT_APPROVAL_MODE=auto`. Questo disattiva il controllo umano, quindi usalo solo in un ambiente controllato.
+Per le pipeline non presidiate puoi impostare `MCP_REVIT_APPROVAL_MODE=auto`. Questo disattiva il controllo da parte di una persona, quindi usalo solo in un ambiente controllato.
## Versioni di Revit supportate
@@ -178,11 +184,13 @@ Servono inoltre Windows 10 o 11, Python 3.11 o successivo e un'installazione di
| Power BI | In sviluppo. Il provider e lo strumento esistono ma non sono registrati nell'hub. |
| Excel, Parquet e DuckDB | Pianificato. |
+I nomi dei prodotti e i loghi appartengono ai rispettivi proprietari. Il banner li usa solo per mostrare con cosa funziona questo progetto.
+
## Installare l'add-in di Revit
**Il modo più semplice (Windows):** scarica `AECModelBridge-Setup-<version>.exe` dall'[ultima release](https://github.com/Sam-AEC/aec-model-bridge/releases/latest), fai doppio clic, scegli le tue versioni di Revit e riavvia Revit. Installa l'add-in, il server Python incluso e, se spunti la casella, le impostazioni di Claude Desktop e VS Code, con un backup delle tue impostazioni attuali. Si disinstalla da Impostazioni di Windows. I passaggi seguenti servono per compilare dai sorgenti.
-Si installano due parti: il server MCP in Python e l'add-in di Revit. L'automazione dal vivo di Revit le richiede entrambe.
+Devi installare due componenti: il server MCP in Python e l'add-in di Revit. L'automazione di Revit in tempo reale le richiede entrambe.
### 1. Installare il server MCP
@@ -278,10 +286,10 @@ La risposta deve riportare `healthy` e la versione di Revit in esecuzione. In Re
## Sicurezza
-- Il bridge di Revit ascolta solo su localhost.
+- Il bridge di Revit è raggiungibile solo da localhost.
- Il server legge e scrive solo nelle cartelle indicate in `MCP_REVIT_ALLOWED_DIRECTORIES`.
- Gli strumenti che modificano il modello richiedono un piano approvato, a meno che tu non disattivi l'approvazione.
-- Le chiamate agli strumenti vengono scritte in un log di audit e i segreti vengono oscurati.
+- Le chiamate agli strumenti vengono scritte in un registro di audit e i segreti vengono mascherati.
I dettagli sono in [docs/security.md](../security.md). Per segnalare una vulnerabilità, segui [SECURITY.md](../../SECURITY.md).
@@ -293,7 +301,7 @@ Il Model Context Protocol (MCP) è uno standard aperto che permette agli assiste
### Con quali assistenti IA funziona?
-Con qualsiasi client MCP in grado di avviare un server stdio locale. Documentiamo Claude Desktop, VS Code con GitHub Copilot e i client che leggono una configurazione `mcpServers` standard. La chat del pannello può anche usare una chiave API Anthropic o gli strumenti da riga di comando `claude` o `codex`, se installati. Vedi l'[ADR 0012](../0012-native-agent-chat-backend.md).
+Con qualsiasi client MCP in grado di avviare un server stdio locale. Documentiamo Claude Desktop, VS Code con GitHub Copilot, Cursor e Codex, oltre ai client che leggono una configurazione `mcpServers` standard. Windsurf, Cline, Roo Code, Continue, Zed, Claude Code e Gemini CLI dovrebbero funzionare allo stesso modo, ma non sono stati testati. Vedi la [compatibilità](../compatibility.md). La chat del pannello può anche usare una chiave API Anthropic o gli strumenti da riga di comando `claude` o `codex`, se installati. Vedi l'[ADR 0012](../0012-native-agent-chat-backend.md).
### L'IA può modificare il mio modello senza chiedere?
@@ -301,7 +309,7 @@ Non nella modalità predefinita. Gli strumenti che modificano il modello sono bl
### Invia il mio modello al cloud?
-Il server e l'add-in girano sul tuo computer e il bridge ascolta su localhost. Ciò che vede l'assistente IA dipende dal client che usi: i risultati degli strumenti vanno al provider del modello di quel client. I provider rivolti al cloud, come Speckle, funzionano solo quando li configuri e ne chiami gli strumenti.
+Il server e l'add-in girano sul tuo computer e il bridge è raggiungibile solo da localhost. Ciò che vede l'assistente IA dipende dal client che usi: i risultati degli strumenti vanno al provider del modello di quel client. I provider rivolti al cloud, come Speckle, funzionano solo quando li configuri e ne chiami gli strumenti.
### Funziona con i file IFC senza Revit?
@@ -309,7 +317,7 @@ Sì. Il provider IFC legge i file con IfcOpenShell. Può restituire metadati del
### Posso usarlo senza Revit installato?
-Puoi eseguire il server in modalità mock per sviluppo e test. Il lavoro dal vivo sul modello richiede Revit 2024-2027 e l'add-in.
+Puoi eseguire il server in modalità mock per sviluppo e test. Il lavoro in tempo reale sul modello richiede Revit 2024-2027 e l'add-in.
## Release e versioni
diff --git a/docs/i18n/README.pt-BR.md b/docs/i18n/README.pt-BR.md
index dff6faa..8c711f7 100644
--- a/docs/i18n/README.pt-BR.md
+++ b/docs/i18n/README.pt-BR.md
@@ -23,7 +23,13 @@ Servidor MCP de código aberto e add-in nativo para Revit 2024 – 2027. Funcion
<img src="../images/readme/demo.gif" alt="Demonstração: um assistente de IA encontra 12 portas sem Mark e prepara um plano. O plano espera no painel do Revit até você aprovar, depois os valores são lidos de volta para conferência. Valores de exemplo, sessão simulada." width="900">
</p>
-Conecte o Claude, o Codex ou outro cliente MCP ao modelo do Revit que você tem aberto. O AEC Model Bridge combina um servidor MCP em Python com um add-in nativo do Revit: as ferramentas somente leitura inspecionam o modelo na hora e, por padrão, qualquer alteração no modelo exige um plano aprovado. [Veja o fluxo de aprovação](#como-funciona-a-aprovação).
+O AEC Model Bridge é o servidor MCP de código aberto para Revit que permite ao Claude, ao Codex, ao Cursor e a outros assistentes de IA ler e editar o modelo do Revit que você tem aberto, com cada alteração aprovada antes por você. Ele combina um servidor MCP em Python com um add-in nativo do Revit: as ferramentas somente leitura inspecionam o modelo na hora e, por padrão, qualquer alteração no modelo exige um plano aprovado. [Veja o fluxo de aprovação](#como-funciona-a-aprovação).
+
+<p align="center">
+ <img src="../images/readme/works-with.svg" alt="Funciona com: Claude Desktop, VS Code com GitHub Copilot, Cursor e Codex têm configuração documentada. Outros clientes MCP, como Claude Code, Windsurf, Cline, Continue, Zed e Gemini CLI, também devem funcionar. Aplicativos: Revit 2024 a 2027, Rhino, Grasshopper, Navisworks (em desenvolvimento). Dados: IFC, Speckle, Excel, SQLite. Protocolo: MCP sobre stdio com uma barreira de aprovação." width="900">
+</p>
+
+A configuração está documentada para Claude Desktop, VS Code com GitHub Copilot, Cursor e Codex. É um servidor MCP stdio padrão, então outros clientes, como Claude Code, Windsurf, Cline, Continue, Zed e Gemini CLI, também devem funcionar. Veja a [compatibilidade](../compatibility.md) para saber o que está documentado e o que não foi testado.
O mesmo servidor inclui inspeção de IFC, automação do Rhino e do Grasshopper e integração com o Speckle. O [status das integrações](#outras-integrações) separa os provedores disponíveis dos que ainda estão em desenvolvimento.
@@ -53,9 +59,9 @@ Comments to "Coordination reviewed" for the elements I choose. After I approve
the plan in Revit, apply it and read the values back to confirm the result.
```
-Nas edições, o assistente cria um plano com `plan_actions`; você o revisa no painel do Revit antes de o `execute_plan` aplicá-lo. A revisão de IFC funciona sem o Revit.
+Para alterações no modelo, o assistente cria um plano com `plan_actions`; você o revisa no painel do Revit antes de o `execute_plan` aplicá-lo. A revisão de IFC funciona sem o Revit.
-Os módulos de QA/QC e de relatórios baseados em snapshot exigem um snapshot salvo compatível. A passagem atual do snapshot do Revit para o módulo exige alinhamento entre o nome do arquivo e o workspace; se você omitir `snapshot_id`, podem ser retornados dados de exemplo gerados. Para inspeção ao vivo, use as ferramentas diretas do Revit acima. [Correções planejadas e demo](../roadmap.md).
+Os módulos de QA/QC e de relatórios baseados em snapshot exigem um snapshot salvo compatível. A passagem atual do snapshot do Revit para o módulo exige alinhamento entre o nome do arquivo e o workspace; se você omitir `snapshot_id`, podem ser retornados dados de exemplo gerados. Para inspeção em tempo real, use as ferramentas diretas do Revit acima. [Correções planejadas e demo](../roadmap.md).
## Início rápido
@@ -65,11 +71,11 @@ Os módulos de QA/QC e de relatórios baseados em snapshot exigem um snapshot sa
[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-111111?style=for-the-badge)](https://cursor.com/en/install-mcp?name=aec-model-bridge&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL1NhbS1BRUMvYWVjLW1vZGVsLWJyaWRnZSNzdWJkaXJlY3Rvcnk9cGFja2FnZXMvbWNwLXNlcnZlci1yZXZpdCIsImFlYy1tb2RlbC1icmlkZ2UiXSwiZW52Ijp7Ik1DUF9SRVZJVF9NT0RFIjoiYnJpZGdlIn19)
[![Claude Desktop bundle](https://img.shields.io/badge/Claude_Desktop-.mcpb_bundle-D97757?style=for-the-badge)](https://github.com/Sam-AEC/aec-model-bridge/releases/latest)
-Os botões só precisam do [uv](https://docs.astral.sh/uv/getting-started/installation/) e de nenhuma outra configuração: o servidor usa `~/Documents/AEC Model Bridge` como workspace, a menos que você defina o seu. Para o Claude Desktop, baixe o arquivo `.mcpb` da última versão e abra-o. O trabalho ao vivo no Revit ainda exige o Revit e [o add-in](#instalar-o-add-in-do-revit); o modo mock não exige nada.
+Os botões só precisam do [uv](https://docs.astral.sh/uv/getting-started/installation/) e de nenhuma outra configuração: o servidor usa `~/Documents/AEC Model Bridge` como workspace, a menos que você defina o seu. Para o Claude Desktop, baixe o arquivo `.mcpb` da última versão e abra-o. O trabalho com o Revit em execução ainda exige o Revit e [o add-in](#instalar-o-add-in-do-revit); o modo mock não exige nada.
**Configuração manual**
-Para a automação ao vivo do Revit você precisa de Windows, Revit 2024 a 2027 licenciado, Python 3.11 ou superior, [uv](https://docs.astral.sh/uv/getting-started/installation/) e o add-in do Revit ([passos de instalação](#instalar-o-add-in-do-revit)). Depois adicione isto ao seu `claude_desktop_config.json` (Codex, Cursor e VS Code usam os mesmos valores; as duas variáveis de diretório são opcionais e, por padrão, apontam para o workspace acima):
+Para a automação do Revit em tempo real você precisa de Windows, Revit 2024 a 2027 licenciado, Python 3.11 ou superior, [uv](https://docs.astral.sh/uv/getting-started/installation/) e o add-in do Revit ([passos de instalação](#instalar-o-add-in-do-revit)). Depois adicione isto ao seu `claude_desktop_config.json` (Codex, Cursor e VS Code usam os mesmos valores; as duas variáveis de diretório são opcionais e, por padrão, apontam para o workspace acima):
```json
{
@@ -153,7 +159,7 @@ O hub bloqueia qualquer chamada de ferramenta que altere o modelo, a menos que e
Se um plano for aprovado e depois se mostrar errado, `rollback_plan` o reverte. A reversão usa o Desfazer do Revit na mesma sessão ou os valores de parâmetros inversos. Operações que não podem ser revertidas, como a gravação de arquivos, pedem uma segunda confirmação. O ciclo de vida está no [ADR 0008](../0008-approval-gate-lifecycle.md).
-Para pipelines sem supervisão, você pode definir `MCP_REVIT_APPROVAL_MODE=auto`. Isso desliga a verificação humana, então use apenas em um ambiente controlado.
+Para pipelines sem supervisão, você pode definir `MCP_REVIT_APPROVAL_MODE=auto`. Isso desliga a verificação feita por uma pessoa, então use apenas em um ambiente controlado.
## Versões do Revit compatíveis
@@ -178,11 +184,13 @@ Você também precisa de Windows 10 ou 11, Python 3.11 ou superior e uma instala
| Power BI | Em desenvolvimento. O provedor e a ferramenta existem, mas não estão registrados no hub. |
| Excel, Parquet e DuckDB | Planejado. |
+Os nomes de produtos e os logotipos pertencem aos seus respectivos donos. O banner os usa apenas para mostrar com o que este projeto funciona.
+
## Instalar o add-in do Revit
**O jeito mais fácil (Windows):** baixe `AECModelBridge-Setup-<version>.exe` da [última versão](https://github.com/Sam-AEC/aec-model-bridge/releases/latest), dê um clique duplo, escolha suas versões do Revit e reinicie o Revit. Ele instala o add-in, o servidor Python incluído e, se você marcar a opção, as configurações do Claude Desktop e do VS Code, com backup das configurações atuais. Desinstale pelas Configurações do Windows. Os passos abaixo são para compilar a partir do código-fonte.
-Você instala duas partes: o servidor MCP em Python e o add-in do Revit. A automação ao vivo do Revit precisa das duas.
+Você instala duas partes: o servidor MCP em Python e o add-in do Revit. A automação do Revit em tempo real precisa das duas.
### 1. Instalar o servidor MCP
@@ -278,10 +286,10 @@ A resposta deve indicar `healthy` e a versão do Revit em execução. No Revit,
## Segurança
-- A ponte do Revit escuta apenas em localhost.
+- A ponte do Revit só é acessível por localhost.
- O servidor lê e grava somente dentro das pastas listadas em `MCP_REVIT_ALLOWED_DIRECTORIES`.
- Ferramentas que alteram o modelo exigem um plano aprovado, a menos que você desative a aprovação.
-- As chamadas de ferramentas são gravadas em um log de auditoria, e os segredos são ocultados.
+- As chamadas de ferramentas são gravadas em um log de auditoria, e os segredos são mascarados.
Os detalhes estão em [docs/security.md](../security.md). Para relatar uma vulnerabilidade, siga [SECURITY.md](../../SECURITY.md).
@@ -293,7 +301,7 @@ O Model Context Protocol (MCP) é um padrão aberto que permite a assistentes de
### Quais assistentes de IA funcionam com ele?
-Qualquer cliente MCP capaz de iniciar um servidor stdio local. Documentamos o Claude Desktop, o VS Code com GitHub Copilot e clientes que leem uma configuração `mcpServers` padrão. O chat do painel também pode usar uma chave de API da Anthropic ou as ferramentas de linha de comando `claude` ou `codex`, se estiverem instaladas. Veja o [ADR 0012](../0012-native-agent-chat-backend.md).
+Qualquer cliente MCP capaz de iniciar um servidor stdio local. Documentamos o Claude Desktop, o VS Code com GitHub Copilot, o Cursor e o Codex, além de clientes que leem uma configuração `mcpServers` padrão. Windsurf, Cline, Roo Code, Continue, Zed, Claude Code e Gemini CLI devem funcionar da mesma forma, mas não foram testados. Veja a [compatibilidade](../compatibility.md). O chat do painel também pode usar uma chave de API da Anthropic ou as ferramentas de linha de comando `claude` ou `codex`, se estiverem instaladas. Veja o [ADR 0012](../0012-native-agent-chat-backend.md).
### A IA pode alterar meu modelo sem pedir?
@@ -301,7 +309,7 @@ Não no modo padrão. As ferramentas que alteram o modelo ficam bloqueadas até
### Ele envia meu modelo para a nuvem?
-O servidor e o add-in rodam na sua máquina, e a ponte escuta em localhost. O que o assistente de IA enxerga depende do cliente que você usa: os resultados das ferramentas vão para o provedor de modelo desse cliente. Provedores voltados à nuvem, como o Speckle, só rodam quando você os configura e chama as ferramentas deles.
+O servidor e o add-in rodam na sua máquina, e a ponte só é acessível por localhost. O que o assistente de IA enxerga depende do cliente que você usa: os resultados das ferramentas vão para o provedor de modelo desse cliente. Provedores voltados à nuvem, como o Speckle, só rodam quando você os configura e chama as ferramentas deles.
### Funciona com arquivos IFC sem o Revit?
@@ -309,7 +317,7 @@ Sim. O provedor de IFC lê arquivos com o IfcOpenShell. Ele pode retornar metada
### Posso usar sem o Revit instalado?
-Você pode executar o servidor em modo mock para desenvolvimento e testes. O trabalho ao vivo com o modelo exige o Revit 2024 a 2027 e o add-in.
+Você pode executar o servidor em modo mock para desenvolvimento e testes. O trabalho em tempo real com o modelo exige o Revit 2024 a 2027 e o add-in.
## Versões e lançamentos