Skip to main content

🔌 A.I. Connector

Connect Revit models with A.I. Desktop Apps (MCP), providing A.I. with +50 specialized tools for Revit analysis, edit existing elements and parameters, and create documentation in Revit.
Version 1.4. | Features depend on the versions of NonicaTab | The Best of the Best

Overview​

Traditional A.I. chats for Revit create and run code from scratch, leading to errors and limitations when handling complex tasks. This connector is different. It provides A.I. with +50 pre-built and tested tools specifically designed for exploration, analysis, editing existing elements and parameters and documenting Revit models.
The A.I. Connector uses Model Context Protocol (MCP) to establish a secure bridge between your Revit environment and compatible A.I. desktop applications, enabling sophisticated model analysis without the typical coding errors.

Key Features​

Usage is not limited to:

  • Comprehensive Reports: A.I. generates detailed reports analyzing elements, types, parameters, and project statistics.
  • Performance Analysis: A.I. examines model warnings, identifies performance bottlenecks, and suggests optimization solutions.
  • Accessibility Compliance: A.I. evaluates rooms and spaces for wheelchair accessibility and ADA compliance.
  • Schedule Integration: A.I. extracts schedule data and creates visual graphs, charts, and analytical dashboards.
  • Quality Control: A.I. performs model audits and edit elements and parameters/properties.
  • Custom Edition: A.I. analyzes specific queries about your model, and edit elements and parameters values if requested.
  • Create Room Elevations and Add To Sheets: A.I. creates elevations, views and sheets, and arranges viewports in sheets.

Sample live reports:

Requirements​

Before running the AI Connector, ensure your environment meets the following prerequisites:

 Autodesk Revit: From version 2022 to newest.
 A.I. Desktop App: Claude Desktop App, Copilot, Cursor or any other MCP compatible platform.
 NonicaTab Pro: Read + Analyze + Edit + Document existing elements in Revit models (+50 tools).
 or NonicaTab Free: Read + Analyze Revit models (37 tools).

Video​

note

The A.I. Connector is compatible from Revit 2022 to the latest release.

Usage​

Initial Setup​

  1. Launch Revit: Start Revit 2022 or later and open your target project.
  2. Access Connector: Navigate to NonicaTab → AI Connector.
  3. First-Time Setup (if tool not visible):
    • Step 1: Click dropdown menu and select "Set Up Button/Script"
    • Step 2: Select the AI Connector tool to add it to your interface
    • Step 3: Tool becomes available for use after setup completion

Establishing Connection​

  1. Launch A.I. Desktop App: Launch your compatible A.I. application (Claude Desktop, Copilot, Cursor, ...).
  2. Start Connector: Click AI Connector in NonicaTab to open the connection window.
  3. Maintain Connection: Keep the AI Connector window open and connection enabled throughout your session.

Working with A.I.​

  1. Ask Questions: In your A.I. app, ask specific questions about your Revit model:
    • "Generate a report of all doors in the project"
    • "Analyze model warnings and suggest solutions"
    • "Check accessibility compliance for all rooms"
  2. Monitor Progress: A.I. will use available tools to analyze your model and provide comprehensive responses.
  3. Review Results: A.I. generates reports, charts, and recommendations based on your model data.

Advanced Workflows​

  1. Model Auditing: Request comprehensive model health checks and optimization recommendations.
  2. Compliance Checking: Analyze accessibility, code compliance, and design standards adherence.
  3. Data Visualization: Convert schedule data into interactive charts and dashboards.
  4. Custom Analysis: Ask specific technical questions about elements, parameters, or project metrics.
  5. Edit Parameters: Ask A.I. to review and fix parameter values for you. It will find common patterns and fix formatting issues or wrong values.
  6. Room elevations: A.I. can generate room elevations and add them to a new sheet per room.

Troubleshooting​

Connect with Copilot in VSCode (or other A.I. Desktop Apps)​

The A.I. Connector automatically connects and sets up Claude Desktop App and Cursor. For Visual Studio Code with Copilot, the connection can be enabled by:

  1. Enable Connection: Enable MCP connection in VSCode and create a mcp.json file. How-to Enable MCP in VSCode

  2. Add Connection: Copy + Paste the code below into your mcp.json file from previous step.

mcp.json
{
  "mcpServers": {
    "Revit": {
        "type": "stdio",
        "command": "C:\\NONICAPRO\\OtherFiles\\System\\Core\\net8.0-windows\\RevitMCPConnection.exe",
        "args": [],
        "timeout": 15000
    }
  }
}
  1. Restart Apps: Restart VSCode and open the A.I. Connector in Revit to activate the connection.

Connection Issues​

  1. A.I. Can't Find Tools:
    • Restart your A.I. Desktop App completely
    • For Claude: Close from system tray (bottom right corner near Windows clock)
    • Re-Launch Claude and AI Connector in Revit
  2. Settings:
    • A.I. Connector automatically sets up Claude and Cursor Desktop Apps.
    • If installing in a different Windows user, find claude_desktop_config.json or mcp.json and Copy+Paste the code from section above.
  3. Setup Not Working:
    • Verify Revit 2022+ version requirement
    • Confirm A.I. app supports MCP protocol, and add Settings

Performance Optimization​

  1. Slow Response Times:
    • Close unnecessary Revit views and models
    • Ensure adequate system memory
    • Reduce model complexity for testing
  2. Connection Drops:
    • Keep AI Connector window open and active
    • Avoid switching between multiple A.I. apps simultaneously

FAQ​

Yes, the AI Connector requires Revit 2022 or newer. However, all other NonicaTab tools remain compatible with Revit 2020 and later versions.

Model Context Protocol (MCP) is a standardized communication method that allows A.I. applications to securely access and interact with external tools. This ensures reliable, error-free communication between A.I. and Revit.

If you run the A.I. Connector after your A.I. Desktop App was already open, restart the A.I. app completely. For Claude, remember to also close from the system tray. If issues persist, check "Installing from Non-Admin Windows User" below.

If you can see the Revit tools in Claude and the connector is enabled, but still Claude can´t really use the tools. It is likely that your connection with Revit is being blocked. First, try to run Revit as an Admin, and Claude as an Admin (right click and Run as Administrator). If that still did not fix it, maybe a security system or antivirus is blocking the connection. Try it with Cursor App, it has a free plan for initial testing and, depending on the system, it is more often allowed to connect with Revit.

If you installed Claude (or any other) using Admin permissions, but the Windows user is not currently Admin. Then, A.I. Connector cannot automatically set up everything for you (restriction with permissions). Go to C:\Users{ Admin }\AppData\Roaming\Claude, and Copy + Paste the code from A.I. Connector // + Settings // Manual to claude_desktop_config.json. After that, restart your A.I. Desktop App.

While technically possible, it's recommended to use one A.I. app at a time with the connector to avoid conflicts and ensure optimal performance.

NonicaTab Pro provides full access to all 35+ tools and unlimited usage. NonicaTab Free offers limited functionality with restrictions on usage.

Yes, the MCP protocol ensures secure communication. Your model data is processed locally and transmitted only to your chosen A.I. desktop application according to their respective privacy policies.

Credit​

First Revit MCP by lisiting01 and Jean Marc Couffin.