Kết nối với máy chủ
Kết nối với máy chủ MCP của Health Auto Export cho các máy khách AI và tập lệnh trên mạng cục bộ.
Cập nhật lần cuối: 31 tháng 10, 2026
Trên trang này
HTTPS (TLS)
HTTPS (TLS) Bật HTTPSTin cậy CA trên máy kháchThay đổi LAN IP trên iOSVí dụ điểm cuối HTTPSCấu hình máy khách
Cấu hình máy khách Claude Code (CLI)Claude Code / tệp dự án (<code>.mcp.json</code>)Cursor (<code>~/.cursor/mcp.json</code>)VS Code (<code>.vscode/mcp.json</code>)Codex CLI (<code>~/.codex/config.toml</code>)mcp-remote (iOS / LAN)Máy chủ MCP trên iOS cho phép máy khách AI và tập lệnh trên mạng cục bộ truy vấn dữ liệu sức khỏe của bạn. HTTP (Streamable MCP) là phương thức truyền tải được khuyến nghị. iOS cũng hỗ trợ TCP cho thiết lập Node-bridge.
Máy khách chạy trên Mac hoặc thiết bị khác trên cùng mạng và kết nối tới điểm cuối hiện trên iPhone.
Tổng quan
| Phương thức truyền tải | Điểm cuối |
|---|---|
| HTTP (khuyến nghị) | http://{LAN_IP}:9000/mcp (hoặc https:// khi bật HTTPS) |
| TCP | {LAN_IP}:9000 (không xác thực) |
Thay {LAN_IP} bằng địa chỉ hiện trên màn hình Máy chủ khi máy chủ đang chạy.
Trường hợp sử dụng:
- Kết nối Claude Code, Codex, Cursor hoặc VS Code trên Mac với dữ liệu sức khỏe trên iPhone
- Dùng mcp-remote (iOS / LAN) cho máy khách chỉ stdio như Claude Desktop
- Truy vấn chỉ số và buổi tập từ tập lệnh trên mạng cục bộ (HTTP)
- Tích hợp TCP qua Node bridge health-auto-export-mcp-server
Điều kiện tiên quyết
- Health Auto Export trên iPhone (ứng dụng phải ở tiền cảnh khi máy khách kết nối)
- Gói Premium
- HTTP: Bearer token từ màn hình Máy chủ
- Quyền Mạng cục bộ trên iPhone
- Thiết bị máy khách: Cùng Wi‑Fi hoặc LAN với iPhone; Node.js chỉ khi dùng mcp-remote (iOS / LAN)
Khởi động máy chủ
- Trên iPhone, mở Máy chủ từ tab Xuất. Trên iPad, dùng thanh bên.
- Chọn HTTP (khuyến nghị) hoặc TCP
- Tùy chọn bật Dùng HTTPS (hướng dẫn bên dưới)
- Chạm Khởi động máy chủ
- Sao chép URL điểm cuối và bearer token
Máy chủ đang hoạt động dừng tự động nếu Health Auto Export bị đưa ra nền, dù dùng HTTP hay TCP.
Xác thực (HTTP)
Mọi yêu cầu HTTP cần:
Authorization: Bearer <your-token>
- Tạo lại token từ màn hình Máy chủ khi cần
- Trên HTTP thuần, token được gửi qua kết nối không mã hóa—chỉ dùng trên mạng tin cậy, hoặc bật HTTPS
- TCP cũ không có xác thực (không đổi)
HTTPS (TLS)
HTTPS dùng Certificate Authority (CA) được tạo cục bộ. Xuất và tin cậy chứng chỉ trên mỗi thiết bị máy khách trước khi kết nối qua https://.
Bật HTTPS
- Mở khung nhìn Máy chủ (iPhone: tab Xuất; iPad: thanh bên)
- Bật Dùng HTTPS
- Chạm Xuất chứng chỉ CA và dùng sheet chia sẻ để AirDrop hoặc lưu tệp CA trên mỗi thiết bị máy khách
- Khởi động máy chủ — đảm bảo URL điểm cuối chuyển sang
https://
Tin cậy CA trên máy khách
Tin cậy CA đã xuất trên thiết bị chạy máy khách AI (thường là Mac của bạn):
- Xuất CA từ màn hình Máy chủ trên iPhone
- Mở PEM trong Truy cập Chuỗi khóa trên Mac máy khách
- Đặt Tin cậy → Luôn tin cậy
Phiên bản Node cho thiết lập được tạo
Thiết lập Node bridge do ứng dụng tạo dùng NODE_OPTIONS=--use-system-ca cho các phiên bản Node sau:
| Dòng Node | Phiên bản tối thiểu |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | bất kỳ |
Trên Node cũ hơn, đặt NODE_EXTRA_CA_CERTS thành đường dẫn PEM mà tiến trình bridge đọc được. Phát --use-system-ca trên Node không hỗ trợ khiến tiến trình không khởi động.
Phạm vi tin cậy:
--use-system-catin cậy toàn bộ Chuỗi khóa hệ thống, không chỉ CA của ứng dụng này.NODE_EXTRA_CA_CERTSthêm CA đã xuất vào chứng chỉ tin cậy của Node. Xem tùy chọn chứng chỉ Node.
| Loại máy khách | Thiết lập |
|---|---|
| Cursor, VS Code, Claude Code, Codex | Tin cậy Chuỗi khóa trên Mac máy khách — dùng điểm cuối https:// từ màn hình Máy chủ |
| mcp-remote (iOS / LAN) | Tin cậy CA trong Chuỗi khóa trên Mac chạy mcp-remote. Đoạn mã dùng NODE_OPTIONS=--use-system-ca khi Node đạt phiên bản tối thiểu; trên Node cũ hơn đặt NODE_EXTRA_CA_CERTS thành đường dẫn PEM đọc được |
| curl / tập lệnh | Truyền --cacert /path/to/mcp-ca.pem hoặc đặt NODE_EXTRA_CA_CERTS |
Vân tay CA hiện trên màn hình Máy chủ để bạn xác minh đã xuất đúng chứng chỉ.
Thay đổi LAN IP trên iOS
Sao chép lại URL điểm cuối nếu địa chỉ mạng của iPhone đổi. Nếu có chứng chỉ CA thay thế, xuất và cập nhật tin cậy trên mỗi thiết bị máy khách.
Ví dụ điểm cuối HTTPS
https://192.168.1.42:9000/mcp
Thay host bằng giá trị hiện trên màn hình Máy chủ.
Phiên bản hợp đồng
| Phiên bản | Tên công cụ TCP | Ghi chú |
|---|---|---|
| v1.1.0 (mặc định) | get_* |
Khuyến nghị cho thiết lập mới |
| v1.0.0 | Cũ (health_metrics, …) |
Cập nhật tương thích Claude Desktop v1.0.0 |
| v0.0.1 | Cũ | Tương thích cũ nhất |
HTTP luôn dùng tên công cụ get_*; phiên bản hợp đồng chỉ ảnh hưởng mặc định schema.
Cấu hình máy khách
Màn hình Máy chủ có đoạn mã sao chép cho mỗi tích hợp. Dùng điểm cuối và token hiện ở đó. Kiểm tra định dạng theo phiên bản máy khách.
Mọi ví dụ bên dưới dùng địa chỉ LAN giả—thay bằng địa chỉ iPhone từ màn hình Máy chủ.
Claude Code (CLI)
Chạy trên Mac (cần Claude Code CLI):
HTTP:
claude mcp add --transport http health-auto-export \
http://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
HTTPS (sau khi xuất và tin cậy CA trên Mac):
claude mcp add --transport http health-auto-export \
https://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
Claude Code / tệp dự án (.mcp.json)
{
"mcpServers": {
"health-auto-export": {
"type": "http",
"url": "http://192.168.1.42:9000/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"health-auto-export": {
"url": "http://192.168.1.42:9000/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"health-auto-export": {
"type": "http",
"url": "http://192.168.1.42:9000/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
Codex CLI (~/.codex/config.toml)
Codex kết nối qua Streamable HTTP trực tiếp — không cần Node.js bridge. Cấu hình nằm trong ~/.codex/config.toml (toàn cục) hoặc .codex/config.toml trong thư mục dự án tin cậy.
CLI (khuyến nghị):
export HAE_MCP_TOKEN="<token>"
codex mcp add health-auto-export \
--url http://192.168.1.42:9000/mcp \
--bearer-token-env-var HAE_MCP_TOKEN
Cấu hình thủ công (config.toml):
[mcp_servers.health-auto-export]
url = "http://192.168.1.42:9000/mcp"
bearer_token_env_var = "HAE_MCP_TOKEN"
enabled = true
Xuất HAE_MCP_TOKEN với bearer token trước khi khởi động Codex. Sau thiết lập, chạy /mcp trong phiên Codex để xác minh máy chủ đã kết nối.
Nếu tạo lại bearer token trong Health Auto Export, cập nhật HAE_MCP_TOKEN và chạy lại codex mcp add, hoặc xóa rồi thêm lại mục máy chủ.
mcp-remote (iOS / LAN)
Cho máy khách chỉ stdio (như Claude Desktop) không thể kết nối HTTP trực tiếp. Cần Node.js trên Mac chạy máy khách.
- Khởi động máy chủ trên iPhone và sao chép điểm cuối cùng token
- Trên Mac, chọn mcp-remote (iOS / LAN) trên màn hình Máy chủ và sao chép đoạn JSON, hoặc dán vào cấu hình MCP của máy khách (Claude Desktop → Settings → Developer → Edit Config):
{
"command": "npx",
"args": [
"-y",
"mcp-remote@0.1.16",
"http://192.168.1.42:9000/mcp",
"--transport",
"http-only",
"--header",
"Authorization: Bearer <token>"
]
}
Khi bật HTTPS:
- Xuất CA từ iPhone và tin cậy trong Truy cập Chuỗi khóa (Luôn tin cậy) trên Mac
- Dùng
https://192.168.1.42:9000/mcptrongargs - Đối với phiên bản Node được thiết lập tạo ở trên hỗ trợ, thêm đối tượng
envnày vào cùng đối tượng cấu hình máy chủ:
{
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
}
Trên Node cũ hơn, đặt NODE_EXTRA_CA_CERTS thành đường dẫn PEM đọc được. Khởi động lại máy khách stdio sau khi cập nhật cấu hình.
Đối số công cụ
Định dạng ngày
Tham số start và end chấp nhận hai định dạng:
| Định dạng | Ví dụ | Ghi chú |
|---|---|---|
yyyy-MM-dd |
2026-06-13 |
Ngày bắt đầu: nửa đêm; ngày kết thúc: 23:59:59 |
yyyy-MM-dd HH:mm:ss Z |
2026-06-13 00:00:00 +0000 |
Thời gian và offset múi giờ rõ ràng |
TCP
- JSON-RPC không mã hóa, không xác thực trên cổng 9000
- Dùng hợp đồng v1.0.0 với Node bridge
health-auto-export-mcp-servercho tên công cụ cũ - Dùng hợp đồng v1.1.0 cho tên công cụ TCP
get_* (cập nhật Node bridge riêng)
Mẹo
- Giữ Health Auto Export ở tiền cảnh trên iPhone khi máy khách kết nối
- Tạo lại token nếu nghi ngờ bị lộ
- Sao chép lại URL điểm cuối sau khi LAN IP của iPhone đổi
Nhận trợ giúp
Xem Nhận trợ giúp để gửi hỗ trợ và Nhật ký sự kiện ứng dụng để xuất chẩn đoán.