> ## Documentation Index
> Fetch the complete documentation index at: https://ifdocdemo.lumivescence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kết nối AI agent

> Kết nối Claude Code, Cursor, Codex hoặc một MCP client khác với InFlow bằng skill, plugin, MCP server hoặc connector.

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](#kết-nối-inflow-connector).

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

Trước tiên, bạn tự [cài đặt CLI](https://ifdocdemo.lumivescence.com/vi/agents/install-the-cli.md), mở khóa vault và [đăng nhập](https://ifdocdemo.lumivescence.com/vi/agents/authenticate.md). 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.

```text theme={null}
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](#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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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ụ.

```bash theme={null}
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.

```json theme={null}
{
  "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.

```bash macOS / Linux theme={null}
command -v inflow
```

```powershell Windows theme={null}
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`. |

```json Cursor theme={null}
{
  "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](#kết-nối-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](https://ifdocdemo.lumivescence.com/vi/reference/cli.md#tùy-chọn-toàn-cục).

## 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

> [card] [Thanh toán cho resource](https://ifdocdemo.lumivescence.com/vi/agents/pay-for-a-resource.md)
>
> Đọc cách agent thanh toán và những gì chủ sở hữu phê duyệt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.