COKA AI MCP Server giúp bạn quản lý Lead, Deal, Khách hàng, Lịch hẹn... bằng ngôn ngữ tự nhiên thông qua các ứng dụng AI.

Bạn chỉ cần 2 bước để bắt đầu:

• check_circle Lấy Token xác thực từ Coka AI
• check_circle Dán cấu hình vào ứng dụng AI của bạn

Sau đó bạn có thể giao tiếp với AI để quản lý Lead, Deal, đặt lịch hẹn, tạo đơn hàng và nhiều hơn nữa.

Token là "chìa khóa" để AI truy cập dữ liệu Coka của bạn một cách an toàn.

Chọn ứng dụng AI bạn đang sử dụng:

Claude Cursor Antigravity Windsurf VS Code N8N Manus

{
    "mcpServers": {
        "coka_ai": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://mcp.coka.ai/mcp/",
                "--header",
                "CokaToken: coka_token"
            ]
        }
    }
}

{
    "mcpServers": {
        "coka-api": {
            "url": "https://mcp.coka.ai/mcp",
            "headers": {
                "CokaToken": "coka_token"
            }
        }
    }
}

{
    "mcpServers": {
        "coka_server": {
            "serverUrl": "https://mcp.coka.ai/mcp",
            "headers": {
                "CokaToken": "coka_token"
            }
        }
    }
}

{
    "mcpServers": {
        "coka-api": {
            "url": "https://mcp.coka.ai/mcp",
            "headers": {
                "CokaToken": "coka_token"
            }
        }
    }
}

{=
    "servers": {
        "coka-api": {
            "type": "sse",
            "url": "https://mcp.coka.ai/mcp",
            "headers": {
                "CokaToken": " coka_token"
            }
        }
    }
}

{
    "mcpServers": {
        "coka": {
            "type": "streamableHttp",
            "url": "https://mcp.coka.ai/mcp/",
            "headers": {
                "CokaToken": "coka_token"
            }
        }
    }
}

Sau khi kết nối thành công, nói chuyện với AI bằng ngôn ngữ tự nhiên:

leaderboard Quản lý Lead

work Quản lý Deal

calendar_month Lịch hẹn & Đơn hàng

Coka AI MCP Server — Version 3.8.0 · Tổng số 44 Tools

language Base URLs

Tất cả API đều yêu cầu header xác thực:

Authorization:  <COKA_TOKEN>
Organizationid: <organization_id>

Quản lý thông tin tổ chức, thành viên và phân loại nhãn. Đây là nhóm API nền tảng cần gọi trước khi thao tác với Lead hoặc Deal.

Lấy thông tin cá nhân

Trả về họ tên, email, số điện thoại, avatar và profileId của người dùng đang đăng nhập.

{
  "id": "prof_abc123",
  "fullName": "Nguyễn Văn A",
  "phone": "0901234567",
  "email": "nguyenvana@mail.com",
  "avatar": "https://...",
  "gender": 0,
  "dob": "1990-01-15"
}

Danh sách tổ chức

Lấy tất cả tổ chức mà người dùng là thành viên. Trả về organizationId cần thiết cho mọi API khác.

{
  "data": [
    { "id": "org_abc123", "name": "Công ty ABC", "subscription": "BUSINESS", "role": "OWNER" },
    { "id": "org_def456", "name": "Team Sales", "subscription": "PERSONAL", "role": "MEMBER" }
  ]
}

Danh sách thành viên

Liệt kê tất cả thành viên trong tổ chức. Dùng để lấy profileId khi gán người phụ trách Lead/Deal.

{
  "data": [
    { "profileId": "prof_01", "fullName": "Nguyễn Văn A", "role": "ADMIN", "email": "a@mail.com" },
    { "profileId": "prof_02", "fullName": "Trần Thị B", "role": "MEMBER", "email": "b@mail.com" }
  ]
}

Danh sách nhãn

Lấy danh sách nhãn phân loại (tags) của tổ chức. Dùng khi gắn nhãn cho Lead.

{
  "data": [
    { "id": "tag_01", "name": "Mua bán", "color": "#FF5733" },
    { "id": "tag_02", "name": "Chuyển nhượng", "color": "#33FF57" },
    { "id": "tag_03", "name": "VIP", "color": "#3357FF" }
  ]
}

Lead là khách hàng tiềm năng. Nhóm API này cho phép tạo, xem, cập nhật, gán người phụ trách, gắn nhãn và theo dõi Lead trong hệ thống CRM.

Danh sách Lead

Lọc và phân trang danh sách Lead theo thời gian, nguồn, người phụ trách. Hỗ trợ tìm kiếm nâng cao.

{
  "limit": 20,
  "offset": 0,
  "channels": [
    "LEAD"
  ],
  "startDate": "...",
  "endDate": "...",
  "assignees": []
}

{
  "data": [
    { "id": "lead_01", "fullName": "Nguyễn Văn A", "phone": "0901234567", "status": "NEW", "createdAt": "2026-03-15" },
    { "id": "lead_02", "fullName": "Trần Thị B", "phone": "0912345678", "status": "CONTACTED", "createdAt": "2026-03-14" }
  ],
  "totalCount": 25
}

Chi tiết Lead

Xem toàn bộ thông tin của một Lead: liên hệ, lịch sử chăm sóc, hoạt động, hội thoại đã liên kết.

{
  "detail": { "id": "lead_01", "fullName": "Nguyễn Văn A", "phone": "0901234567", "email": "a@mail.com", "gender": 0, "tags": ["Mua bán"] },
  "journey": [{ "type": "NOTE", "content": "Đã gọi điện...", "createdAt": "..." }],
  "schedules": [{ "id": "sch_01", "title": "Gọi điện", "isDone": false }]
}

Gán người phụ trách Lead

Chỉ định một thành viên trong tổ chức làm người phụ trách chính cho Lead.

{
  "teamId": null,
  "profileId": "<profileId>"
}

{
  "success": true
}

Đổi người theo dõi Lead

Thêm hoặc thay đổi danh sách người theo dõi (follower) của Lead. Hỗ trợ gán theo user hoặc đội sale.

{
  "teamId": null,
  "profileId": "<profileId_1>"
}, {
  "teamId": null,
  "profileId": "<profileId_2>"
}]

{
  "success": true
}

Gán nhãn cho Lead

Gắn nhãn phân loại cho Lead (ví dụ: "mua bán", "chuyển nhượng"). Hỗ trợ chế độ thêm hoặc thay thế.

{
  "tags": [
    "mua bán",
    "Chuyển nhượng"
  ]
}

{
  "success": true
}

Cập nhật thông tin Lead

Sửa một trường dữ liệu cụ thể (phone, email, gender...) mà không cần gửi toàn bộ payload.

{
  "fieldName": "gender",
  "value": "0"
}

{
  "success": true
}

Tạo Lead mới

Tạo khách hàng tiềm năng mới với thông tin liên hệ, nguồn, nhãn và người phụ trách.

{
  "fullName": "Nguyễn Văn A",
  "title": "Nguyễn Văn A",
  "phone": "",
  "email": "",
  "sourceId": "",
  "utmSource": "",
  "isBusiness": false,
  "tags": [],
  "assignees": [],
  "companyId": "",
  "customerId": "",
  "conversationId": ""
}

{
  "id": "lead_xyz789",
  "fullName": "Nguyễn Văn A",
  "status": "NEW"
}

Quản lý lịch hẹn, cuộc họp và hoạt động chăm sóc khách hàng trên Calendar. Hỗ trợ tạo, sửa, đánh dấu hoàn thành cho cả Lead và Deal.

Danh sách lịch hẹn

Lấy tất cả hoạt động (cuộc họp, cuộc gọi, tài liệu) đã đặt cho một Lead hoặc Deal.

{
  "Data": [
    { "Id": "sch_01", "Title": "Gọi điện KH", "SchedulesType": "call", "StartTime": "2026-03-20T09:00:00Z", "IsDone": false },
    { "Id": "sch_02", "Title": "Họp báo giá", "SchedulesType": "meeting", "StartTime": "2026-03-21T14:00:00Z", "IsDone": false }
  ],
  "StatusCode": 200,
  "Status": "Success"
}

Tạo lịch hẹn

Tạo hoạt động mới trên Calendar: cuộc họp, cuộc gọi, hoặc gửi tài liệu cho khách hàng.

{
  "StartTime": "...",
  "EndTime": "...",
  "Title": "...",
  "SchedulesType": "meeting|call|document",
  "IsDone": false,
  "Priority": 1,
  "Contact": [
    {
      "id": "<leadId>",
      "fullName": "Tên Lead",
      "CustomFields": {
        "area": "lead"
      }
    }
  ]
}

{
  "Data": { "Id": "sch_03", "Title": "Gặp mặt KH", "SchedulesType": "meeting",
    "StartTime": "2026-03-22T10:00:00Z", "EndTime": "2026-03-22T11:00:00Z", "IsDone": false },
  "StatusCode": 200, "Status": "Success"
}

Sửa lịch hẹn

Cập nhật tiêu đề, thời gian, nội dung hoặc mức ưu tiên của hoạt động đã tạo.

{
  "Id": "<scheduleId>",
  "StartTime": "...",
  "EndTime": "...",
  "Title": "Tiêu đề mới",
  "Content": "Nội dung mới",
  "IsDone": false,
  "Priority": 1,
  "SchedulesType": "meeting",
  "Contact": [...]
}

{
  "Data": { "Id": "sch_03", "Title": "Tiêu đề mới" },
  "StatusCode": 200, "Status": "Success"
}

Đánh dấu hoàn thành

Đánh dấu hoạt động là đã hoàn thành hoặc bỏ đánh dấu nếu chưa xong.

{
  "ScheduleId": "<scheduleId>",
  "IsDone": true
}

{
  "StatusCode": 200,
  "Status": "Success"
}

Thêm, sửa, xóa ghi chú chăm sóc trong lịch sử (journey) của Lead. Mỗi ghi chú gắn liền với một Lead cụ thể qua leadId.

Tạo ghi chú Lead

Thêm ghi chú chăm sóc mới vào lịch sử (journey) của Lead để theo dõi tiến trình.

{
  "note": "Nội dung ghi chú chăm sóc"
}

{
  "success": true
}

Sửa ghi chú Lead

Chỉnh sửa nội dung ghi chú đã tạo trước đó. Cần truyền noteId cụ thể.

{
  "note": "Nội dung ghi chú mới"
}

{
  "success": true
}

Xóa ghi chú Lead

Xóa vĩnh viễn một ghi chú khỏi lịch sử chăm sóc. Hành động không thể hoàn tác.

{
  "success": true
}

Deal là cơ hội kinh doanh trong quy trình bán hàng. Hỗ trợ tạo Deal từ Lead hoặc trực tiếp, quản lý trạng thái, giai đoạn, nhãn, người phụ trách và ghi chú Deal.

Chuyển Lead thành Deal

Chuyển đổi Lead đã có thành Deal trong quy trình bán hàng. Cần chọn Workspace và giai đoạn (stage) trước khi chuyển.

{
  "leadId": "...",
  "workspaceId": "...",
  "stageId": "...",
  "name": "Tên Deal",
  "provider": "lead",
  "assignedTo": [],
  "tagIds": [],
  "description": "",
  "notes": "",
  "buId": "",
  "assignToTeam": null
}

{
  "success": true,
  "data": { "id": "task_abc123", "name": "Deal - Nguyễn Văn A" }
}

Tạo Deal mới

Tạo Deal trực tiếp không cần Lead. Tự động tạo Order và liên kết trong 1 lần gọi. Cần chọn khách hàng, workspace.

{
  "name": "",
  "username": "Tên KH",
  "customerId": "<id>",
  "assignedTo": [...],
  "workspaceId": "...",
  "stageId": "",
  "leadId": ""
}

{
  "success": true,
  "data": { "id": "task_def456", "name": "Deal - Lê Văn C" }
}

Danh sách Deal

Lấy danh sách Deal theo giai đoạn (stage) trong Workspace. Tương đương hiển thị bảng Kanban trên giao diện web.

{
  "page": 1,
  "pageSize": 10,
  "workspaceId": "...",
  "stageId": "...",
  "statusList": [
    1
  ]
}

{
  "data": [
    { "id": "task_001", "name": "Deal A", "status": 1 },
    { "id": "task_002", "name": "Deal B", "status": 1 }
  ],
  "totalCount": 2
}

Chi tiết Deal

Xem toàn bộ thông tin Deal: khách hàng, người phụ trách, giai đoạn, đơn hàng, lịch sử di chuyển stage.

{
  "id": "task_001",
  "name": "Deal A",
  "stageId": "stg_02",
  "status": 1,
  "assignees": [{ "profileId": "prof_01", "fullName": "Nguyễn Văn A" }],
  "stageHistory": [
    { "stageId": "stg_01", "movedAt": "2026-03-10" },
    { "stageId": "stg_02", "movedAt": "2026-03-15" }
  ]
}

Chuyển giai đoạn Deal

Di chuyển Deal sang giai đoạn khác trong quy trình. Tương đương kéo thả thẻ trên bảng Kanban.

{
  "newStageId": "<newStageId>"
}

{
  "success": true
}

Nhân bản Deal

Sao chép Deal thành bản mới với hậu tố "(Bản sao)". Giữ nguyên thông tin gốc.

{}

{
  "success": true,
  "data": { "id": "task_003", "name": "Deal A (Bản sao)" }
}

Xóa Deal

Xóa vĩnh viễn một Deal khỏi hệ thống. AI luôn yêu cầu xác nhận trước khi thực hiện.

{
  "success": true
}

Cập nhật trạng thái Deal

Đánh dấu Deal là "Thành công" hoặc "Thất bại". Có thể kèm ghi chú giải thích lý do.

{
  "isSuccess": true,
  "note": ""
}

{
  "success": true,
  "message": "Task marked as successful",
  "data": true,
  "pagination": null,
  "totalPrice": null
}

Tạo lịch hẹn cho Deal

Tạo hoạt động (cuộc họp, gọi điện) gắn liền với Deal. Dùng Calendar API với workspaceId + taskId.

{
  "StartTime": "...",
  "EndTime": "...",
  "Title": "...",
  "SchedulesType": "meeting|call|document",
  "WorkspaceId": "<workspaceId>",
  "Priority": 2
}

{
  "Data": { "Id": "sch_deal_01", "Type": "NOREPEAT", "Title": "Gọi điện",
    "WorkspaceId": "<workspaceId>", "SchedulesType": "call", "IsDone": false, "Priority": 2 },
  "StatusCode": 200, "Status": "Success"
}

Tạo ghi chú Deal

Thêm ghi chú chăm sóc vào lịch sử (journey) của Deal để theo dõi tiến trình kinh doanh.

{
  "content": "Nội dung ghi chú"
}

{
  "success": true,
  "message": "Task journey created successfully",
  "data": {
    "id": "<journeyId>",
    "taskId": "<taskId>",
    "content": "Nội dung ghi chú",
    "journeyType": "NOTE",
    "createdBy": "<profileId>",
    "createdDate": "2026-03-11T09:44:08.157Z"
  }
}

Danh sách nhãn Deal

Lấy các nhãn màu sắc có sẵn trong Workspace. Dùng khi gắn nhãn quy trình cho Deal.

{
  "success": true,
  "data": [
    { "id": "<tagId>", "workspaceId": "<workspaceId>", "name": "lúa",
      "textColor": "#FFFFFF", "backgroundColor": "#EF4444" }
  ]
}

Gán nhãn cho Deal

Gắn nhãn quy trình cho Deal. Lưu ý: thao tác này thay thế toàn bộ nhãn hiện tại.

{
  "tagIds": [
    "<tagId1>",
    "<tagId2>"
  ]
}

{
  "success": true
}

Đổi người theo dõi Deal

Thay đổi danh sách người theo dõi hoặc người phụ trách Deal. Hỗ trợ gán theo user hoặc đội nhóm.

{
  "assigneeType": "FOLLOWER|OWNER",
  "userIds": [
    "<profileId>"
  ],
  "teamIds": []
}

{
  "success": true
}

Tạo đơn hàng (Order) với sản phẩm, liên kết đơn hàng vào Deal, và đánh dấu hoàn thành bước chăm sóc Lead sau khi chuyển đổi thành công.

Tạo đơn hàng

Tạo đơn hàng mới với danh sách sản phẩm, số lượng và giá. Cần gọi sau khi tạo Deal thành công.

// Luồng 1 (Lead)
{
  "leadId": "...",
  "workspaceId": "...",
  "actor": "<profileId>",
  "totalPrice": 200000,
  "orderDetails": [
    {
      "productId": "...",
      "quantity": 2,
      "price": 100000
    }
  ]
}

// Luồng 2 (Deal)
{
  "customerId": "<taskId>",
  "workspaceId": "...",
  "actor": "...",
  "totalPrice": 200000,
  "orderDetails": [
    {
      "productId": "...",
      "quantity": 2,
      "unitPrice": 100000
    }
  ]
}

{
  "success": true,
  "data": { "id": "order_001" }
}

Liên kết đơn hàng với Deal

Gắn đơn hàng đã tạo vào Deal tương ứng. Gọi ngay sau khi tạo Order thành công.

{
  "orderId": "<orderId>"
}

{
  "success": true
}

Hoàn thành bước chăm sóc

Đánh dấu hoàn thành bước chăm sóc hiện tại của Lead trong flow. Thường gọi sau khi chuyển Lead thành Deal thành công.

{
  "isComplete": true
}

{
  "success": true
}

Mỗi tính năng được thực hiện bằng chuỗi API calls theo thứ tự. Click vào từng thẻ để xem chi tiết.

{ "data": [{ "id": "org_abc123", "name": "Công ty ABC", "subscription": "BUSINESS" }] }

{ "data": [{ "id": "src_001", "name": "Facebook" }, { "id": "src_002", "name": "Website" }] }

{ "data": [{ "id": "tag_01", "name": "Mua bán" }, { "id": "tag_02", "name": "Chuyển nhượng" }] }

{ "data": [{ "profileId": "prof_01", "fullName": "Nguyễn Văn A", "role": "ADMIN" }] }

{ "id": "lead_xyz789", "fullName": "Trần Thị B", "phone": "0901234567", "status": "NEW" }

{ "data": [{ "id": "ws_001", "name": "Kinh doanh BĐS" }, { "id": "ws_002", "name": "Bán hàng Online" }] }

{ "data": [{ "id": "stg_01", "name": "Tiếp nhận" }, { "id": "stg_02", "name": "Đang xử lý" }, { "id": "stg_03", "name": "Chốt deal" }] }

{ "id": "task_abc123", "name": "Deal - Trần Thị B", "stageId": "stg_01", "status": 1 }

{ "data": [{ "id": "prod_01", "name": "Căn hộ 2PN", "price": 2500000000 }, { "id": "prod_02", "name": "Căn hộ 3PN", "price": 3500000000 }] }

{ "id": "order_001", "totalPrice": 2500000000, "orderDetails": [{ "productId": "prod_01", "quantity": 1 }] }

{ "success": true, "message": "Order linked successfully" }

{ "data": [{ "id": "cust_01", "fullName": "Lê Văn C", "phone": "0912345678", "isBusiness": false }] }

{ "data": [{ "id": "ws_001", "name": "Kinh doanh BĐS" }] }

{ "data": [{ "id": "stg_01", "name": "Tiếp nhận" }, { "id": "stg_02", "name": "Đang xử lý" }] }

{ "data": [{ "profileId": "prof_01", "fullName": "Nguyễn Văn A" }] }

{ "data": [{ "id": "dtag_01", "name": "Ưu tiên", "color": "#FF5733" }] }

{ "data": [{ "id": "prod_01", "name": "Căn hộ 2PN", "price": 2500000000 }] }

{ "dealId": "task_def456", "orderId": "order_002", "name": "Deal - Lê Văn C", "status": 1 }

{ "data": [{ "id": "ws_001", "name": "Kinh doanh BĐS" }] }

{ "data": [{ "id": "stg_01", "name": "Tiếp nhận" }, { "id": "stg_02", "name": "Đang xử lý" }] }

{ "data": [{ "id": "task_001", "name": "Deal A", "status": 1 }, { "id": "task_002", "name": "Deal B", "status": 1 }], "totalCount": 2 }

{ "data": [{ "id": "lead_01", "fullName": "Nguyễn A", "phone": "090xxx", "status": "NEW" }], "totalCount": 15 }

{ "id": "lead_01", "fullName": "Nguyễn A", "phone": "090xxx", "email": "a@mail.com", "gender": 0, "tags": ["Mua bán"] }

{ "data": [{ "type": "NOTE", "content": "Đã gọi điện", "createdAt": "2026-03-15T10:00:00Z" }] }

{ "success": true, "fieldName": "phone", "value": "0987654321" }

{ "success": true, "assignedTo": { "profileId": "prof_01", "fullName": "Nguyễn Văn A" } }

{ "success": true, "followers": [{ "profileId": "prof_02", "fullName": "Trần B" }] }

{ "success": true, "tags": ["Mua bán", "VIP"] }

{ "id": "task_001", "name": "Deal A", "stageId": "stg_01", "status": 1, "stageHistory": [{ "stageId": "stg_01", "movedAt": "2026-03-10" }] }

{ "success": true, "newStageId": "stg_02", "newStageName": "Đang xử lý" }

{ "success": true, "status": 2, "note": "Khách đã ký hợp đồng" }

{ "success": true, "name": "Deal A - Cập nhật" }

{ "id": "task_003", "name": "Deal A (Bản sao)", "status": 1 }

{ "success": true, "message": "Deal deleted" }

{ "success": true, "tagIds": ["dtag_01", "dtag_02"] }

{ "success": true, "assignees": [{ "profileId": "prof_01" }] }

{ "data": [{ "id": "sch_01", "title": "Gọi điện", "schedulesType": "call", "startTime": "2026-03-20T09:00:00Z", "isDone": false }] }

{ "id": "sch_02", "title": "Họp báo giá", "schedulesType": "meeting", "startTime": "2026-03-21T14:00:00Z" }

{ "success": true, "id": "sch_02", "title": "Họp báo giá (cập nhật)" }

{ "success": true, "id": "sch_01", "isDone": true }

{ "data": [{ "id": "prod_01", "name": "Căn hộ 2PN", "price": 2500000000 }] }

{ "id": "order_001", "totalPrice": 2500000000, "status": "CREATED" }

{ "success": true, "message": "Order linked successfully" }

{ "success": true, "message": "Flow step updated" }