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

# MCP

> Kết nối agent tương thích MCP của bạn với Flowglad

Kết nối một agent tương thích MCP với Flowglad để làm việc với kiến thức nghiệp vụ và bối cảnh vận hành của tổ chức bạn.

Connector có thể tìm và chỉnh sửa Page, đọc file và bản ghi đã kết nối, tạo Task, quản lý các Skill có thể tái sử dụng, và tạo hoặc chạy Automation. Các công cụ khả dụng phụ thuộc vào danh tính đã kết nối, quyền được cấp và các tính năng sản phẩm đang được bật.

## Áp dụng template

Khi `templates.apply` có trong `tools/list`, hãy cung cấp một `templateId` đã được xuất bản và một `spaceId` hiện có để tạo tất cả tài nguyên của template. Applications, Automation và các bản sao file thông thường thuộc về Space đó; Skill thuộc về tổ chức. File sử dụng tên file đã cấu hình ở thư mục gốc của Space và không bao giờ ghi đè file hiện có. Xung đột trùng tên sẽ khiến thành phần đó thất bại, trong khi các thành phần độc lập vẫn có thể tiếp tục. Việc hoàn tất file có nghĩa là các byte và metadata đã được lưu bền vững; quá trình này không chờ lập chỉ mục.

Bạn có thể tùy chọn cung cấp `connections` dưới dạng một mảng các đối tượng `{ connector, connectionId }`, với tối đa một connection cho mỗi provider. Các connection được cung cấp phải có thể truy cập, tương thích và đã được gán cho Space khi cần. Nếu bỏ qua connection, tài nguyên sẽ ở trạng thái chờ cấu hình. Phản hồi sẽ đề xuất các connection phù hợp, hoặc đề xuất tạo connection khi không có connection nào khả dụng.

Quá trình tạo chạy trong một task Trigger.dev duy nhất theo thứ tự phụ thuộc, với kết quả của từng thành phần được ghi lại trong metadata và output của task. Tính năng tự động thử lại toàn bộ task bị tắt; một task thất bại hoặc bị gián đoạn có thể để lại một phần tài nguyên. Phản hồi xác nhận rằng việc tạo đã được đưa vào hàng đợi và bao gồm các thành phần dự kiến cùng đề xuất connection; phản hồi không xác nhận rằng tài nguyên đã được tạo xong. Hãy dùng các công cụ list/get của tài nguyên để tìm và kiểm tra chúng. Các tài nguyên được tạo thành công vẫn được giữ lại nếu một thành phần khác thất bại.

Việc áp dụng template sẽ hoãn bước xác minh khả năng thực thi và không kích hoạt hay chạy các tài nguyên của nó. Mỗi lệnh gọi áp dụng đều tạo các bản sao mới, kể cả khi thử lại. Hãy dùng các công cụ tài nguyên để kiểm tra những gì đã được tạo.

## Trước khi kết nối

Bạn cần:

* Một tài khoản Flowglad có quyền truy cập vào tổ chức bạn muốn sử dụng.
* URL MCP production của tổ chức bạn.
* Một agent hoặc client hỗ trợ máy chủ MCP từ xa qua Streamable HTTP và OAuth.
* Các quyền trong tổ chức và Space cần thiết cho công việc bạn dự định thực hiện.
* Mọi Connection nguồn hoặc file đã có sẵn trong Space liên quan.

Phần bảng giá được công bố trên [trang chủ Flowglad](https://www.flowglad.com/) bao gồm MCP trong các gói Free, Plus và Max. Quyền trong tổ chức và Space, quyền cấp qua OAuth và quyền truy cập nguồn đã kết nối vẫn được áp dụng.

Các Connection tới hệ thống nghiệp vụ bên ngoài phải được cấu hình trong Flowglad và được cung cấp cho Space dự định trước khi agent có thể sử dụng chúng. Xem [Connectors](/docs/vi/connectors.md) và [Spaces](/docs/vi/spaces.md).

## Tìm URL tổ chức của bạn

Connector production sử dụng một URL riêng cho từng tổ chức:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

Thay `{orgId}` bằng ID tổ chức Flowglad thực tế của bạn. Giữ nguyên toàn bộ ID, bao gồm tiền tố `org_`. Không nhập dấu ngoặc nhọn hoặc một ID tổ chức tự bịa ra.

Trong Flowglad, mở **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**. Sao chép URL MCP của tổ chức được hiển thị ở đó. Sử dụng hướng dẫn **Website** cho URL từ xa; tab **Desktop app** riêng biệt chứa hướng dẫn thiết lập bằng dòng lệnh.

Nếu bạn không thể truy cập các cài đặt này, hãy hỏi quản trị viên Flowglad của bạn hoặc [bộ phận hỗ trợ](mailto:support@flowglad.com).

Sử dụng URL tổ chức cho connector này. Một URL riêng cho connection có thể cung cấp tập công cụ hẹp hơn và không thể thay thế cho URL tổ chức được mô tả ở đây.

## Kết nối từ Claude Desktop

Xem [video thiết lập Claude Desktop](https://youtu.be/6qqSnrqDJ2o), hoặc làm theo các bước dưới đây.

[Cách kết nối Flowglad với Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

Sử dụng luồng custom connector của Claude Desktop để thêm Flowglad và cấp quyền truy cập vào tài khoản của bạn.

**1. Mở biểu mẫu custom connector.**

Trong Claude Desktop, điều hướng đến **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**.

**2. Thêm connector Flowglad.**

Nhập **Flowglad** làm tên connector, hoặc chọn một tên khác.

Dán URL MCP đầy đủ của tổ chức vào trường URL. Bạn có thể sao chép URL này từ [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). URL sẽ có dạng như sau: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

Không thay đổi bất kỳ cài đặt connector nào khác. Chọn **Add** để tiếp tục. Ở một số phiên bản, Claude Desktop có thể gắn nhãn nút này là **Continue**.

**3. Cấp quyền cho Claude truy cập Flowglad.**

Tiếp tục luồng kết nối để cấp quyền cho Claude truy cập tài khoản Flowglad của bạn. Khi được nhắc, hãy đăng nhập, xác nhận tổ chức Flowglad dự định và xem lại quyền truy cập được yêu cầu trước khi cấp quyền.

Khi luồng hoàn tất, quay lại Claude Desktop và xác nhận rằng connection Flowglad đã khả dụng. Yêu cầu Claude kiểm tra connection Flowglad và liệt kê các Space bạn có thể truy cập.

OAuth Dynamic Client Registration là phương thức kết nối được khuyến nghị. Không thêm mật khẩu, access token, API key hay client secret vào URL máy chủ.

Hướng dẫn này mô tả việc kết nối trực tiếp Flowglad dưới dạng custom connector; việc có mặt trong thư mục connector là vấn đề riêng.

## Kết nối một MCP client khác

Thêm cùng URL tổ chức dưới dạng máy chủ MCP Streamable HTTP từ xa. Hoàn tất luồng OAuth của client bằng tài khoản Flowglad của bạn, sau đó xác minh tổ chức và các công cụ khả dụng.

Mức độ hỗ trợ khác nhau tùy client. Kết nối máy chủ thành công không có nghĩa là client tự động nhập các Skill của Flowglad. Tiện ích mở rộng khám phá Skill và công cụ `skills.list` là các giao diện khác nhau. Xem [Skills](/docs/vi/skills.md) để biết hành vi khám phá và quản lý package được hỗ trợ.

## Xử lý dữ liệu

Việc sử dụng Flowglad MCP tuân theo [Chính sách quyền riêng tư của Flowglad](https://www.flowglad.com/privacy-policy). Quản trị viên tổ chức có thể xem tất cả các lệnh gọi công cụ MCP được thực hiện tới tổ chức của mình trong [Settings > Audit](https://dashboard.flowglad.com/settings/audit).

## Khắc phục sự cố

| Triệu chứng | Bước tiếp theo |
| - | - |
| Kết nối thất bại trước khi đăng nhập | Kiểm tra URL HTTPS đầy đủ và ID tổ chức. Xác nhận client hỗ trợ MCP từ xa với OAuth. |
| Đăng nhập thành công nhưng không thể làm việc | Kiểm tra tổ chức đã chọn, membership của Space, quyền cấp MCP và các Connection khả dụng của Space. |
| Một công cụ ghi không khả dụng hoặc bị từ chối | Xác nhận các quyền cần thiết trong tổ chức và Space. Kết nối lại nếu cần một OAuth scope mới được cấp. |
| Không thể đọc một provider đã kết nối | Xác nhận quyền ủy quyền của nó đang hoạt động và Connection được cung cấp cho Space dự định. |
| Không tìm thấy một Page hoặc file | Xác nhận đúng Space, quyền truy cập trực tiếp và liên kết của nó, và nguồn vẫn còn khả dụng. |
| Một thao tác trả về job ID hoặc run ID | Kiểm tra trạng thái vòng đời hoặc trạng thái lượt chạy cuối cùng trước khi báo cáo thành công hoặc thử lại. |
| Một thao tác ghi bị hết thời gian | Kiểm tra xem nó đã hoàn tất chưa trước khi thử lại. Một số thao tác tạo bản ghi mới hoặc đưa công việc vào hàng đợi ở mỗi lần gọi. |
| Quyền truy cập hết hạn hoặc bị thu hồi | Kết nối lại qua OAuth và xác minh tổ chức cùng quyền cấp dự định. Nếu kết nối lại vẫn thất bại, hãy liên hệ bộ phận hỗ trợ. |

Để biết thông tin bảo mật chung, xem [Security](/docs/vi/security.md) và [Trust Center](https://trust.flowglad.com) của chúng tôi. Nếu bạn gặp bất kỳ khó khăn nào khi kết nối, hãy [liên hệ với chúng tôi](mailto:support@flowglad.com).

Khi liên hệ bộ phận hỗ trợ, hãy cung cấp thời gian, client, công cụ bị ảnh hưởng, mã lỗi an toàn và request ID nếu có. Không bao giờ gửi kèm mật khẩu, bearer token, cookie, URL upload/download có chữ ký hay dữ liệu khách hàng.


## Related topics

- [Skills](/docs/vi/skills.md)
- [Chào mừng](/docs/vi/agents/introduction.md)
- [Automation](/docs/vi/automations.md)


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