Kết nối AI với project

Bạn có thể để AI đọc cấu trúc mẫu, giải thích dữ liệu hoặc chỉnh thiết kế ngay trong project qua MCP (Beta). Kết nối này đưa các công cụ của Tembuilder vào ứng dụng AI bạn đang dùng; quyền thao tác được quyết định bởi API key của project.

1. Chọn kết nối theo việc muốn làm

Tembuilder có hai kết nối MCP:

Nếu chỉ muốn AI tra cứu hướng dẫn, thêm server tại https://<api-host>/docs/mcp vào ứng dụng AI, không cần API key. Dùng cùng API host hiển thị trong trang MCP (Beta) của project. Các bước dưới đây dành cho kết nối Project MCP.

2. Tạo API key trong project

Trong project cần kết nối, mở API Keys và tạo key với quyền phù hợp:

• mcp:read: đọc template, tài nguyên và thông tin phục vụ chỉnh mẫu.
• Thêm mcp:write: cho phép tạo, sao chép và lưu thay đổi qua các công cụ ghi.

Key xác định project mà AI truy cập. Lưu key vào phần cấu hình kết nối của ứng dụng AI; không cần dán secret vào nội dung yêu cầu chỉnh mẫu.

3. Thêm server vào ứng dụng AI

Mở mục MCP hoặc kết nối công cụ trong ứng dụng AI. Dùng endpoint trên trang MCP (Beta) của project và header ApiKey. Ví dụ cấu hình:

{
  "mcpServers": {
    "tembuilder-project": {
      "url": "https://<api-host>/mcp",
      "headers": { "ApiKey": "<YOUR_API_KEY>" }
    }
  }
}

Đây là mẫu cấu hình remote HTTP; vị trí nhập và định dạng cụ thể phụ thuộc client. Endpoint nằm trên API origin, không phải URL của trang dashboard. Nếu client dùng header Authorization, định dạng được nhận là Authorization: ApiKey ..., không phải Bearer.

4. Bắt đầu bằng việc đọc một mẫu

Sau khi kết nối, thử yêu cầu:

Đọc capabilities và liệt kê template trong project. Với mẫu tôi chọn, giải thích cấu trúc và Parameters, chưa thay đổi nội dung.

Khi AI đã tìm đúng mẫu, hãy mô tả thay đổi bạn muốn và yêu cầu AI kiểm tra preview trước khi lưu. Sau đó mở lại mẫu trong editor để kiểm tra nội dung và dữ liệu.

Project MCP hỗ trợ tạo, chỉnh mẫu và visual preview. Để dùng thay đổi cho bản PDF chính thức, lưu và publish trong app, rồi chạy render. MCP không có công cụ publish hay tạo job PDF lưu trữ.