Tài liệu

Nối AI app với Revit qua 765T Flow

Một địa chỉ MCP, bảy công cụ cổng, và mỗi lượt ghi là một bước Hoàn tác có tên. Trang này gom đủ những gì cần để cài Control Center trên Windows rồi nối Claude, ChatGPT hoặc Cursor.

Endpoint MCP

Mọi AI app trỏ vào cùng một địa chỉ, qua streamable HTTP:

https://765tflow.com/mcp

Xác thực bằng OAuth 2.1 với PKCE trong trình duyệt: lần kết nối đầu mở trang của 765T Flow và bạn bấm "Cho phép" một lần. Không có mã nào phải gõ hay dán.

Bảy công cụ cổng

Đây là những gì AI app thấy trong tools/list. 468 công cụ Revit trong catalog được mở qua flow_tools và chạy qua flow_call.

  • flow_list_instances

    Liệt kê các phiên Revit đang kết nối của tài khoản cùng tài liệu đang mở, và trả về instanceId mà mọi lời gọi catalog cần.

  • flow_read_result

    Đọc tiếp một phần của câu trả lời dài, đúng theo con trỏ next mà chính câu trả lời đó đưa ra.

  • flow_report_issue

    Gửi báo lỗi, góp ý hoặc đề xuất tính năng tới đội 765T Flow khi bạn yêu cầu, và trả về mã tham chiếu.

  • flow_tools

    Duyệt catalog: các nhóm công cụ, thành viên của một nhóm, hoặc lược đồ đầu vào chính xác của một công cụ.

  • flow_call

    Chạy một công cụ catalog theo đúng tên của nó, với đối số theo lược đồ mà flow_tools trả về.

  • flow_find

    Tìm công cụ hoặc hướng dẫn phù hợp cho một việc Revit mô tả bằng lời thường. Chỉ đọc.

  • flow_get

    Đọc trọn một hướng dẫn hoặc mục công cụ theo ref mà flow_find trả về. Chỉ đọc.

flow_find và flow_get có mặt khi thư viện hướng dẫn phía hosted sẵn sàng.

Một lượt ghi chạy thế nào

Trợ lý bạn đã nối tự quyết — không có hộp thoại duyệt nào chen giữa.

  • Xem trước là tuỳ chọn: với công cụ hỗ trợ chạy khô, lời gọi đặt dryRun để kiểm tra trước mà chưa chạm vào mô hình.
  • Mỗi lượt ghi nằm trong một bước Hoàn tác có tên trong Revit — một lần Ctrl+Z lấy lại cả lượt.
  • Sau khi ghi, công cụ báo kết quả thực thi và danh sách phần tử đã thay đổi.
  • Một lượt ghi chưa rõ kết quả không bao giờ bị chạy lại mù quáng.

Cài Control Center trên Windows

Bản cài đặt Control Center và connector bên trong Revit cho riêng người dùng Windows của bạn — không cần quyền quản trị.

  1. Tạo tài khoản miễn phí hoặc đăng nhập trên 765tflow.com — bản cài nằm trong tài khoản của bạn.

  2. Tải bản cài cho Windows rồi chạy. Nếu Windows SmartScreen hiện ra, bấm Thông tin thêm (More info), rồi Vẫn chạy (Run anyway).

  3. Mở Revit. Khi Revit hỏi về add-in 765T Flow, chọn Luôn nạp (Always Load).

Trang tải về, kèm các bước khi Windows chặn bản cài

Rồi ghép phía Revit với tài khoản của bạn:

  1. Mở 765T Flow Control Center.

  2. Bấm "Đăng nhập" trên thanh tài khoản.

  3. Trình duyệt mở đúng site này — bấm "Cho phép" một lần. Thẻ tự cập nhật khi tài khoản được chấp nhận.

Nối Claude, ChatGPT hoặc Cursor

Mỗi app thêm cùng một địa chỉ MCP; lần kết nối đầu mở trình duyệt để bạn bấm "Cho phép".

Claude

  1. Trong Claude — web hoặc desktop — mở "Customize > Connectors".

  2. Bấm "+", chọn "Add custom connector", rồi dán địa chỉ này:

    https://765tflow.com/mcp
  3. Bấm "Add" — trình duyệt hỏi "Cho phép" một lần, xong.

ChatGPT

  1. Trong ChatGPT trên web, mở Cài đặt (Settings) → Security and login, rồi bật Developer mode.

  2. Thêm một connector với địa chỉ này:

    https://765tflow.com/mcp
  3. Hoàn tất bằng một lần "Cho phép" trong trình duyệt.

Cursor

Đã cài Cursor thì bấm nút dưới đây — Cursor hỏi xác nhận rồi thêm máy chủ 765t-flow.

Thêm vào Cursor

Hoặc tự thêm khối này vào ~/.cursor/mcp.json, rồi khởi động lại Cursor:

{
  "mcpServers": {
    "765t-flow": {
      "url": "https://765tflow.com/mcp"
    }
  }
}

App khác có hỗ trợ MCP từ xa qua streamable HTTP và OAuth dùng đúng địa chỉ này. 765T Flow không ghi gì vào cấu hình của app nào.

Kiểm tra kết nối

Nhờ trợ lý gọi flow_list_instances. Câu trả lời liệt kê các phiên Revit đang kết nối; danh sách rỗng nghĩa là chưa có connector nào trực tuyến — mở Control Center, bấm "Đăng nhập" và khởi động Revit.