TokenLab MCP Server

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

• MCP thêm các công cụ API của TokenLab vào một client tương thích. Bắt đầu với thiết lập catalog không cần key bên dưới.
• TokenLab Skill cài đặt các hướng dẫn tích hợp bằng npx skills add; nó không khởi chạy một MCP server.

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 riêng của client đó.

Để agent thiết lập giúp bạnCopy Anchor Link

Sao chép nhiệm 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 một MCP client duyệt qua các mô hình và giá hiện tại, gửi yêu cầu mô hình, tạo media, làm việc với tệp và kiểm tra các tác vụ bất đồng bộ.

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 hoặc media có tính phí.

Yêu cầuCopy Anchor Link

Cài đặt Node.js 18.17 trở lên và đảm bảo npx đã sẵn sà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 (global) hoặc checkout mã nguồn.

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

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ột mô hình. full dành cho các client thực sự cần bộ công cụ mở rộng hơn.

Thêm serverCopy Anchor Link

Sao lưu cấu hình hiện tại. Chỉ thêm mục TokenLab và giữ nguyê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 một tên khác và cập nhật các lệnh tương ứng. Để 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 từ bản sao lưu trước đó.

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

Bật các công cụ có phíCopy Anchor Link

Tạo một API key trong Console → API keys, sau đó thiết lập 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 phương thức nhập dữ liệu bí mật của client nếu có. Nếu một key thực xuất hiện trong tệp 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 một key mới.

Kiểm tra kết nốiCopy Anchor Link

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 có dữ liệu trả về xác nhận rằng gói đã khởi động và kết nối thành công tới TokenLab. Profile catalog không yêu cầu API key.

Các công cụ hữu íchCopy Anchor Link

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à xem khả năng của một mô hình
• xem giá TokenLab hiện tại hoặc so sánh nhiều mô hình
• gửi các yêu cầu Chat Completions, Responses, Anthropic Messages hoặc Gemini
• đánh giá các quyết định có kiểu (typed decisions) bằng evaluate_decisions
• tạo hoặc chỉnh sửa hình ảnh
• tạo video, âm nhạc, 3D, giọng nói, chuyển ngữ (transcription) hoặc dịch thuật
• tải lên và lấy tệp
• 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 lệnh gọi có tính phí nếu giá hoặc lựa chọn mô hình chưa được xác nhận trước đó.

Mô hình quyết địnhCopy Anchor Link

Sử dụng core hoặc full để gọi một mô hình quyết định System One. Đầu tiên hãy gọi list_models với {"category":"decision"} và get_model với ID mô hình đã chọn. Giữ mô hình chat chính của agent được cấu hình 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. Một câu trả lời Noul là một giá trị xác suất dạng số, không phải Boolean. Giữ lại 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 quy trình 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 lệnh gọi công cụ của client. Nếu bạn thay đổi TOKENLAB_REQUEST_TIMEOUT_MS, hãy đảm bảo thời gian chờ của client dài hơn. Hết thời gian chờ sẽ khiến kết quả không xác định; hãy kiểm tra kỹ yêu cầu trước khi gửi lại lệnh gọi có tính 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 hiện hành động.

Media bất đồng bộCopy Anchor Link

Các công cụ tạo video, âm nhạc và 3D trả về một tác vụ thay vì một tệp hoàn chỉnh. Các công cụ xử lý 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 kết quả trả về bao gồm một 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 là complete hoặc failed. Không tạo tác vụ thứ hai chỉ 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ọnCopy Anchor Link

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

Khắc phục sự cốCopy Anchor Link

Trình khám phá mô hình được lưu trữCopy Anchor Link

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://tokenlab-model-explorer.vercel.app/mcp

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

Liên kếtCopy Anchor Link

• Trang TokenLab MCP
• Kho lưu trữ GitHub
• TokenLab API skill
• Danh mục mô hình
• Bắt đầu nhanh với API

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 dạng mt-…. Profile full của MCP sử dụng TOKENLAB_MANAGEMENT_TOKEN. Dừng thăm dò đối với các tác vụ ở trạng thái kết thúc cũng như khi gặp các lỗi 401/403/404 hoặc lỗi không thể thử lại.