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

Khởi động máy chủ

1. Trên màn hình Máy chủ, chạm Khởi động máy chủ
2. Đợi trạng thái Đang chạy
3. Ghi nhớ địa chỉ IP và cổng hiển thị
4. Máy chủ sẵn sàng nhận kết nối

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. 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, bạn cũng có thể xuất nhật ký sự kiện ứng dụng từ khu vực Nâng cao/gỡ lỗi. Xem Hướng dẫn nhật ký sự kiện ứng dụng.