Herramientas de código
Servidor MCP de TokenLab
Brinda a Claude Code, Cursor, VS Code, Codex y otros clientes MCP acceso a los modelos y APIs de TokenLab
Elige lo que tu agente necesita
- MCP añade herramientas de la API de TokenLab a un cliente compatible. Comienza con la configuración
catalogsin clave que se muestra a continuación. - Los TokenLab Agent Skills enseñan al agente el método para obtener un resultado, como qué modelo elegir y cómo verificar la salida. No inician un servidor MCP, y pueden utilizar estas herramientas MCP cuando ambos están instalados.
Instala el Skill de selección de modelos: npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker
Ambos extienden un agente existente. Cambiar su proveedor de modelos principal utiliza la guía de configuración propia de ese cliente.
Deja que mi agente configure esto
Copia esta tarea en un agente que ya se esté ejecutando en tu computadora:
Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/es/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.El TokenLab MCP Server permite que un cliente MCP explore los modelos y precios actuales, envíe solicitudes de modelos, cree contenido multimedia, trabaje con archivos y verifique tareas asíncronas.
Utiliza el perfil catalog para explorar modelos y precios sin necesidad de una API key. Añade TOKENLAB_API_KEY cuando el cliente deba realizar solicitudes de modelos de pago o contenido multimedia.
Mantén tu API key de TokenLab en el entorno del servidor MCP. Nunca la pegues en un prompt o en el argumento de una herramienta.
Requisitos
Instala Node.js 18.17 o una versión posterior y asegúrate de que npx esté disponible:
node --version
npx --versionEl paquete npm se ejecuta localmente a través de stdio. No necesitas una instalación global ni descargar el código fuente.
Elige lo que el cliente puede usar
| Perfil | API key | Incluye |
|---|---|---|
catalog | No requerida | Lista de modelos, detalles de modelos, precios, comparaciones y resumen de la API |
core | Requerida para llamadas de pago | Herramientas comunes de chat, decisión, multimedia, audio, archivos, tareas, embeddings, rerank y traducción |
full | Requerida para llamadas de pago | core más APIs adicionales para desarrolladores |
Comienza con catalog si solo deseas una mejor selección de modelos. Usa core cuando el cliente deba crear contenido o llamar a un modelo. full es para clientes que realmente necesitan el conjunto de herramientas más amplio.
Añade el servidor
Realiza una copia de seguridad de la configuración activa. Añade solo la entrada de TokenLab y conserva los proveedores, cuentas, selección de modelo predeterminado y permisos existentes. Si el nombre ya está en uso, elige otro nombre y actualiza los comandos. Para deshacer la configuración, elimina solo la entrada que añadiste o restaura su copia de seguridad anterior.
Añade el catálogo público para tu cuenta de usuario:
claude mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=catalog \
--scope user \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48Para usar herramientas de pago, reemplaza la variable de entorno del perfil con TOKENLAB_API_KEY y almacena la clave a través de tu método habitual de gestión de secretos. Usa --scope local para un solo proyecto. Nunca subas una clave real a un archivo .mcp.json compartido.
Habilitar herramientas de pago
Crea una API key en Console → API keys, luego establece ambas variables en el entorno del servidor MCP:
{
"env": {
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
"TOKENLAB_MCP_TOOL_PROFILE": "core"
}
}Usa el método de entrada de secretos de tu cliente si tiene uno. Si una clave real aparece en un archivo compartido, captura de pantalla, registro o historial de shell, revócala y crea una nueva.
Verificar la conexión
Reinicia o recarga el cliente MCP, aprueba el servidor local si se te solicita y confirma que tokenlab está conectado.
# Claude Code
claude mcp list
# Codex
codex mcp listPide al cliente que llame a list_models. Una lista no vacía confirma que el paquete se inició y llegó a TokenLab. El perfil catalog no necesita una API key.
Herramientas útiles
La disponibilidad de las herramientas depende del perfil seleccionado. Las tareas comunes incluyen:
- listar modelos y leer las capacidades de un modelo
- leer los precios actuales de TokenLab o comparar varios modelos
- enviar Chat Completions, Responses, Anthropic Messages o solicitudes de Gemini
- evaluar decisiones tipadas con
evaluate_decisions - crear o editar imágenes
- crear video, música, 3D, voz, transcripción o traducción
- cargar y recuperar archivos
- crear embeddings o reordenar (rerank) documentos
- verificar y cancelar tareas asíncronas compatibles
El cliente debe solicitar aprobación antes de una llamada de pago cuando el precio o la elección del modelo no se hayan confirmado previamente.
Las herramientas de archivos MCP utilizan la API /v1/files compatible con OpenAI. Gemini Files, las cargas reanudables y cachedContents actualmente requieren llamadas HTTP y no están incluidas en los perfiles MCP. Consulta Gemini Files and cache.
Modelos de decisión
Usa core o full para llamar a un System One decision model. Primero llama a list_models con {"category":"decision"} y get_model con el ID del modelo seleccionado. Mantén el modelo de chat principal del agente configurado por separado.
Para Jev 1.13, llama a la herramienta con state y questions nativos:
{
"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?"
}
}
}
}Verifica isError, luego lee structuredContent.answers y structuredContent.usage. Una respuesta Noul es un número de probabilidad, no un booleano. Conserva el ID de solicitud de _meta cuando esté disponible. La herramienta devuelve un resultado síncrono; no utiliza el flujo de sondeo de tareas asíncronas.
Con el tiempo de espera de solicitud del servidor predeterminado de 120,000 ms, permite al menos 150,000 ms para la llamada de la herramienta del cliente. Si cambias TOKENLAB_REQUEST_TIMEOUT_MS, mantén el tiempo de espera del cliente más largo. Un tiempo de espera deja el resultado incierto; inspecciona la solicitud antes de volver a enviar una llamada de pago. Valida las decisiones contra tus propios casos etiquetados antes de usarlas para impulsar acciones.
Contenido multimedia asíncrono
Las herramientas de video, música y 3D devuelven una tarea en lugar de un archivo terminado. Las herramientas de imagen pueden devolver un resultado completado o una tarea, dependiendo del modelo.
Cuando un resultado incluye una delivery asíncrona, llama a get_task_status con su ID de tarea hasta que el estado sea completado o fallido. No crees una segunda tarea porque una verificación de estado haya excedido el tiempo de espera.
Configuración opcional
| Variable | Predeterminado | Uso |
|---|---|---|
TOKENLAB_API_BASE | https://api.tokenlab.sh | Host de la API de TokenLab personalizada; omite la barra diagonal final |
TOKENLAB_MCP_TOOL_PROFILE | core | catalog, core o full |
TOKENLAB_REQUEST_TIMEOUT_MS | 120000 | Tiempo de espera de solicitud en milisegundos |
TOKENLAB_MCP_MAX_FILE_BYTES | 104857600 | Tamaño máximo de carga local por archivo |
TOKENLAB_ARTIFACT_DIR | Directorio temporal del SO | Dónde se guardan los archivos grandes descargados |
Usa los valores predeterminados a menos que tu cliente o despliegue tenga un requisito específico.
Solución de problemas
Explorador de modelos alojado
Los clientes que admiten HTTP Streamable pueden usar el explorador de modelos público en:
https://mcp.tokenlab.sh/mcpUsa el servidor npm local para llamadas a la API de pago, cargas de archivos locales o los perfiles core y full.
Enlaces
- Página de TokenLab MCP
- Generar imágenes y video desde Claude Code o OpenClaw
- Repositorio de GitHub
- TokenLab Agent Skills
- Catálogo de modelos
- Inicio rápido de la API
Configura las notificaciones de tareas con la API de gestión de Webhooks, autenticada con un Management Token mt-…. El perfil full de MCP utiliza TOKENLAB_MANAGEMENT_TOKEN. Detén el sondeo de tareas terminales ante errores 401/403/404 o errores que no se puedan reintentar.