Áp dụng template
Khitemplates.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.
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:{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ợ.
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, hoặc làm theo các bước dưới đây.
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. 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 để 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. 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.Khắc phục sự cố
Để biết thông tin bảo mật chung, xem Security và Trust Center 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.
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.