Kết nối AI agent

Một AI agent có thể chạy InFlow CLI thay cho bạn. Với CLI, agent có thể khám phá dịch vụ, ghi danh với các dịch vụ đó và thanh toán từ Buyer Wallet của bạn. Kết nối agent theo một trong bốn cách. Để quản lý tài khoản InFlow từ một ứng dụng chat mà không cần CLI, dùng InFlow connector.

Yêu cầu coding agent kết nối InFlow

Trước tiên, bạn tự cài đặt CLI, mở khóa vault và đăng nhập. Sau đó dán prompt này vào một coding agent có thể chạy lệnh và chỉnh sửa file trên máy tính của bạn, ví dụ Claude Code, Codex hoặc Cursor.

Fetch https://inflowcli.ai/skill.md and help me connect this InFlow installation to my agent environment.

Agent dùng hướng dẫn thiết lập để tự kết nối với InFlow. Nếu agent của bạn không thể tự thay đổi thiết lập, ví dụ một cuộc trò chuyện trong Claude Desktop, bạn tự thiết lập kết nối. Xem Thiết lập ứng dụng agent của bạn. CLI in ra chính hướng dẫn thiết lập này.

inflow --bootstrap

Cài đặt các skill

CLI có ba skill. Mỗi skill là một playbook cho một tác vụ.

Skill	Tác vụ
`agentic-discovery`	Khám phá dịch vụ, offering và hành động.
`agentic-enrollment`	Ghi danh với một dịch vụ và quản lý credential của dịch vụ đó.
`agentic-payments`	Thanh toán cho endpoint MPP và x402.

Cài đặt cả ba skill cho agent có hỗ trợ skill.

npx skills add inflowpayai/inflow-cli

Sau khi cập nhật CLI, chạy lại lệnh này để làm mới các skill. Agent cũng có thể tải một skill từ CLI đã cài đặt. Bản này luôn khớp với phiên bản đã cài đặt.

inflow --skill agentic-payments

Các bản trên web nằm ở inflowcli.ai/skills/<name>.md. Các bản này theo bản phát hành mới nhất. So sánh header version: của các bản này với inflow --version. Tải playbook trước khi làm tác vụ. Riêng bước thiết lập không dạy agent thứ tự an toàn của các lệnh.

Chạy CLI dưới dạng MCP server

CLI có thể chạy dưới dạng một MCP server cung cấp các lệnh của CLI làm công cụ.

inflow --mcp

Thêm một server tên inflow vào cấu hình MCP của ứng dụng agent của bạn. Nếu cấu hình đã có phần mcpServers, thêm mục inflow. Không thay thế các server khác của bạn.

{
  "mcpServers": {
    "inflow": {
      "command": "inflow",
      "args": ["--mcp"]
    }
  }
}

Nếu ứng dụng agent của bạn không tìm thấy inflow, đặt command thành đường dẫn đầy đủ. Các ứng dụng desktop thường không nhận PATH của terminal mà bạn dùng. Để lấy đường dẫn đầy đủ, chạy một trong các lệnh này.

command -v inflow

Get-Command inflow | Select-Object -ExpandProperty Source

Trên Windows, viết mỗi dấu gạch chéo ngược trong đường dẫn JSON thành \\. Mở khóa vault trước khi bạn khởi động ứng dụng agent. Sau đó khởi động lại ứng dụng để ứng dụng tải server. Tên công cụ thay các dấu cách trong lệnh bằng dấu gạch dưới. Không dùng npx @inflowpayai/inflow --mcp. Package npm không khởi động MCP. Cài đặt CLI trước. Sau đó dùng inflow --mcp. Một số MCP host không tải skill. Với các host này, đưa đầu ra của inflow --skill <name> vào system prompt.

Kết nối InFlow connector

InFlow connector là một MCP server được lưu trữ sẵn. Connector kết nối một ứng dụng AI với tài khoản InFlow của bạn và không cần CLI. Với connector, agent có thể làm các việc sau:

Đọc số dư và các giao dịch của bạn.
Hiển thị địa chỉ nạp tiền, thêm địa chỉ rút tiền và bắt đầu rút tiền.
Tạo và thay đổi các chính sách thanh toán của bạn.
Phê duyệt hoặc từ chối các yêu cầu đang chờ.
Đọc thông tin tài khoản của bạn.

Connector không khám phá dịch vụ, không ghi danh và không thanh toán cho endpoint. Với các việc này, dùng CLI. URL của connector là https://app.inflowpay.ai/mcp. Nếu ứng dụng của bạn có một danh mục connector, tìm InFlow trong đó trước. Nếu không, tự thêm connector.

Ứng dụng	Thiết lập
Website Claude và Claude Desktop	Mở Settings > Connectors > Add custom connector. Nhập URL của connector.
Claude Code	Chạy `claude mcp add --transport http inflow https://app.inflowpay.ai/mcp`.
VS Code	Chạy MCP: Add Server và chọn HTTP. Nhập URL của connector.
Cursor	Thêm cấu hình bên dưới vào `~/.cursor/mcp.json` hoặc vào `.cursor/mcp.json` trong dự án của bạn.
Các MCP client khác	Chạy `npx -y mcp-remote https://app.inflowpay.ai/mcp`.

Cursor

{
  "mcpServers": {
    "inflow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.inflowpay.ai/mcp"]
    }
  }
}

Sau đó, ứng dụng mở InFlow trong trình duyệt của bạn. Đăng nhập và phê duyệt quyền truy cập. Các tool bạn nhận được phụ thuộc vào vai trò của tài khoản.

Thiết lập ứng dụng agent của bạn

Ứng dụng	Phương thức	Thiết lập
Claude Code	Plugin	Chạy `/plugin marketplace add inflowpayai/inflow-cli`. Sau đó chạy `/plugin install inflow@inflow`.
Codex	Plugin	Chạy `codex plugin marketplace add inflowpayai/inflow-cli`. Sau đó chạy `codex plugin add inflow@inflow`.
Cursor	MCP và skill	Thêm cấu hình MCP ở trên vào `.cursor/mcp.json` trong dự án của bạn. Cài đặt các skill và chọn Cursor.
Continue	MCP	Lưu cấu hình MCP thành `.continue/mcpServers/inflow.json` trong dự án của bạn.
Claude Desktop, Cline	MCP	Mở trình chỉnh sửa cấu hình MCP của ứng dụng. Thêm mục `inflow`. Khởi động lại ứng dụng.
GitHub Copilot trong VS Code	MCP	Chạy MCP: Add Server, chọn Command (stdio) và nhập `inflow --mcp`.
OpenClaw	Skill	Cài đặt các skill. Chọn OpenClaw cùng các skill khám phá, ghi danh và thanh toán.
Website Claude.ai	Connector	Website không thể khởi động CLI trên máy tính của bạn. Để quản lý tài khoản, dùng InFlow connector. Để thanh toán hoặc ghi danh, dùng một ứng dụng hỗ trợ MCP server cục bộ, ví dụ Claude Desktop.

Xác nhận kết nối

Yêu cầu agent liệt kê các công cụ InFlow, ví dụ balances_list và directory_search. Ứng dụng của bạn có thể thêm tiền tố vào các tên này. Nếu thiếu công cụ, làm các bước kiểm tra này.

Đảm bảo InFlow server ở trạng thái bật trong thiết lập MCP của ứng dụng.
Đọc log MCP của ứng dụng để tìm lỗi.
Đảm bảo ứng dụng có thể tìm thấy inflow. Nếu cần, dùng đường dẫn đầy đủ.
Nếu một công cụ báo vault bị khóa, chạy inflow vault unlock trong terminal của bạn. Sau đó yêu cầu agent thử lại.

Cho agent đọc CLI

Agent có thể đọc các lệnh hiện hành từ CLI đã cài đặt.

Lệnh	Đầu ra
`inflow --llms`	Chỉ mục lệnh.
`inflow --llms-full`	Manifest đầy đủ với mọi tham số.
`inflow <command> --schema`	JSON Schema của một lệnh.

Để đặt định dạng đầu ra, xem --format trong Tham khảo CLI.

Những việc thuộc về chủ sở hữu

Ba bước luôn cần chủ sở hữu.

Bước	Lý do
Mở khóa vault	CLI chỉ đọc PIN hoặc cụm mật khẩu từ terminal.
Phê duyệt đăng nhập	Chủ sở hữu phê duyệt device flow trong trình duyệt.
Phê duyệt thanh toán	InFlow gửi yêu cầu thanh toán đến chủ sở hữu khi cần phê duyệt.

Bước tiếp theo

Thanh toán cho resource

Đọc cách agent thanh toán và những gì chủ sở hữu phê duyệt.

Bắt đầu

Discover, Onboard và Pay

Nền tảng