Hướng dẫn kết nối máy chủ

Máy chủ TCP/MCP cho phép truy vấn dữ liệu sức khỏe từ thiết bị khác trên mạng cục bộ. Hữu ích cho ứng dụng, script hoặc dịch vụ cùng mạng.

Tổng quan

Máy chủ tạo dịch vụ mạng nội bộ nhận kết nối từ thiết bị và ứng dụng khác. Bạn có thể truy vấn dữ liệu sức khỏe, chạy tự động hóa và tương tác lập trình.

Ví dụ dùng:

• Truy vấn sức khỏe từ máy khác trong mạng
• Tích hợp ứng dụng và script cục bộ
• Truy cập từ dòng lệnh
• Tích hợp tùy chỉnh qua giao thức MCP

Điểm chính:

• Máy chủ TCP ổn định
• Hỗ trợ MCP (Model Context Protocol)
• Chỉ mạng cục bộ
• Truy vấn gần thời gian thực
• Điều khiển tự động hóa bằng chương trình

Hạn chế:

• App phải chạy ở trước (foreground)
• Hiện chưa mã hóa — chỉ dùng trên mạng tin cậy
• Cần quyền Mạng cục bộ
• Kết nối chỉ hoạt động khi máy chủ đang chạy

Điều kiện

• Health Auto Export trên iPhone/iPad
• Thiết bị cùng mạng LAN
• Đã cấp quyền Mạng cục bộ
• Đăng ký Premium
• Mạng tin cậy

Hiển thị IP/cổng:

• App hiển thị IP của thiết bị
• Cổng mặc định thường là 9000

Phiên bản máy chủ

• v0.0.1: chế độ tương thích cũ (khuyến nghị cho các thiết lập hiện có).
• v1.0.0: hành vi cập nhật phù hợp với hợp đồng máy chủ MCP mới nhất.

Phiên bản được chọn ảnh hưởng đến giá trị mặc định của công cụ và tính tương thích của phản hồi. Nếu bạn đổi phiên bản, hãy khởi động lại máy chủ để thay đổi có hiệu lực.

Kết nối tới máy chủ

Tìm địa chỉ IP

Màn hình máy chủ hiển thị IP tự động — dùng địa chỉ này từ thiết bị khác.

Ví dụ: 192.168.1.100:9000

Sử dụng máy chủ

Giao thức MCP

Máy chủ dùng Model Context Protocol (MCP) để giao tiếp.

Nhật ký kết nối

Màn hình Máy chủ hiển thị nhật ký:

• Lần thử kết nối
• Chi tiết yêu cầu
• Thông tin phản hồi
• Thông báo lỗi

Xem nhật ký: danh sách trên màn hình Máy chủ cuộn theo thời gian — hữu ích khi gỡ lỗi.

Mẹo

1. Đồng bộ tự động:

   • Sạc thiết bị và dùng Phản chiếu iPhone
     • Khi sạc, iOS áp ít hạn chế hiệu năng hơn nên dữ liệu có thể đồng bộ thường xuyên hơn
     • Với Phản chiếu iPhone, thiết bị hoạt động như đã mở khóa. Health Auto Export có thể truy cập dữ liệu sức khỏe để chạy hành động tự động

2. Khi dùng chung tự động hóa: Sạc thiết bị và dùng Phản chiếu iPhone để iOS hạn chế hiệu năng ít hơn và HealthKit dễ khả dụng cho tác vụ nền

Để chẩn đoán sâu hơn, xuất toàn bộ nhật ký sự kiện ứng dụng từ Cài đặt → Nâng cao → Xuất nhật ký sự kiện hoặc từ Nhật ký hoạt động → Chia sẻ trên bất kỳ tự động hóa nào (cùng ZIP). Xem Hướng dẫn nhật ký sự kiện ứng dụng.