Công cụ lập trình
Cursor
Cấu hình TokenLab cho các mô hình chat được hỗ trợ trên Cursor, xác minh kết nối và thêm MCP hoặc Skills riêng biệt
Chức năng của kết nối này
Sử dụng TokenLab cho các yêu cầu chat được hỗ trợ trong trình chỉnh sửa máy tính để bàn Cursor trên macOS, Windows hoặc Linux. Cursor hỗ trợ OpenAI BYOK cho các mô hình chat tiêu chuẩn, không suy luận (non-reasoning); tính năng tự động hoàn thành mã (Tab completion) vẫn sử dụng các mô hình của Cursor. Việc ghi đè OpenAI Base URL không biến Cursor thành ứng dụng khách cho mọi mô hình hoặc giao thức của TokenLab. Xem giới hạn API-key của Cursor.
Nếu bạn chỉ cần các công cụ API về hình ảnh, video hoặc các công cụ khác của TokenLab, hãy giữ nguyên nhà cung cấp chat hiện tại và thêm MCP thay thế. Một Skill sẽ hướng dẫn agent cách sử dụng các API; nó không thay đổi nhà cung cấp chat.
Giao nhiệm vụ này cho agent của bạn
Read https://tokenlab.sh/docs/vi/integrations/cursor and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.Mở cài đặt chính xác
- Cài đặt hoặc cập nhật trình chỉnh sửa máy tính để bàn từ Cursor Downloads. Hướng dẫn này không cấu hình Cursor CLI hoặc Cloud Agents.
- Mở Cursor Settings từ bảng lệnh (command palette), hoặc nhấn
Cmd/Ctrl + Shift + J.Cmd/Ctrl + ,sẽ mở cài đặt chung của trình chỉnh sửa. - Mở Models và ghi lại cấu hình OpenAI key và Base URL hiện tại của bạn để có thể khôi phục sau này. Giữ nguyên các cài đặt nhà cung cấp khác.
- Trong phần OpenAI API Key, hãy nhập khóa TokenLab của bạn cục bộ và lưu lại. Không dán khóa vào cuộc trò chuyện với agent hoặc commit nó vào dự án.
- Bật Override OpenAI Base URL và nhập:
https://api.tokenlab.sh/v1Cursor gửi các yêu cầu BYOK thông qua backend của nó để tổng hợp prompt; đây không phải là kết nối trực tiếp từ trình chỉnh sửa của bạn đến TokenLab.
Chọn mô hình được hỗ trợ
Sao chép chính xác ID mô hình từ danh mục TokenLab hiện tại và kiểm tra xem Cursor có chấp nhận nó thông qua đường dẫn OpenAI BYOK hay không. Một mô hình được liệt kê là chat trên TokenLab không đảm bảo tính tương thích với Cursor.
Để kiểm tra văn bản ban đầu, hãy chọn một mô hình không suy luận (non-reasoning): chi tiết của nó không liệt kê khả năng reasoning và nó chấp nhận openai_chat_completions. grok-4.20-non-reasoning là một ví dụ; hãy xác nhận nó vẫn còn trong danh sách trước khi sử dụng. Bật mục hiện có trong Models, hoặc sử dụng Add model nếu nó không có ở đó, sau đó chọn chính xác mô hình đó trong trình chọn chat. Không sao chép một mô hình tích hợp sẵn dưới một tên gọi khác, và đừng cho rằng các mục Claude hoặc Gemini sử dụng ghi đè OpenAI. Hướng dẫn về mô hình tùy chỉnh của Cursor giải thích các giới hạn định tuyến này.
Xác minh bằng một yêu cầu nhỏ
Bắt đầu một cuộc trò chuyện mới với mô hình đã chọn và gửi:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Đây là một yêu cầu mô hình có tính phí. Kiểm tra cả phản hồi và mô hình, thời gian, trạng thái khớp trong TokenLab Requests. Một khóa đã lưu, một mô hình hiển thị hoặc một phản hồi mà không có yêu cầu TokenLab tương ứng không xác nhận lộ trình này.
Nếu kết nối thất bại
- Mô hình bị thiếu hoặc bị từ chối: kiểm tra ID chính xác và hỗ trợ BYOK hiện tại của Cursor. Sử dụng mục tích hợp sẵn nếu có; việc khởi động lại không thể làm cho một mô hình không được hỗ trợ trở nên tương thích.
- Xác thực thất bại: nhập lại khóa TokenLab vào trường OpenAI và kiểm tra Base URL. Lỗi số dư hoặc hạn mức là lỗi riêng biệt với khóa không hợp lệ; hãy làm theo lỗi được trả về và yêu cầu TokenLab tương ứng.
- Không có yêu cầu TokenLab nào xuất hiện: xác nhận mô hình đã chọn và ghi đè, sau đó kiểm tra lỗi của Cursor. Tính năng tự động hoàn thành mã và các tính năng do Cursor quản lý khác không phải là bài kiểm tra kết nối.
- Nhà cung cấp khác ngừng hoạt động: khôi phục cài đặt OpenAI trước đó hoặc tắt ghi đè, sau đó bắt đầu một cuộc trò chuyện mới. Tránh thay đổi các khóa nhà cung cấp không liên quan để sửa lỗi này.
Tạo hình ảnh và video trong cùng một agent
Cursor cũng có thể tạo hình ảnh và video ngắn với TokenLab MCP server. Mỗi lần tạo được thanh toán từ cùng số dư TokenLab. MCP không thay thế mô hình chat chính. Lưu tệp này dưới dạng ~/.cursor/mcp.json, hoặc hợp nhất mục tokenlab vào tệp hiện có của bạn:
{
"mcpServers": {
"tokenlab": {
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
}
}
}
}Thay thế <TOKENLAB_API_KEY> bằng khóa của bạn trên máy tính cá nhân và không commit tệp này. Kiểm tra xem tokenlab đã được bật trong cài đặt MCP của Cursor chưa. Sau đó thử:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video trả về một ID tác vụ. Agent sẽ gọi get_task_status cho đến khi video sẵn sàng.
Thêm hướng dẫn API riêng biệt
TokenLab Skills cung cấp các hướng dẫn API. Đối với cài đặt cục bộ trong dự án, hãy giữ toàn bộ thư mục skill tại .cursor/skills/tokenlab-api-integration/, bao gồm SKILL.md và các tệp được tham chiếu. Kiểm tra Customize → Skills để khám phá. Skills không cung cấp khóa hoặc cài đặt MCP server. Xem hướng dẫn chính thức về MCP và Skills cho phiên bản Cursor của bạn.