Kết nối AI agent
Chọn MCP hoặc REST trên máy mà không mở app Windows ra mạng.
Trước khi bắt đầu
- Chạy app Windows; bản xem trước trên web không mở cổng API thật.
- Xác định agent chạy trên chính máy Windows này hay trên đám mây.
Các bước
Kiểm tra nơi agent chạy
Chỉ chương trình trên cùng máy mới gọi được máy chủ loopback. Claude (cloud), Lovable, Manus và ChatGPT không kết nối trực tiếp được. Bạn có thể dùng chúng soạn câu lệnh rồi đưa vào app hoặc chuyển cho agent cục bộ. Không có máy chủ MCP HTTPS công khai hay cầu nối cloud.
Bật máy chủ cục bộ
Mở Cài đặt → API & agent. Trong “Máy chủ API trên máy này”, bật “Bật máy chủ API”. Kiểm tra trạng thái đang chạy rồi chép địa chỉ hiện tại. Mặc định là
http://127.0.0.1:47831; nếu đổi cổng, phải cập nhật mọi client.Cấp khoá riêng cho agent
Tạo khoá có tên, chỉ cấp quyền cần thiết và đặt trần credit/ngày. Lưu khoá đầy đủ khi app đang hiển thị; sau đó không xem lại được. Xem khoá API.
Chọn giao diện và thử thao tác chỉ đọc
Dùng Streamable HTTP tại
/mcptheo thiết lập MCP, hoặc các endpoint HTTP trong REST API. Cả hai dùngAuthorization: Bearer <your local API key>. Bắt đầu bằngflow_statushoặcGET /v1/status, chưa tạo nội dung.Kiểm soát việc tốn credit
Đọc model và chi phí trước khi gửi. Giữ nguyên mã chống trùng khi thử lại yêu cầu; khi đã có việc, chờ chính việc đó thay vì gửi tạo mới. Xem giới hạn agent. Không đưa mật khẩu Google hoặc cookie vào cấu hình agent.
Khi đã xong
Agent trên máy đọc được trạng thái có xác thực, trong khi máy chủ desktop vẫn chỉ nghe loopback.
Nếu gặp trục trặc
Vì sao connector cloud thất bại?
127.0.0.1 của nó trỏ về môi trường của chính nó, không phải PC của bạn. Chuyển câu lệnh thủ công hoặc dùng agent cùng máy; không mở cổng ra ngoài.
Bản xem trước có máy chủ nhưng không kết nối được.
Bản web mô phỏng không mở cổng thật. Dùng app Windows và kiểm tra trạng thái đang chạy.