Điều khiển Mark Flow bằng AI Agent (MCP)

AI Agent (MCP) là gì

MCP (Model Context Protocol) là một “ổ cắm” chung để ứng dụng AI như Claude Desktop hay Codex dùng được công cụ bên ngoài. Khi nối Mark Flow qua MCP, AI trở thành một “agent” (trợ lý tự làm việc): bạn chỉ cần nhắn yêu cầu, AI tự gửi lệnh cho Mark Flow.

Ví dụ, bạn nhắn cho Claude: “Tạo 4 ảnh một chú mèo phi hành gia, tỉ lệ 16:9, bằng Google Flow”. Claude gửi lệnh tới Mark Flow; Mark Flow chạy ngay trên Chrome của bạn, bằng tài khoản Google Flow của bạn, rồi trả ảnh về cho Claude.

Bạn cần chuẩn bị

• Gói Pro hoặc Agency, đã đăng nhập Mark Flow.
• Một ứng dụng AI hỗ trợ MCP. Bài này hướng dẫn Claude Desktop và Codex.
• Với Claude Desktop: Node.js bản LTS tải ở nodejs.org. Cấu hình dùng lệnh npx, lệnh này đi kèm Node.js.
• Với Mark Flow 3.70.7 trở về trước: bật Flow API (cần Mark Bridge) hoặc Chạy hàng đợi theo lô ở Cài đặt › Chung › Nâng cao, nếu không lệnh tạo bằng Google Flow sẽ báo lỗi. Từ bản sau, AI Agent tự chạy qua hàng đợi, không cần bật gì. Xem Cài Mark Bridge và bật Flow API.
• Nên cài Mark Bridge: ảnh, video trả về cho AI được Mark Bridge xoá logo.

Tạo token

Token là một chuỗi ký tự bí mật giúp Mark Flow biết lệnh đến từ AI của bạn.

1. Mở trang AI Agent (MCP): bấm biểu tượng bánh răng ở góc trên bên phải side panel → Cài đặt → chọn AI Agent (MCP) ở menu trái. Cách khác: trong side panel bấm thẻ Công cụ → AI Agent.

   

2. Gõ một tên gợi nhớ vào ô bên trái nút Tạo token, ví dụ “máy công ty”, rồi bấm Tạo token.

   

3. Khung xanh Token mới, chỉ hiện một lần hiện ra, token bắt đầu bằng mfm_. Bấm Sao chép ngay và dán tạm vào chỗ an toàn, ví dụ Notepad.

4. Token xuất hiện trong danh sách bên dưới với tên gợi nhớ, dòng chưa dùng hoặc dùng lần cuối … và ngày hết hạn (sau một năm). Nhãn ở góc trên bên phải trang đổi thành số token bạn có.

Nối Claude Desktop

1. Cài Node.js bản LTS nếu máy chưa có. Kiểm tra: mở Command Prompt (Windows) hoặc Terminal (Mac), gõ node --version rồi nhấn Enter; thấy số phiên bản là được.

2. Mở Claude Desktop → Settings → mục Developer → bấm Edit Config. Claude mở file claude_desktop_config.json hoặc thư mục chứa nó.

3. Mở file đó bằng Notepad (Windows) hoặc TextEdit (Mac). Vị trí file: Windows %APPDATA%\Claude\claude_desktop_config.json, Mac ~/Library/Application Support/Claude/claude_desktop_config.json.

4. Nếu file trống hoặc chỉ có {}, xoá hết rồi dán đoạn dưới, sau đó thay TOKEN_CUA_BAN bằng token của bạn (giữ chữ Bearer và một dấu cách trước token): {"mcpServers":{"markflow":{"command":"npx","args":["-y","mcp-remote","https://api.markflow.net/mcp","--header","Authorization:${AUTH_HEADER}"],"env":{"AUTH_HEADER":"Bearer TOKEN_CUA_BAN"}}}}

5. Lưu file. Thoát hẳn Claude Desktop rồi mở lại. Đóng cửa sổ thôi là chưa đủ nếu Claude vẫn chạy nền: trên Windows, tìm biểu tượng Claude ở khay hệ thống cạnh đồng hồ và chọn thoát; trên Mac, nhấn Cmd+Q.

6. Nhắn cho Claude: “liệt kê tool markflow”. Claude trả về danh sách công cụ như generate_image, generate_video. Bạn cũng xem được danh sách này ở nút + góc dưới bên trái ô chat › Connectors.

Nối Codex

1. Đặt token vào biến môi trường MARKFLOW_MCP_TOKEN (một giá trị máy tính nhớ sẵn để chương trình đọc). Mac, Linux: mở Terminal, chạy export MARKFLOW_MCP_TOKEN='TOKEN_CUA_BAN' rồi mở Codex từ chính cửa sổ đó; thêm dòng này vào file ~/.zshrc để lần sau không phải gõ lại. Windows: mở PowerShell, chạy setx MARKFLOW_MCP_TOKEN "TOKEN_CUA_BAN", rồi đóng và mở lại cửa sổ terminal.

2. Mở file ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) bằng trình soạn văn bản. Chưa có thì tạo file mới đúng tên đó.

3. Thêm bốn dòng liệt kê ngay sau các bước này vào cuối file, mỗi dòng một hàng. Cách dễ nhất: trong trang AI Agent (MCP), thẻ Kết nối › Codex, bấm nút Sao chép dưới khối cấu hình rồi dán vào file.

   

4. Lưu file rồi khởi động lại Codex. Chạy codex mcp list hoặc gõ /mcp trong Codex: thấy markflow là đã nối.

• [mcp_servers.markflow]
• url = "https://api.markflow.net/mcp"
• bearer_token_env_var = "MARKFLOW_MCP_TOKEN"
• enabled = true

Agent làm được gì

• Bạn không cần nhớ tên công cụ: cứ nhắn bằng lời thường, ví dụ “Kiểm tra Mark Flow đã sẵn sàng chưa” hoặc “Tạo video 8 giây cảnh sóng biển lúc hoàng hôn, tỉ lệ 9:16”.
• Lần đầu dùng, Claude Desktop thường hỏi bạn có cho phép công cụ markflow chạy không; hãy cho phép.
• Kết quả: ảnh hiện ngay trong khung chat của AI, kèm link tải dùng được trong 48 giờ. Logo đã được Mark Bridge xoá.
• Mỗi tài khoản chạy một lệnh một lúc; lệnh sau chờ lệnh trước xong.
• Ảnh tham chiếu: đưa cho AI link ảnh công khai bắt đầu bằng https://, mở được mà không cần đăng nhập. Ảnh PNG, JPG hoặc WebP, tối đa 12 MB.
• Những gì agent tạo hiện trong thẻ Lịch sử với nhãn Tạo qua MCP (AI agent).

Lưu kết quả của agent về máy

Thẻ Tải về khi agent tạo ảnh ở cuối trang AI Agent (MCP) lưu thêm một bản kết quả vào máy bạn. Chỉ áp dụng cho ảnh, video agent tạo bằng Google Flow.

1. Bật công tắc ở đầu thẻ (mặc định tắt).

2. Thư mục: tên thư mục con, mặc định markflow_mcp. File nằm trong thư mục tải về chính của Mark Flow, tức Downloads/markflow_output/markflow_mcp nếu bạn để mặc định.

3. Chọn Chất lượng ảnh và Chất lượng video (mặc định 1K và 720p).

4. Bấm Lưu thay đổi ở góc trên bên phải.

Khắc phục sự cố

Các lỗi khác của Google Flow (hết lượt, bị từ chối nội dung…) được giải thích trong Xử lý sự cố.