TokenLab

Công cụ lập trình

TokenLab MCP Server

Cung cấp cho Claude Code, Cursor, VS Code, Codex và các MCP client khác quyền truy cập vào các mô hình và API của TokenLab

Chọn những gì agent của bạn cần

  • MCP thêm các công cụ API của TokenLab vào một client tương thích. Hãy bắt đầu với thiết lập catalog không cần khóa (key-free) bên dưới.
  • TokenLab Agent Skills hướng dẫn agent phương thức để đạt được kết quả, chẳng hạn như chọn mô hình nào và cách kiểm tra đầu ra. Chúng không khởi chạy MCP server và có thể sử dụng các công cụ MCP này khi cả hai đều được cài đặt.

Cài đặt skill chọn mô hình (model picker): npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker

tokenlab-skills trên GitHub.

Cả hai đều mở rộng một agent hiện có. Việc thay đổi nhà cung cấp mô hình chính của nó sẽ sử dụng hướng dẫn thiết lập của chính client đó.

Để agent của tôi thiết lập việc này

Sao chép tác vụ này vào một agent đang chạy trên máy tính của bạn:

Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/vi/integrations/tokenlab-mcp-server
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

TokenLab MCP Server cho phép MCP client duyệt các mô hình và giá hiện tại, gửi yêu cầu mô hình, tạo phương tiện (media), làm việc với tệp tin và kiểm tra các tác vụ bất đồng bộ (async).

Sử dụng profile catalog để duyệt các mô hình và giá mà không cần API key. Thêm TOKENLAB_API_KEY khi client cần thực hiện các yêu cầu mô hình trả phí hoặc yêu cầu phương tiện.

Giữ API key TokenLab của bạn trong môi trường MCP server. Không bao giờ dán nó vào prompt hoặc đối số của công cụ.

Yêu cầu

Cài đặt Node.js 18.17 trở lên và đảm bảo npx khả dụng:

node --version
npx --version

Gói npm chạy cục bộ qua stdio. Bạn không cần cài đặt toàn cục hoặc tải mã nguồn về.

Chọn những gì client có thể sử dụng

ProfileAPI keyBao gồm
catalogKhông bắt buộcDanh sách mô hình, chi tiết mô hình, giá cả, so sánh và tổng quan API
coreBắt buộc cho các cuộc gọi trả phíCác công cụ trò chuyện, quyết định, phương tiện, âm thanh, tệp tin, tác vụ, embedding, rerank và dịch thuật thông thường
fullBắt buộc cho các cuộc gọi trả phícore cộng với các API dành cho nhà phát triển bổ sung

Hãy bắt đầu với catalog nếu bạn chỉ muốn lựa chọn mô hình tốt hơn. Sử dụng core khi client cần tạo nội dung hoặc gọi mô hình. full dành cho các client thực sự cần bộ công cụ lớn hơn.

Thêm server

Sao lưu cấu hình hiện tại. Chỉ thêm mục TokenLab và bảo toàn các nhà cung cấp, tài khoản, lựa chọn mô hình mặc định và quyền hiện có. Nếu tên đã được sử dụng, hãy chọn tên khác và cập nhật các lệnh. Để hoàn tác thiết lập, chỉ cần xóa mục bạn đã thêm hoặc khôi phục bản sao lưu trước đó.

Thêm catalog công khai cho tài khoản người dùng của bạn:

claude mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=catalog \
  --scope user \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

Để sử dụng các công cụ trả phí, hãy thay thế biến môi trường profile bằng TOKENLAB_API_KEY và lưu trữ khóa thông qua phương thức quản lý bí mật thông thường của bạn. Sử dụng --scope local cho một dự án. Không bao giờ commit khóa thực vào tệp .mcp.json được chia sẻ.

Kích hoạt các công cụ trả phí

Tạo API key trong Console → API keys, sau đó đặt cả hai biến trong môi trường MCP server:

{
  "env": {
    "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
    "TOKENLAB_MCP_TOOL_PROFILE": "core"
  }
}

Sử dụng tính năng nhập bí mật của client nếu có. Nếu khóa thực xuất hiện trong tệp được chia sẻ, ảnh chụp màn hình, nhật ký hoặc lịch sử shell, hãy thu hồi nó và tạo khóa mới.

Kiểm tra kết nối

Khởi động lại hoặc tải lại MCP client, phê duyệt server cục bộ nếu được nhắc và xác nhận rằng tokenlab đã được kết nối.

# Claude Code
claude mcp list

# Codex
codex mcp list

Yêu cầu client gọi list_models. Một danh sách không trống xác nhận gói đã khởi động và kết nối được với TokenLab. Profile catalog không cần API key.

Các công cụ hữu ích

Tính khả dụng của công cụ phụ thuộc vào profile đã chọn. Các tác vụ phổ biến bao gồm:

  • liệt kê các mô hình và đọc khả năng của một mô hình
  • đọc giá TokenLab hiện tại hoặc so sánh một số mô hình
  • gửi Chat Completions, Responses, Anthropic Messages hoặc các yêu cầu Gemini
  • đánh giá các quyết định có kiểu dữ liệu với evaluate_decisions
  • tạo hoặc chỉnh sửa hình ảnh
  • tạo video, âm nhạc, 3D, giọng nói, phiên âm hoặc dịch thuật
  • tải lên và truy xuất tệp tin
  • tạo embeddings hoặc rerank tài liệu
  • kiểm tra và hủy các tác vụ bất đồng bộ được hỗ trợ

Client nên yêu cầu phê duyệt trước khi thực hiện cuộc gọi trả phí khi giá hoặc lựa chọn mô hình chưa được xác nhận.

Các công cụ tệp tin MCP sử dụng API /v1/files tương thích với OpenAI. Gemini Files, tải lên có thể tiếp tục (resumable uploads) và cachedContents hiện yêu cầu các cuộc gọi HTTP và không được bao gồm trong các profile MCP. Xem Gemini Files and cache.

Các mô hình quyết định

Sử dụng core hoặc full để gọi System One decision model. Trước tiên, hãy gọi list_models với {"category":"decision"} và get_model với ID mô hình đã chọn. Giữ cấu hình mô hình trò chuyện chính của agent riêng biệt.

Đối với Jev 1.13, hãy gọi công cụ với state và questions gốc:

{
  "name": "evaluate_decisions",
  "arguments": {
    "model": "jev-1.13",
    "state": { "ticket": "Please refund the duplicate payment." },
    "questions": {
      "refund_requested": {
        "type": "noul",
        "instructions": "Does the customer explicitly request a refund?"
      }
    }
  }
}

Kiểm tra isError, sau đó đọc structuredContent.answers và structuredContent.usage. Câu trả lời Noul là một số xác suất, không phải Boolean. Bảo toàn ID yêu cầu từ _meta khi có sẵn. Công cụ trả về kết quả đồng bộ; nó không sử dụng luồng thăm dò tác vụ bất đồng bộ.

Với thời gian chờ yêu cầu server mặc định là 120.000 ms, hãy cho phép ít nhất 150.000 ms cho cuộc gọi công cụ của client. Nếu bạn thay đổi TOKENLAB_REQUEST_TIMEOUT_MS, hãy giữ thời gian chờ của client lâu hơn. Thời gian chờ khiến kết quả không chắc chắn; hãy kiểm tra yêu cầu trước khi gửi lại cuộc gọi trả phí. Xác thực các quyết định dựa trên các trường hợp được gắn nhãn của riêng bạn trước khi sử dụng chúng để thúc đẩy hành động.

Phương tiện bất đồng bộ (Async media)

Các công cụ video, âm nhạc và 3D trả về một tác vụ thay vì tệp hoàn chỉnh. Các công cụ hình ảnh có thể trả về kết quả đã hoàn thành hoặc một tác vụ, tùy thuộc vào mô hình.

Khi một kết quả bao gồm delivery bất đồng bộ, hãy gọi get_task_status với ID tác vụ của nó cho đến khi trạng thái hoàn tất hoặc thất bại. Không tạo tác vụ thứ hai vì một lần kiểm tra trạng thái bị hết thời gian chờ.

Cài đặt tùy chọn

BiếnMặc địnhSử dụng
TOKENLAB_API_BASEhttps://api.tokenlab.shHost API TokenLab tùy chỉnh; bỏ dấu gạch chéo ở cuối
TOKENLAB_MCP_TOOL_PROFILEcorecatalog, core hoặc full
TOKENLAB_REQUEST_TIMEOUT_MS120000Thời gian chờ yêu cầu tính bằng mili giây
TOKENLAB_MCP_MAX_FILE_BYTES104857600Kích thước tải lên cục bộ tối đa cho mỗi tệp
TOKENLAB_ARTIFACT_DIRThư mục tạm của hệ điều hànhNơi lưu các tệp lớn đã tải xuống

Sử dụng các giá trị mặc định trừ khi client hoặc quá trình triển khai của bạn có yêu cầu cụ thể.

Khắc phục sự cố

Trình khám phá mô hình được lưu trữ (Hosted model explorer)

Các client hỗ trợ Streamable HTTP có thể sử dụng trình khám phá mô hình công khai tại:

https://mcp.tokenlab.sh/mcp

Sử dụng server npm cục bộ cho các cuộc gọi API trả phí, tải tệp lên cục bộ hoặc các profile core và full.

Liên kết

Cấu hình thông báo tác vụ với API quản lý Webhook, được xác thực bằng Management Token mt-…. MCP full sử dụng TOKENLAB_MANAGEMENT_TOKEN. Dừng thăm dò các tác vụ terminal khi gặp lỗi 401/403/404 hoặc các lỗi không thể thử lại.

Trên trang này