vwork
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VWORK_PROJECT | No | Project identifier used by the server. Defaults to eoffice. | eoffice |
| VWORK_BASE_URL | No | Base URL for the vWork API. Defaults to the production URL; change only when using another environment such as UAT. | https://vWork.vnfite.com.vn |
| VWORK_PASSWORD | No | Optional password for automatic login when not using the CLI token file. Must be used together with VWORK_USERNAME. Stored in the MCP client environment. | |
| VWORK_USERNAME | No | Optional username for automatic login when not using the CLI token file. Must be used together with VWORK_PASSWORD. | |
| VWORK_ALLOW_WRITE | No | Set to true to allow write operations (PATCH/POST/PUT/DELETE). Defaults to false (read-only). Writes are only permitted for /project-tracker, /tickets, and /notification; /auth/* and /permissions/* are always blocked. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| vwork_meA | Xem hồ sơ tài khoản VWork đang đăng nhập (họ tên, username, phòng ban) và danh sách quyền. |
| vwork_tracker_docsB | Lấy danh sách doc trong bảng tiến độ dự án (project tracker). Trả về tối đa |
| vwork_tracker_searchB | Tìm task/doc trong bảng tiến độ theo từ khoá, trạng thái, người phụ trách, collection hoặc chỉ task quá hạn. |
| vwork_tracker_summaryA | Tổng hợp bảng tiến độ: số lượng theo collection, trạng thái, người phụ trách; đếm task quá hạn và sắp đến hạn (3 ngày). |
| vwork_my_tasksA | Task/doc được giao cho CHÍNH tài khoản đang đăng nhập. Tự lấy danh tính từ /user/getUserInfo rồi khớp theo tên/username/email/id. Dùng khi người dùng hỏi 'tôi đang có task gì'. |
| vwork_update_taskA | Cập nhật một task/doc trong bảng tiến độ (theo code A01/E02 hoặc collection/doc_id). Chỉ gửi field cần đổi. Yêu cầu VWORK_ALLOW_WRITE=true. |
| vwork_ticketsB | Liệt kê ticket hỗ trợ nội bộ, lọc theo trạng thái và từ khoá. |
| vwork_ticketC | Xem chi tiết một ticket theo id. |
| vwork_notificationsC | Xem thông báo chưa đọc và thông báo mới nhất của tài khoản. |
| vwork_apiB | Gọi API VWork tuỳ ý (đã có sẵn auth). GET luôn được phép trong danh sách nhóm API; PATCH/POST/PUT/DELETE chỉ khi VWORK_ALLOW_WRITE=true và thuộc nhóm an toàn. |
| vwork_project_overviewB | Ảnh chụp nhanh: tài khoản hiện tại + tổng hợp tiến độ + ticket đang mở + thông báo chưa đọc. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Most tools have a clearly distinct target: profile, tracker list/search/summary, a single task update, ticket list/detail, notifications, and a generic API escape hatch. The main overlap is vwork_my_tasks vs vwork_tracker_search (which also filters by assignee) and vwork_project_overview, which re-composes data from vwork_me, vwork_tracker_summary, vwork_tickets, and vwork_notifications. Descriptions do flag when to prefer each, keeping confusion limited.
All names share the vwork_ prefix and snake_case, with a mostly resource-oriented convention (vwork_me, vwork_tickets, vwork_ticket, vwork_notifications) plus a vwork_tracker_* namespace for the tracker family. The singular/plural pair (ticket/tickets) and the lone verb-style vwork_update_task are minor, readable deviations. No mixed camelCase or chaotic verb styles.
Eleven tools is squarely in the sweet spot for a workspace assistant covering identity, tracker, tickets, and notifications. Each tool corresponds to a recognizable user intent, and no redundant variations (e.g. process/run/execute) inflate the surface.
Read coverage is solid (list, search, aggregate, detail) and vwork_update_task covers the tracker write path, but there is no create/delete for tracker docs, no ticket create/update/comment, and no notification mark-as-read. The generic vwork_api tool is an escape hatch that partly compensates, though it requires the agent to know raw API paths and write-flag configuration.