Đến nội dung
GFlow4AI
ENTải cho Windows
Hướng dẫn/Kết nối AI agent

Thiết lập MCP cục bộ

Cập nhật 2026-11-04Thử bản mẫu trên web

Chép mẫu MCP HTTP của app, kiểm tra tương thích client và khám phá 14 công cụ.

Mục MCP nội bộ
Mục MCP nội bộ · Ảnh chụp app thật, dữ liệu mẫu

Trước khi bắt đầu

  • Giữ app Windows và agent trên cùng PC, bật máy chủ và chuẩn bị khoá API đã lưu.

Các bước

  1. Dùng đúng giao thức

    Máy chủ cung cấp MCP qua Streamable HTTP tại /mcp, trả JSON và không có luồng do máy chủ chủ động mở. MCP dùng cùng khoá Bearer và quyền như REST. Chép địa chỉ hiện tại từ Cài đặt; endpoint mặc định là http://127.0.0.1:47831/mcp.

  2. Chép đúng mẫu của app

    Trong “Kết nối MCP”, chép mẫu JSON. Dưới đây là mẫu app tạo tại cổng mặc định. Thay fsk_… bằng toàn bộ khoá và sửa cổng nếu đã đổi. Đây là mẫu chung, không phải cấu hình riêng đã kiểm cho mọi client.

    {
  "mcpServers": {
    "flow-studio": {
      "type": "http",
      "url": "http://127.0.0.1:47831/mcp",
      "headers": {
        "Authorization": "Bearer fsk_…"
      }
    }
  }
}

  3. Đối chiếu agent cục bộ trên website, không đoán cú pháp

    Website liệt kê các client chạy cùng máy sau:

    • Claude Code
    • Cursor
    • Codex
    • GitHub Copilot
    • Google Antigravity
    • Hermes Agent
    • OpenClaw
    • OpenCode
    • LM Studio
    • n8n
    • Cline
    • Warp
    • Gemini CLI
    • Grok CLI
    • Windsurf

    Với từng client, thông số kết nối đã xác minh là:

    URL: http://127.0.0.1:47831/mcp
Authorization: Bearer <your local API key>

    Chỉ dùng JSON chung ở trên nếu client nhận định dạng đó. Kho mã không cung cấp lệnh, tên tệp hoặc schema riêng cho danh sách này. Xem hướng dẫn chính thức của client để điền HTTP MCP và header; đây là hướng dẫn thiết lập, không phải chứng nhận đã thử đầu-cuối.

  4. Loại trừ kết nối chỉ chạy trên cloud

    Website còn liệt kê Claude, Lovable, Manus và ChatGPT là agent cloud. Không có cấu hình loopback hoạt động cho chúng. Dùng chúng soạn kịch bản và câu lệnh rồi chuyển nội dung thủ công hoặc qua agent cùng PC. Không công khai cổng app và không coi website là dịch vụ cấp quyền cloud.

  5. Khám phá đúng công cụ và thử an toàn

    Máy chủ cung cấp đúng 14 tên công cụ sau:

    • flow_status
    • flow_models
    • flow_upload_reference
    • flow_generate
    • flow_get_job
    • flow_wait_job
    • flow_list_jobs
    • flow_cancel_job
    • flow_extend_video
    • flow_edit_video
    • flow_upscale
    • flow_list_characters
    • flow_create_character
    • flow_list_voices

    Bắt đầu với flow_status và flow_models. Công cụ tạo và thao tác tiếp theo yêu cầu request_id; giữ nguyên mã khi thử lại. flow_wait_job chờ tối đa 50 giây mỗi lần. Quyền read dùng để xem; tải lên/tạo/huỷ cần generate; tạo nhân vật cần characters.

  6. Đưa bộ hướng dẫn của app cho agent

    Chọn “Tải bộ hướng dẫn agent” trong Cài đặt. MCP cũng cung cấp tài nguyên hướng dẫn flowstudio://guide. Đọc quy tắc model, giá và cách thử lại trước khi cho phép tạo; kiểm kết quả trong Hàng chờ và Thư viện.

Khi đã xong

Client cục bộ tương thích tìm thấy 14 công cụ và trả flow_status mà chưa bắt đầu tạo nội dung.

Nếu gặp trục trặc

Như vậy có chứng minh mọi client đều chạy được không?

Không. Kho mã xác minh máy chủ và mẫu chung, không xác minh định dạng cấu hình hiện tại hay hoạt động đầu-cuối của từng client.

Vì sao client không thấy công cụ?

Kiểm tra client chạy cùng PC, URL /mcp hiện tại, khoá Bearer và hỗ trợ HTTP MCP. Yêu cầu mang Origin từ trình duyệt bị chặn có chủ đích.