--- title: "MCP Server | Lotics - Kết nối ChatGPT, Claude với không gian làm việc" description: "Kết nối ChatGPT, Claude Desktop, Claude.ai và Claude Code với Lotics qua Model Context Protocol. Hỏi về bảng và ứng dụng của bạn ngay trong trợ lý AI bạn đang dùng, theo đúng quyền hạn của bạn." --- # MCP Server Lotics hỗ trợ **MCP (Model Context Protocol)**, nên trợ lý AI bạn đang dùng có thể đọc và ghi trực tiếp vào không gian làm việc. Kết nối ChatGPT, Claude Desktop, Claude.ai hoặc Claude Code một lần, rồi hỏi bằng ngôn ngữ thường ngày: "lô hàng nào còn thiếu chứng từ", "tạo báo giá cho khách này", "tháng trước thông quan bao nhiêu container". Kết nối hoạt động **với tư cách là bạn**. Nó chạm tới đúng những bảng và ứng dụng mà tài khoản của bạn chạm tới — không hơn, và không có gì mà màn hình của chính bạn không hiển thị. --- ## Địa chỉ endpoint ``` https://api.lotics.ai/mcp ``` Một endpoint, hai cách xác thực. Dùng cách nào là tùy ứng dụng khách. | Ứng dụng khách | Cách kết nối | | --- | --- | | ChatGPT (web, máy tính, di động) | Đăng nhập Lotics từ phần cài đặt kết nối | | Claude Desktop / Claude.ai | Thêm kết nối tùy chỉnh, đăng nhập Lotics | | Claude Code | Khóa API | | Ứng dụng MCP khác | Khóa API | --- ## Kết nối ChatGPT 1. Trong ChatGPT, mở **Settings → Connectors → Add custom connector** (có trên các gói Plus, Pro, Team, Enterprise và Edu — quản trị viên có thể cần bật trước). 2. Đặt tên `Lotics` và điền địa chỉ máy chủ `https://api.lotics.ai/mcp`. 3. Chọn phương thức xác thực **OAuth** rồi lưu. 4. ChatGPT mở trang đăng nhập Lotics. Đăng nhập, chọn **tổ chức** và **không gian làm việc** cho kết nối này, rồi chấp thuận. Kết nối xong, mở một cuộc trò chuyện và yêu cầu ChatGPT dùng Lotics. Nó có thể liệt kê bảng, truy vấn bản ghi, chạy các truy vấn đã lưu của ứng dụng và kích hoạt những hành động ứng dụng đó cung cấp. ## Kết nối Claude Desktop hoặc Claude.ai 1. Mở **Settings → Connectors → Add custom connector**. 2. Điền địa chỉ máy chủ MCP từ xa: `https://api.lotics.ai/mcp`. 3. Claude mở trang đăng nhập Lotics. Đăng nhập, chọn **tổ chức** và **không gian làm việc**, rồi chấp thuận. Cùng một kết nối dùng được trong ứng dụng Claude trên máy tính, trên claude.ai và trên ứng dụng di động. ## Kết nối Claude Code Claude Code dùng khóa API thay vì đăng nhập qua trình duyệt. Tạo khóa trong Lotics tại **Cài đặt → Khóa API**, rồi chạy: ```bash claude mcp add --transport http lotics https://api.lotics.ai/mcp \ --header "Authorization: Bearer ltk_khoa_cua_ban" ``` Nếu tổ chức của bạn có nhiều không gian làm việc, thêm một header nữa để chỉ định: ```bash --header "X-Workspace-Id: wsp_ma_khong_gian_lam_viec" ``` ## Kết nối ứng dụng MCP khác Trỏ ứng dụng tới `https://api.lotics.ai/mcp` qua streamable HTTP và gửi khóa API dưới dạng `Authorization: Bearer ltk_...`. Ứng dụng nào hỗ trợ OAuth 2.1 kèm đăng ký ứng dụng động thì dùng cách đăng nhập qua trình duyệt — không cần đăng ký trước với chúng tôi. Bản mô tả máy đọc được của máy chủ này — tên, giao thức truyền, endpoint và các header — được công bố tại `https://lotics.ai/.well-known/mcp.json`, dành cho ứng dụng hoặc registry tự khám phá máy chủ thay vì được đưa sẵn địa chỉ. --- ## Chọn không gian làm việc Mỗi kết nối phục vụ **một không gian làm việc tại một thời điểm**. - **Đăng nhập qua trình duyệt (ChatGPT, Claude):** bạn chọn tổ chức và không gian làm việc ngay trên trang chấp thuận. Muốn đổi thì kết nối lại và chọn nơi khác — lựa chọn mới thay thế lựa chọn cũ. - **Khóa API:** gửi header `X-Workspace-Id`. Tổ chức chỉ có một không gian làm việc thì bỏ qua cũng được. --- ## Kết nối làm được gì **Bảng của bạn.** Liệt kê bảng, đọc và tìm bản ghi, tạo, cập nhật và xóa bản ghi — với mọi bảng bạn được chia sẻ. Bảng chưa được chia sẻ thì không hiện ra và không đọc được; bảng nào giới hạn dòng hoặc ẩn trường với bạn thì kết nối cũng chỉ thấy đúng phần bạn được thấy. **Ứng dụng của bạn.** Hỏi trợ lý xem bạn có những ứng dụng nào, rồi hỏi một ứng dụng làm được gì, và nó có thể chạy các truy vấn cùng hành động đã lưu của ứng dụng đó — đúng những cái mà nút bấm và màn hình của ứng dụng vẫn dùng. Điều này vẫn đúng khi bạn không có quyền trực tiếp trên các bảng phía sau ứng dụng, y như khi bạn tự mở ứng dụng lên: ứng dụng trả lời qua các truy vấn do người viết nó soạn sẵn, và những truy vấn đó ấn định bạn nhận về dòng nào, cột nào. **Kho kiến thức của bạn.** Duyệt cây tài liệu, tìm trong đó và đọc từng trang — sổ tay, biểu thuế, quy trình mà không gian làm việc đang giữ, giới hạn trong những tài liệu được chia sẻ cho bạn. Việc soạn tài liệu vẫn nằm trong Lotics, nơi trợ lý hỗ trợ bạn soạn đã nắm cách kho tài liệu được sắp xếp. **Chứng từ.** Tạo file Excel, Word hoặc PDF đã điền sẵn từ mẫu của bạn — đúng những mẫu mà quy trình vẫn dùng — và nhận về file. Hỏi được có những mẫu nào và mỗi mẫu cần những trường gì. **File của bạn.** Hỏi một chứng từ nói gì thì trợ lý đọc lại cho bạn — Word, Excel, CSV và văn bản về dưới dạng nội dung mà trợ lý xử lý được. Hỏi chính file đó thì bạn nhận một liên kết mở được trong một giờ, không cần đăng nhập. Đưa file vào từ bất kỳ địa chỉ nào thì file nằm trong không gian làm việc, sẵn sàng đính vào bản ghi. *Trên ChatGPT, file bạn đính kèm có thể lưu thẳng vào không gian làm việc. Trên Claude, bạn tự đính file hoàn chỉnh trong Lotics.* Mọi thay đổi trợ lý ghi vào đều được ghi nhận là thay đổi **của bạn**, hiện trong lịch sử bản ghi, và kích hoạt đúng những tự động hóa mà một thay đổi làm trực tiếp trên Lotics sẽ kích hoạt. ## Kết nối không làm được gì - Chạm tới bảng, ứng dụng, tài liệu hay không gian làm việc bạn chưa được cấp quyền. Khi quyền bị thu hồi, hiệu lực áp dụng ngay ở yêu cầu kế tiếp, không phải đợi lần đăng nhập sau. - Biến quyền dùng ứng dụng thành quyền trên bảng. Dùng được một ứng dụng không bao giờ đồng nghĩa với việc đọc thẳng các bảng của ứng dụng đó. - Đổi phân quyền, quản lý thành viên, tạo khóa API hay đụng tới thanh toán. Kết nối đăng nhập qua trình duyệt bị giới hạn trong đúng endpoint này và không chạm được tới phần còn lại của API. - Hành động thay bạn trên dịch vụ khác. Ở đây không có công cụ FedEx, Lark hay kế toán — những thứ đó thuộc về bên cung cấp chúng, và ChatGPT với Claude đã có kết nối riêng cho những dịch vụ họ hỗ trợ. Khi cần kết hợp một dịch vụ như vậy với dữ liệu Lotics, việc đó nằm trong quy trình Lotics, và trợ lý chạy được quy trình. - Xây dựng. Sửa quy trình, tự động hóa, ứng dụng hay mẫu chứng từ vẫn nằm trong Lotics, nơi có sẵn hướng dẫn để làm cho đúng. Nếu trợ lý báo là không được phép, đó là chuyện chia sẻ quyền — hãy nhờ người sở hữu bảng hoặc ứng dụng chia sẻ cho bạn, kết nối sẽ nhận thay đổi ngay. --- ## Lưu ý an toàn - **Chấp thuận có cân nhắc.** Thứ gì bạn kết nối đều đọc được những gì bạn đọc được. Chỉ kết nối trợ lý bạn tin tưởng, trong không gian làm việc bạn thật sự muốn mở ra. - **Thu hồi từ phía ứng dụng.** Gỡ kết nối trong ChatGPT hoặc Claude là cắt quyền truy cập. Với ứng dụng dùng khóa API, hãy vô hiệu hóa khóa tại **Cài đặt → Khóa API**. - **Xác nhận trước khi ghi.** Trợ lý hành động theo cách nó hiểu yêu cầu của bạn. Với việc không thể hoàn tác, hãy yêu cầu nó trình bày trước những gì định thay đổi — và cân nhắc đặt một bước phê duyệt ngay trong quy trình, vì bước đó có hiệu lực bất kể ai hay cái gì kích hoạt. --- ## Liên quan - [REST API](/tai-lieu/api) — cùng khả năng dưới dạng endpoint HTTP thuần - [CLI & SDK](/tai-lieu/cli) — cho kịch bản tự động và tác nhân lập trình làm việc trong terminal - [Quyền hạn](/tai-lieu/quyen-han) — cách cấp quyền trên bảng và ứng dụng - [Ứng dụng](/tai-lieu/ung-dung) — truy vấn và hành động đã lưu của một ứng dụng là gì