Trình kết nối Koko

Cập nhật lần cuối: 13 tháng 8, 2026

Koko kết nối với Claude và ChatGPT như một ứng dụng, để chuyến đi bạn lên kế hoạch trong cuộc trò chuyện có thể được lưu vào tài khoản Koko, mở trên bản đồ, chia sẻ với những người đi cùng, và chỉnh sửa về sau ngay trong cùng cuộc trò chuyện đó. Trang này trình bày cách thiết lập, chức năng của từng công cụ, những gì trợ lý có thể và không thể truy cập, cùng các giới hạn.

Thiết lập

Bạn cần một tài khoản Koko miễn phí. Trước tiên hãy đăng ký tại kokotravel.ai, hoặc tạo tài khoản trong luồng kết nối.

Thông tin server

MCP endpoint: https://kokotravel.ai/mcp
Transport: HTTP dạng streamable (JSON-RPC không trạng thái)
Authentication: OAuth 2.1 với PKCE và đăng ký client động. Không có client ID hay API key để dán vào.

Trong Claude

Mở Settings → Connectors và thêm Koko, từ thư mục hoặc dưới dạng connector tùy chỉnh bằng endpoint ở trên.
Nhấp Connect. Trang đăng nhập của Koko sẽ mở ra.
Đăng nhập bằng Google, hoặc bằng email và mã sáu chữ số, hoặc bằng tên người dùng và mật khẩu Koko của bạn. Sau đó cấp quyền truy cập.

Trong ChatGPT

Thêm Koko từ thư mục ứng dụng, hoặc dưới dạng connector bằng endpoint ở trên.
Nhấp Connect và đăng nhập vào Koko theo cùng cách.

Trong Claude Code hoặc một MCP client khác

claude mcp add --transport http koko https://kokotravel.ai/mcp

Sau đó chạy /mcp và hoàn tất đăng nhập trong trình duyệt.

Trình kết nối có thể làm gì

Sáu công cụ, tất cả chỉ trong phạm vi tài khoản bạn đã đăng nhập. Các công cụ đọc có thể chạy mà không cần prompt mỗi lần; các công cụ ghi sẽ thay đổi nội dung đã lưu của bạn, và update_koko thay thế toàn bộ một danh sách, nên Claude sẽ hỏi trước khi chạy.

send_to_koko Lưu danh sách hoặc kế hoạch vào Koko Ghi

Tạo một danh sách hoặc kế hoạch mới trong tài khoản của bạn từ các địa điểm được mô tả trong cuộc trò chuyện. Một nhóm địa điểm đơn giản sẽ thành danh sách; các địa điểm có thời gian và được nhóm theo ngày sẽ thành kế hoạch. Koko geocode từng địa điểm, rồi bổ sung điểm đánh giá, giờ mở cửa và ảnh ở nền. Trả về ngay một liên kết xem.

my_koko Danh sách & kế hoạch của tôi Chỉ đọc

Liệt kê những gì đã có trong tài khoản của bạn: tiêu đề, loại, số lượng địa điểm và id. Không phần nào khác trong tài khoản của bạn bị lộ.

get_koko Mở danh sách hoặc kế hoạch để chỉnh sửa Chỉ đọc

Trả về một danh sách hoặc kế hoạch dưới dạng cấu trúc có thể chỉnh sửa để trợ lý có thể thay đổi và đẩy phiên bản mới trở lại.

check_koko_status Kiểm tra tiến độ dựng Chỉ đọc

Báo cáo tiến độ của một lần dựng: đã nhận, đang định vị, đang bổ sung, sẵn sàng. Hữu ích ngay sau khi lưu, vì ghim xuất hiện trước còn ảnh theo sau.

update_koko Cập nhật danh sách hoặc kế hoạch Thay toàn bộ

Thay nội dung của một danh sách hoặc kế hoạch hiện có bằng phiên bản mới. Bất cứ mục nào không có trong bản thay thế sẽ bị xóa, nên thao tác này được xem là có tính phá hủy và sẽ hỏi bạn trước. id và liên kết chia sẻ vẫn giữ nguyên, nên bất kỳ ai bạn đã chia sẻ sẽ thấy bản cập nhật.

refresh_details Làm mới điểm đánh giá & ảnh Ghi

Lấy lại điểm đánh giá, bài đánh giá, giờ mở cửa và ảnh cho một danh sách hiện có. Việc này khiến Koko tốn chi phí theo từng địa điểm, nên Koko sẽ ước tính trước và chỉ thực hiện khi bạn xác nhận.

Công cụ đối tác (nhà sáng tạo được xác minh)

Tám công cụ nữa được bật cho nhà sáng tạo được xác minh, tức những thành viên chương trình đối tác đăng nội dung lên Khám phá. Trên mọi tài khoản khác, chúng trả lời “không phải nhà sáng tạo được xác minh” và không thay đổi gì. Tất cả đều chỉ nằm trong phạm vi gian hàng của chính bạn.

creator_profile Hồ sơ nhà sáng tạo của tôi Chỉ đọc

Đọc hồ sơ gian hàng của bạn: tên, thẻ, khẩu hiệu, tiểu sử, vị trí, liên kết, mạng xã hội, giá mặc định và việc bạn có hiện trong tìm kiếm hay không.

update_creator_profile Cập nhật hồ sơ nhà sáng tạo của tôi Ghi

Thay đổi chính những trường đó. Chỉ gửi phần cần đổi; riêng các thẻ được thay theo cả cụm. Tên định danh thì không bao giờ đổi được, vì đó là URL công khai của bạn.

my_listings Mục đăng bán của tôi Chỉ đọc

Mọi danh sách và kế hoạch bạn sở hữu, kèm việc nó có trên Khám phá hay không, bậc giá, liên kết chia sẻ, lượt xem 30 ngày cùng tổng lượt mua và doanh thu từ trước đến nay.

set_listing Đăng lên Khám phá / gỡ khỏi Khám phá Ghi

Đưa một danh sách hoặc kế hoạch của bạn lên kệ Khám phá công khai với một mức giá trong thang chuẩn (Miễn phí, $1, $2, $5, $10), hoặc gỡ xuống. Gỡ xuống thì giá luôn được xóa.

creator_stats Số liệu nhà sáng tạo Chỉ đọc

Lượt xem, người xem duy nhất, lượt mua và doanh thu trong 7, 30 hoặc 90 ngày, cho cả gian hàng hoặc cho một mục đăng bán, dạng tổng cộng kèm chuỗi số liệu theo ngày.

create_coupons Tạo mã giảm giá Ghi

Phát hành mã cho một mục đăng bán có phí: một mã hay năm mươi mã, dùng một lần hoặc một mã dùng được nhiều lượt. Mã giảm giá chỉ định bậc giá thấp hơn mà người mua trả (mặc định là miễn phí), chứ không bao giờ là phần trăm.

coupons Mã giảm giá của một mục đăng bán Chỉ đọc

Mọi mã trên một mục đăng bán của bạn, còn hiệu lực lẫn đã ngừng, kèm số lần đã dùng và ai đã dùng.

disable_coupon Ngừng một mã giảm giá Ghi

Khiến một mã không đổi được nữa. Lịch sử của nó vẫn được giữ.

Prompt ví dụ

“Tạo cho tôi một danh sách ba quán ramen nổi tiếng ở Shibuya, Tokyo: Ichiran Shibuya, Nagi Golden Gai và Hakata Ippudo Shibuya. Lưu vào Koko với tên ‘Shibuya Ramen’.”

Dùng send_to_koko. Bạn sẽ nhận lại một liên kết xem.

“Lập kế hoạch một ngày ở Asakusa, Tokyo: Senso-ji lúc 09:00, ăn trưa tại Daikokuya Tempura lúc 12:00, Tokyo Skytree lúc 14:00. Lưu vào Koko với tên ‘Asakusa Day’.”

Dùng send_to_koko và lưu thành một kế hoạch thay vì danh sách, vì các điểm dừng có thời gian.

“Tôi đã lưu những gì trong Koko?”

Dùng my_koko.

“Danh sách Shibuya Ramen của tôi đã sẵn sàng chưa?”

Dùng check_koko_status.

“Trong danh sách Shibuya Ramen của tôi, bỏ Hakata Ippudo và thêm Afuri Ebisu thay vào đó.”

Dùng get_koko rồi update_koko. Vẫn cùng liên kết, nội dung đã được cập nhật.

Trợ lý có thể và không thể truy cập gì

Có thể: tạo, đọc và cập nhật các danh sách và kế hoạch trong tài khoản Koko mà bạn đã đăng nhập.
Không thể: xem nội dung của bất kỳ người dùng nào khác, xoá tài khoản của bạn, thay đổi thông tin đăng nhập của bạn, hoặc công khai bất cứ thứ gì. Việc xuất bản lên kệ Discover công khai của Koko chỉ dành cho các tài khoản vận hành của chính Koko; với tài khoản thông thường, yêu cầu đó sẽ được lưu riêng tư thay vào đó và phản hồi sẽ cho bạn biết như vậy.
Quyền riêng tư của nội dung được lưu: các danh sách và kế hoạch được tạo qua connector đều ở chế độ riêng tư. Liên kết xem chỉ hiển thị cho bạn khi bạn đã đăng nhập trên ứng dụng web Koko. Chia sẻ là một bước riêng, có chủ đích mà bạn thực hiện trong ứng dụng.
Koko nhận được gì: chỉ các yêu cầu mà trợ lý thực hiện thay mặt bạn, ví dụ một danh sách tên địa điểm cần lưu. Cuộc trò chuyện của bạn vẫn ở lại với nhà cung cấp trợ lý. Chi tiết đầy đủ có trong chính sách quyền riêng tư.

Giới hạn

Các lệnh gọi tool bị giới hạn tốc độ ở khoảng 30 lần mỗi phút cho mỗi người dùng. Vượt quá mức đó, bạn sẽ nhận 429 kèm header Retry-After.
Các mục lưu được dựng ở chế độ nền và sẽ xếp hàng khi tải cao. Một kế hoạch lớn mất khoảng một phút để ảnh và xếp hạng hoàn tất.
Trình kết nối là miễn phí, và không thao tác nào của nó tiêu được tiền. Phần lõi của Koko cũng miễn phí; một số nhà sáng tạo bán danh sách của họ trên kệ Khám phá trong ứng dụng dưới dạng giao dịch App Store, nhưng dù thế nào thì thông tin thanh toán cũng không đi qua Koko. Giới hạn của tài khoản tiêu chuẩn nằm trong Điều khoản.
Koko là bản xem trước truy cập sớm do một nhóm nhỏ xây dựng. Thông tin địa điểm đến từ bên thứ ba và có thể đã lỗi thời; hãy kiểm tra những gì quan trọng trước khi bạn đi.

Ngắt kết nối

Ngắt kết nối Koko trong phần cài đặt connector của chính trợ lý. Việc này thu hồi access token ngay lập tức, và Koko sẽ ngừng chấp nhận các yêu cầu được gửi thay mặt bạn. Danh sách và kế hoạch của bạn vẫn nằm trong tài khoản Koko. Nếu cũng muốn xoá chúng, hãy xoá tài khoản từ phần xoá tài khoản trong FAQ.

Hỗ trợ

Mỗi tin nhắn đều có người thật đọc. Email tới [email protected] kèm nội dung bạn đã hỏi trợ lý và phản hồi bạn nhận được. Xem thêm FAQ, chính sách quyền riêng tư và điều khoản.