Lotics MCP Server
Lotics cung cấp máy chủ Model Context Protocol (MCP) cho phép các AI agent bên ngoài tương tác với workspace của bạn. Cùng 50+ công cụ mà trợ lý AI tích hợp sử dụng, nay có thể truy cập từ Claude Code, Cursor, Windsurf và bất kỳ ứng dụng MCP nào.
MCP là gì?
Model Context Protocol (MCP) là một tiêu chuẩn mở do Anthropic tạo ra, định nghĩa cách các ứng dụng AI khám phá và gọi công cụ từ các dịch vụ bên ngoài. Thay vì tích hợp API cố định, một MCP client kết nối với MCP server lúc chạy, nhận danh sách công cụ khả dụng cùng schema, và gọi chúng qua giao diện chuẩn hóa. Điều này cho phép AI agent làm việc với bất kỳ dịch vụ tương thích MCP mà không cần code tích hợp riêng.
MCP tách biệt việc khám phá công cụ và thực thi công cụ. Client hỏi server "bạn có thể làm gì?" và nhận mô tả có cấu trúc của mỗi thao tác: tham số đầu vào, kiểu dữ liệu, trường bắt buộc và giải thích dễ đọc. Mô hình AI sử dụng các mô tả này để quyết định gọi công cụ nào và cách gọi, giúp tích hợp tự động và thích ứng.
Vì MCP là giao thức mở, hệ sinh thái đang phát triển nhanh chóng. Claude Desktop, Claude Code, Cursor, Windsurf, Continue và nhiều công cụ phát triển AI khác hỗ trợ MCP nguyên bản. Bất kỳ công cụ nào bạn xây cho một client đều hoạt động với tất cả các client khác.
Tại sao Lotics có MCP Server
Lotics đã có sẵn trợ lý AI tích hợp mạnh mẽ với 50+ công cụ quản lý dữ liệu vận hành. MCP server cung cấp chính xác bộ công cụ đó cho các AI agent bên ngoài, để bạn có thể tương tác với workspace Lotics từ bất cứ đâu: IDE, terminal, script tự động hóa, hoặc giao diện chat.
Đây không phải là API đơn giản hóa hay chỉ đọc. Agent bên ngoài có toàn quyền tạo và chỉnh sửa bảng, truy vấn và cập nhật bản ghi, cấu hình view, kích hoạt workflow, tạo tài liệu, gửi email, tải file lên và tìm kiếm toàn bộ workspace. Nếu trợ lý tích hợp làm được, agent bên ngoài của bạn cũng làm được.
Lợi ích thực tế là khả năng kết hợp. Một phiên Claude Code có thể truy vấn bảng tồn kho, đối chiếu với bản ghi vận chuyển, tạo báo cáo và gửi email, tất cả trong một cuộc hội thoại. Một agent Cursor có thể đọc dữ liệu quản lý dự án trong khi viết code. Các agent tùy chỉnh có thể chạy pipeline dữ liệu định kỳ đọc từ một bảng và ghi vào bảng khác.
Cài đặt và Xác thực
Kết nối MCP client với Lotics chỉ cần ba bước: tạo API key, thêm cấu hình server vào client, và bắt đầu sử dụng. Toàn bộ quá trình mất chưa đầy hai phút.
Đầu tiên, vào Cài đặt trong workspace Lotics và tạo API key mới. Đặt tên mô tả (ví dụ: "Claude Code" hoặc "CI Pipeline") để bạn có thể theo dõi sử dụng và thu hồi sau này. Key chỉ hiển thị một lần. Sao chép ngay.
Sau đó cấu hình MCP client với URL server và API key. Lotics sử dụng HTTP transport với streaming response và xác thực qua header x-api-key. Sau khi cấu hình, công cụ tự động được khám phá lúc chạy. Không cần đăng ký công cụ thủ công.
| Tham số | Giá trị |
|---|---|
| URL Server | https://api.lotics.ai/mcp |
| Transport | HTTP với streaming (streamable-http) |
| Xác thực | Header x-api-key |
| Khám phá công cụ | Tự động khi kết nối |
Các công cụ khả dụng
MCP server cung cấp mọi công cụ mà trợ lý AI tích hợp có. Chúng bao phủ toàn bộ tính năng Lotics, từ quản lý schema đến tạo tài liệu. Công cụ được tổ chức theo lĩnh vực và sử dụng tên mô tả rõ ràng để mô hình AI có thể hiểu và sử dụng hiệu quả.
Mỗi công cụ bao gồm schema chi tiết với mô tả tham số, trường bắt buộc/tùy chọn và giá trị ví dụ. Mô hình AI sử dụng các schema này để tạo lời gọi công cụ chính xác mà không cần tài liệu bên ngoài.
| Danh mục | Thao tác | Ví dụ |
|---|---|---|
| Bảng | Tạo, đọc, cập nhật, xóa bảng | Tạo bảng vận chuyển, đổi tên trường, xóa bảng không dùng |
| Trường | Thêm, chỉnh sửa, xóa trường với cấu hình kiểu đầy đủ | Thêm trường tiền tệ, đổi trường văn bản sang rich text, cấu hình tùy chọn select |
| Bản ghi | Tạo, đọc, cập nhật, xóa, truy vấn với bộ lọc và sắp xếp | Thêm 50 mặt hàng tồn kho, tìm hóa đơn quá hạn, cập nhật hàng loạt trường trạng thái |
| View | Tạo và cấu hình view với bộ lọc, sắp xếp, nhóm, hiển thị trường | Tạo view Kanban nhóm theo trạng thái, thiết lập view lọc cho các mục quá hạn |
| Workflow | Xây dựng và quản lý quy trình tự động với trigger và bước | Tạo workflow gửi email khi trạng thái bản ghi thay đổi |
| Tài liệu | Tạo PDF, điền mẫu, tạo file Excel | Điền mẫu vận đơn với dữ liệu vận chuyển, tạo hóa đơn PDF |
| Gửi email với tệp đính kèm, xử lý trigger email đến | Gửi báo cáo đã tạo cho nhóm vận hành qua email | |
| File | Tải lên, tải xuống và quản lý tệp đính kèm trên bản ghi | Đính kèm hợp đồng đã ký vào bản ghi giao dịch |
| Tìm kiếm | Tìm kiếm toàn văn trên tất cả bảng và bản ghi trong workspace | Tìm tất cả bản ghi liên quan đến khách hàng hoặc số PO cụ thể |
Ví dụ cấu hình Client
Dưới đây là cấu hình cho Claude Code, sử dụng file .mcp.json tại thư mục gốc dự án. Các MCP client khác theo mẫu tương tự. Tham khảo tài liệu của client để biết định dạng chính xác.
Với Claude Code, tạo file .mcp.json tại thư mục gốc dự án. Kiểu server là "streamable-http" và xác thực được truyền qua đối tượng headers. Sau khi lưu, Claude Code sẽ tự động khám phá tất cả công cụ Lotics khả dụng khi bạn bắt đầu phiên làm việc mới.
| Client | File cấu hình | Ghi chú |
|---|---|---|
| Claude Code | .mcp.json tại thư mục gốc dự án | Dùng kiểu "streamable-http" với headers để xác thực |
| Claude Desktop | claude_desktop_config.json | Thêm server entry trong khóa mcpServers |
| Cursor | .cursor/mcp.json | Cùng định dạng với Claude Code |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | File cấu hình toàn cục |
| Agent tùy chỉnh | Lập trình qua MCP SDK | Dùng @modelcontextprotocol/sdk cho TypeScript/Python |
Trường hợp sử dụng
Quy trình làm việc của lập trình viên là trường hợp sử dụng trực tiếp nhất. Lập trình viên dùng Claude Code hoặc Cursor có thể yêu cầu trợ lý AI truy vấn dữ liệu vận hành, tạo bản ghi hoặc kích hoạt workflow mà không rời khỏi trình soạn code. Ví dụ, lập trình viên xây dựng tích hợp vận chuyển có thể xem schema bảng shipments, đọc bản ghi mẫu và test workflow, tất cả từ môi trường code.
Pipeline dữ liệu tự động cũng là ứng dụng phù hợp. Script định kỳ sử dụng MCP SDK có thể kết nối với Lotics, truy vấn bản ghi theo tiêu chí, thực hiện tính toán hoặc chuyển đổi, và ghi kết quả trở lại. Đây hữu ích cho đối soát hàng đêm, tạo báo cáo hoặc đồng bộ dữ liệu giữa Lotics và hệ thống bên ngoài.
Các AI agent tùy chỉnh xây dựng với MCP SDK có thể cung cấp giao diện chuyên biệt cho từng nhóm. Nhóm vận hành có thể có Slack bot truy vấn Lotics về trạng thái vận chuyển. Nhóm tài chính có thể có agent báo cáo kéo dữ liệu hóa đơn và tạo tóm tắt. Vì MCP tự động khám phá công cụ, các agent này luôn cập nhật khi công cụ mới được thêm vào Lotics.