Acceso MCP
Conecta tu cuenta de Tovanix a cualquier cliente de IA compatible con MCP. El endpoint es https://tovanix.com/api/mcp/rpc: Streamable HTTP sin sesión que solo acepta POST.
- Autenticación: Authorization: Bearer <credencial> o el encabezado X-MCP-Key; las credenciales empiezan por mcp_live_ y se muestran una sola vez
- Permisos: todas las capacidades empiezan apagadas y se activan una por una; tools/list solo devuelve las activadas, con el nombre tovanix_ más el de la capacidad
- Las herramientas de cobro e irreversibles requieren un código totp_code y respetan los límites por llamada y por día
- Lista de IP permitidas, vencimiento y un límite predeterminado de 120 llamadas por minuto (hasta 600)
- Tres recursos (catálogo de capacidades, resumen de la cuenta, guía) y tres prompts (revisión de la cuenta, informe de gasto, vencimientos)
- Errores: 401 credencial no válida, 403 origen o estado de la cuenta no permitido, 405 no es POST, 413 solicitud demasiado grande
- Para crear una credencial hay que leer y aceptar el Acuerdo de acceso MCP; el contenido y las acciones enviados en tu nombre son tu responsabilidad
- Además de los cobros y las acciones irreversibles, los ajustes clave como la URL de notificación, las publicaciones y el acceso público a buckets también requieren un código de un solo uso; las publicaciones, los mensajes al soporte, los correos y las lecturas en vivo de Telegram que hace la IA tienen límites por cuenta, se rechazan las publicaciones y mensajes al soporte repetidos, y los mensajes al soporte llevan la etiqueta «Enviado por asistente de IA»
POST /api/mcp/rpc
Tres credenciales, cada una con su función
MCP (Model Context Protocol) permite que clientes de IA como Claude usen las capacidades de tu cuenta de Tovanix como «herramientas». En la consola creas una credencial MCP para cada cliente y activas, una por una, las capacidades que puede usar; el cliente se conecta al endpoint con esa credencial y puede consultar datos y hacer gestiones dentro de una conversación.
MCP tiene su propio endpoint y sus propias credenciales, independientes de la API abierta y del inicio de sesión en la consola: eliminar una credencial MCP nunca afecta a las integraciones de API abierta que ya tienes en marcha, y viceversa.
- API abierta /api/v1/* — Clave de API (X-API-Key / firma) — Programas que escribes tú — Lo que tenga configurado la clave
- MCP /api/mcp/rpc — Credencial MCP (Bearer) — Clientes de IA — Ninguno; se activan una por una
- Consola — Sesión iniciada — Tú — Todo lo de tu cuenta
Inicio rápido
Cualquier cliente MCP compatible con Streamable HTTP que permita definir encabezados de solicitud puede conectarse. Elige tu herramienta abajo y copia el comando o la configuración correspondiente.
También puedes comprobar una credencial llamando a tools/list con curl: el servidor no mantiene sesión, así que no hace falta enviar initialize antes.
Solo se guarda un hash de la credencial, por lo que no se puede recuperar: si la pierdes, elimínala y crea otra. Guárdala en la configuración de tu cliente y nunca la pongas en un repositorio público, una captura de pantalla o un chat.
Endpoint y autenticación
La página «Acceso MCP» de la consola muestra el endpoint de tu cuenta, listo para copiar.
- Endpoint — Todas las solicitudes van a esta única URL.
- Transporte — Streamable HTTP sin sesión: cada solicitud se autentica por separado, solo se acepta POST y no se emite Mcp-Session-Id; GET y DELETE devuelven 405.
- Autenticación — Authorization: Bearer <credencial>. Si tu cliente solo permite añadir encabezados personalizados y no cambiar Authorization, usa X-MCP-Key: <credencial>.
- Versiones del protocolo — 2025-06-18 (la más reciente), 2025-03-26 y 2024-11-05, negociadas según la versión que el cliente envía en initialize; las versiones no compatibles usan la más reciente.
- Mensajes — JSON-RPC 2.0, con un límite de 1 MB por cuerpo de solicitud. Las solicitudes por lotes de clientes antiguos admiten como máximo 32 elementos.
- Solicitudes desde el navegador — Se rechazan las solicitudes con un encabezado Origin de sitios que no sean de la plataforma (protección contra DNS rebinding). Los clientes de escritorio y de línea de comandos no envían Origin y no se ven afectados.
Credenciales y permisos
Las credenciales empiezan por mcp_live_ y tienen 73 caracteres. Cada credencial tiene sus propios ajustes, que puedes cambiar en la consola en cualquier momento; una credencial vencida o desactivada deja de funcionar de inmediato.
Antes de crear una credencial debes leer y aceptar el Acuerdo de acceso MCP, que explica los riesgos de que una IA opere tu cuenta y quién los asume: las operaciones y pérdidas que ocurran a través de MCP son tu responsabilidad. Mientras no haya un acuerdo publicado no se pueden crear credenciales; tras una actualización, las credenciales nuevas requieren aceptarlo de nuevo y las existentes siguen funcionando.
Mientras una cuenta está restringida, MCP solo permite capacidades de consulta; la escritura, los cobros y las acciones irreversibles se rechazan con un mensaje que dirige al usuario a la consola. Si la cuenta está congelada, todas las solicitudes devuelven 403.
Herramientas y nombres
Nombre de la herramienta = tovanix_ + nombre de la capacidad, con los puntos reemplazados por guiones bajos. Por ejemplo, la capacidad account.balance.get es la herramienta tovanix_account_balance_get.
tools/list solo devuelve las capacidades activadas en esta credencial. La descripción de cada herramienta explica cuándo usarla, qué significan sus parámetros y qué tener en cuenta; así eligen los clientes de IA entre herramientas.
Consulta: solo lectura. Escritura: cambios reversibles, como editar una nota. Cobro: descuenta dinero de tu saldo. Irreversible: no se puede deshacer, como eliminar una clave o cancelar una tarjeta. Las herramientas de cobro e irreversibles requieren un código de un solo uso (siguiente sección). Algunos cambios reversibles que debes aprobar en el momento —cambiar una URL de notificación, publicar, hacer público un bucket— también requieren un código de un solo uso; en la consola aparecen con la etiqueta «Requiere código».
Códigos de un solo uso
Las herramientas de cobro e irreversibles tienen un parámetro adicional totp_code, que debe ser el código actual de 6 dígitos de tu app de autenticación. La IA no puede obtener ese código y te lo pedirá cuando haga falta. Lo mismo aplica a las herramientas con la etiqueta «Requiere código».
- Cada código sirve una sola vez. Un código que acabas de usar en la consola tampoco se puede reutilizar por MCP.
- Si la cuenta no tiene activada la verificación en dos pasos, estas herramientas siempre se rechazan, con un aviso para activarla en la consola.
- El código se verifica antes que todo lo demás, así que un código incorrecto nunca consume el cupo diario de gasto.
Límites de gasto
Cada llamada con cobro pasa por estos cuatro pasos en orden; si alguno falla, no se cobra nada.
confirmed_total_usd
La mayoría de las herramientas con cobro requieren confirmed_total_usd: el total que la IA te cotizó y que aceptaste. Si el precio real al ejecutar es mayor, no se ejecuta nada y la IA te informa el nuevo precio.
Qué pasa con el cupo si algo falla
Si una llamada falla y es seguro que no se cobró nada, el cupo reservado se devuelve. Si no se puede confirmar el resultado del cobro, el cupo sigue reservado para que un cargo que pudo haber ocurrido nunca desaparezca del conteo. Tus facturas muestran lo que realmente se cobró.
Límites de frecuencia y contenido enviado en tu nombre
Además del límite propio de cada credencial, las herramientas que escriben contenido por ti o consultan Telegram en vivo tienen límites por cuenta: los comparten todas las credenciales de la cuenta y se reinician cada día a las 00:00 UTC+8. Las llamadas que superan el límite se rechazan y se le indica a la IA que se detenga; las publicaciones y los mensajes al soporte con exactamente el mismo contenido en menos de 10 minutos también se rechazan; los correos se protegen contra duplicados con su idempotency_key, no por su contenido. En la consola estas herramientas llevan la etiqueta «Con límite».
Contenido enviado en tu nombre
Cuando activas las herramientas correspondientes, la IA puede publicar y responder en la comunidad, escribir al soporte y enviar correos con tu cuenta SMTP en tu nombre. Ese contenido te representa y eres responsable de él:
Recursos y prompts
Además de las herramientas, el servidor ofrece tres recursos de solo lectura y tres prompts que los clientes pueden usar directamente.
- tovanix://catalog — Catálogo de capacidades: todas las áreas y capacidades, y cuáles tiene activadas esta credencial. La IA lo lee cuando recibe «sin autorización» o le preguntan qué puede hacer.
- tovanix://account/overview — Resumen de la cuenta: estado de la cuenta, servicios en uso, y permisos y cupo diario usado de esta credencial. El saldo solo se muestra si está activada «Consultar saldo de la cuenta».
- tovanix://guide — Guía de la plataforma: cómo se expresan montos y monedas, estados de los pedidos y qué confirmar antes de hacer un pedido.
- account_health — — — Revisión de la cuenta: saldo, suscripciones y vencimientos por servicio, pedidos anómalos y una lista de pendientes.
- spend_report — days, predeterminado 30 — Informe de gasto: facturas y gasto recientes sumados por servicio.
- renewal_check — within_days, predeterminado 14 — Revisión de vencimientos: servicios por vencer y su costo de renovación; no renueva nada automáticamente.
Errores y solución de problemas
Los problemas de conexión y autenticación se devuelven como códigos de estado HTTP. Los fallos de negocio vuelven como resultados de herramienta (isError: true) cuyo texto le indica a la IA qué hacer después, por ejemplo «pide al usuario un código de un solo uso» o «saldo insuficiente: pide al usuario que recargue primero».
Conectar Tovanix MCP desde cada herramienta de IA
Sustituye <YOUR_MCP_CREDENTIAL> por la credencial MCP que creaste en la consola.
- Claude Code — Ejecutar en una terminal
claude mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" - Codex — Archivo de configuración:
~/.codex/config.toml[mcp_servers.tovanix] url = "https://tovanix.com/api/mcp/rpc" bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL" - Cursor — Archivo de configuración:
~/.cursor/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - GitHub Copilot (VS Code) — Archivo de configuración:
.vscode/mcp.json{ "servers": { "tovanix": { "type": "http", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer ${input:tovanix-credential}" } } }, "inputs": [ { "type": "promptString", "id": "tovanix-credential", "description": "Tovanix MCP credential", "password": true } ] } - Gemini CLI — Archivo de configuración:
~/.gemini/settings.json{ "mcpServers": { "tovanix": { "httpUrl": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - OpenCode — Archivo de configuración:
~/.config/opencode/opencode.json{ "$schema": "https://opencode.ai/config.json", "mcp": { "tovanix": { "type": "remote", "url": "https://tovanix.com/api/mcp/rpc", "enabled": true, "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Qwen Code — Ejecutar en una terminal
qwen mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" - Kimi Code CLI — Archivo de configuración:
~/.kimi-code/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - CodeBuddy Code — Ejecutar en una terminal
codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc - Qoder CLI — Archivo de configuración:
~/.qoder/settings.json{ "mcpServers": { "tovanix": { "type": "streamable-http", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Kiro — Archivo de configuración:
~/.kiro/settings/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Trae — Archivo de configuración:
.trae/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Trae CN — Archivo de configuración:
.trae/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Trae CLI — Archivo de configuración:
trae_cli.yamlmcp_servers: - name: "tovanix" url: "https://tovanix.com/api/mcp/rpc" type: "http" headers: Authorization: "Bearer <YOUR_MCP_CREDENTIAL>" - GitHub Copilot CLI — Archivo de configuración:
~/.copilot/mcp-config.json{ "mcpServers": { "tovanix": { "type": "http", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" }, "tools": [ "*" ] } } } - Cline — Archivo de configuración:
cline_mcp_settings.json{ "mcpServers": { "tovanix": { "type": "streamableHttp", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Kilo Code — Archivo de configuración:
~/.config/kilo/kilo.jsonc{ "mcp": { "tovanix": { "type": "remote", "url": "https://tovanix.com/api/mcp/rpc", "enabled": true, "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Continue — Archivo de configuración:
~/.continue/config.yamlmcpServers: - name: tovanix type: streamable-http url: https://tovanix.com/api/mcp/rpc requestOptions: headers: Authorization: Bearer <YOUR_MCP_CREDENTIAL> - Zed — Archivo de configuración:
~/.config/zed/settings.json{ "context_servers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Junie — Archivo de configuración:
~/.junie/mcp/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Amp — Archivo de configuración:
~/.config/amp/settings.json{ "amp.mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Goose — Archivo de configuración:
~/.config/goose/config.yamlextensions: tovanix: enabled: true type: streamable_http name: tovanix uri: https://tovanix.com/api/mcp/rpc headers: Authorization: "Bearer <YOUR_MCP_CREDENTIAL>" timeout: 300 - Augment (Auggie) — Ejecutar en una terminal
auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>" - Factory Droid — Ejecutar en una terminal
droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth - Crush — Archivo de configuración:
~/.config/crush/crushrcmcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>" - Warp — Pegar en la configuración de la app
{ "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } - Windsurf — Archivo de configuración:
~/.codeium/windsurf/mcp_config.json{ "mcpServers": { "tovanix": { "serverUrl": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Claude (web / escritorio) — Introduce la dirección en la app y añade el encabezado Authorization (Bearer + credencial)
https://tovanix.com/api/mcp/rpc - LM Studio — Archivo de configuración:
mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Dify — Introduce la dirección en la app y añade el encabezado Authorization (Bearer + credencial)
https://tovanix.com/api/mcp/rpc - Coze — Introduce la dirección en la app y añade el encabezado Authorization (Bearer + credencial)
https://tovanix.com/api/mcp/rpc - n8n — Introduce la dirección en la app y añade el encabezado Authorization (Bearer + credencial)
https://tovanix.com/api/mcp/rpc - Otros clientes MCP — Pegar en la configuración de la app
{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } }
Preguntas frecuentes
¿Por qué tools/list devuelve una lista vacía?
La credencial todavía no tiene capacidades activadas. Actívalas en «Acceso MCP» en la consola y vuelve a conectar.
¿Por qué siempre se rechazan las herramientas con cobro?
Revisa tres cosas: si los límites de gasto de la credencial siguen en el valor predeterminado 0, si la verificación en dos pasos está activada y si ya se agotó el cupo diario.
Páginas relacionadas: Deja que tu asistente de IA administre tu cuenta de Tovanix · Documentación de la API · Integración para desarrolladores
Cargando…