Compartir y abrir archivos con Tunc Art
Cada archivo tiene un enlace privado corto como tuncart.com/Q7m4Kp. El enlace es una dirección, no una llave.
¿Quieres configuraciones que ya funcionan? Los ejemplos tienen prompts que pegas en tu agente.
Abrir un archivo
- Inicia sesión con tu cuenta de Tunc. Puedes abrir los archivos de los que eres titular y los que se compartieron contigo a través de un espacio de trabajo.
- Las imágenes, los videos, los audios, los PDF y las páginas web (aisladas, así que los scripts nunca se ejecutan) se abren en la página; el Markdown se abre como un documento con formato, y los archivos de código y JSON se muestran con colores (igual en art.tunchub.com), mientras que el resto del texto y los CSV se muestran como texto simple. Los archivos de Word, Excel, PowerPoint, los archivos comprimidos y los demás muestran su nombre, tipo y tamaño con un botón Descargar. Las páginas web se abren en un entorno aislado sin acceso a tu cuenta; los PDF usan el visor de tu navegador.
- Descargar siempre devuelve los bytes originales.
Compartir con contraseña
El titular puede activar una contraseña para compartir desde la página del archivo y enviarla por separado. Cualquier persona con el enlace y la contraseña puede abrir el archivo durante 30 minutos cada vez. Al desactivar el uso compartido, se cierran de inmediato todas las sesiones desbloqueadas. Una contraseña funciona como máximo 7 días o hasta que el archivo vence; vuelve a establecerla para extenderla. Solo el titular puede activar el uso compartido: un asistente no puede hacerlo. Compartir con contraseña nunca cambia lo que pueden hacer los agentes del titular.
Los agentes y la Art API
Los agentes inician sesión con Tunc desde claude.ai, ChatGPT y otros clientes MCP, se conectan con un código cuando no tienen navegador, o usan una clave de API. En Tunc Hub, Art viene integrado; lee cómo funciona.
Iniciar sesión con Tunc
Los clientes MCP que inician sesión se conectan a https://mcp.tuncart.com/mcp con tu cuenta de Tunc: no hay que copiar ninguna clave. (El otro producto está en https://mcp.tuncorb.com/mcp.) Tu cliente abre Tunc; inicias sesión, o creas una cuenta gratuita con tu organización y aceptas los Términos, luego lo autorizas una vez y eliges lo que puede hacer.
| Cliente | Pasos |
|---|---|
| claude.ai, Claude Desktop and Claude mobile | Customize → Connectors → Add custom connector → nombre Tunc Art, URL https://mcp.tuncart.com/mcp → Add → Connect. El plan Free permite un conector personalizado; en Team y Enterprise, un Owner lo agrega en Organization settings → Connectors. Este enlace abre el diálogo con el nombre y la URL ya completados: |
| Claude Code | Agrega el servidor, luego ejecuta /mcp, elige tunc-art y Authenticate. |
| ChatGPT | Settings → Apps & Connectors → Advanced → activa Developer mode → Create → nombre Tunc Art, URL https://mcp.tuncart.com/mcp, Authentication OAuth → Create → Connect. |
| Cursor | Agrégalo a ~/.cursor/mcp.json y luego ve a Settings → MCP: muestra “Needs login” → Login. |
| VS Code (Copilot) | Command Palette → MCP: Add Server → HTTP → https://mcp.tuncart.com/mcp → nombre tunc-art → permite la solicitud de inicio de sesión. |
| Gemini CLI | Agrégalo a settings.json y luego ejecuta /mcp auth tunc-art. |
| Copilot Studio | Tools → Add a tool → New tool → Model Context Protocol → en URL escribe https://mcp.tuncart.com/mcp → en Authentication elige OAuth 2.0, Dynamic discovery. |
Un cliente que solo acepta un encabezado usa en su lugar una clave de API.
Agentes sin navegador
Un agente en un servidor o en una terminal te muestra un código y un enlace como https://tuncart.com/connect?code=BCDF-GHJK. Ábrelo, inicia sesión, comprueba que el código coincida y autorízalo. Cualquier biblioteca de OAuth que admita el device grant (RFC 8628) puede hacerlo:
# Una vez por agente: regístralo (no necesita redirección)
curl -s https://core.tunc.ai/oauth/register -H 'content-type: application/json' \
-d '{"client_name":"report-writer","grant_types":["urn:ietf:params:oauth:grant-type:device_code","refresh_token"]}'
# → {"client_id":"dcr_…",…}
# Pide un código y muéstrale a la persona verification_uri_complete
curl -s https://core.tunc.ai/oauth/device_authorization -d client_id=dcr_… -d scope="orb.read art.read art.write" -d resource=https://mcp.tuncart.com/mcp
# → {"device_code":"…","user_code":"BCDF-GHJK",
# "verification_uri_complete":"https://tuncart.com/connect?code=BCDF-GHJK","interval":5,"expires_in":600}
# Consulta cada interval segundos hasta que lo autorice
curl -s https://core.tunc.ai/oauth/token -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
-d device_code=… -d client_id=dcr_…
# → {"error":"authorization_pending"} hasta entonces; una vez autorizado:
# → {"access_token":"…","expires_in":900,"refresh_token":"…","scope":"…"}
# Antes de que venza el token de acceso, cambia el token de actualización por otros nuevos
curl -s https://core.tunc.ai/oauth/token -d grant_type=refresh_token -d refresh_token=… -d client_id=dcr_…Envía el token de acceso como Authorization: Bearer a https://mcp.tuncart.com/mcp. Cada renovación devuelve un nuevo token de actualización: conserva solo el más reciente, porque volver a enviar uno ya usado desconecta al agente.
A2A
Los agentes que hablan A2A 1.0 encuentran Tunc Art en https://tuncart.com/.well-known/agent-card.json e invocan https://a2a.tuncart.com. Cada mensaje lleva una parte de datos con un skill (el nombre de una herramienta MCP, como art_read) y sus arguments; la respuesta es el resultado de la herramienta. Usa una clave de API, o inicia sesión con el recurso https://a2a.tuncart.com.
curl -s https://a2a.tuncart.com -H "Authorization: Bearer $TUNC_API_KEY" -H 'A2A-Version: 1.0' \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{
"messageId":"m-1","role":"ROLE_USER",
"parts":[{"data":{"skill":"art_read","arguments":{"operation":"list"}},"mediaType":"application/json"}]}}}'
# → {"jsonrpc":"2.0","id":1,"result":{"message":{"role":"ROLE_AGENT",
# "parts":[{"data":{…el resultado de la herramienta…},"mediaType":"application/json"}],…}}}Cambiar el nombre, cambiar el acceso o desconectar
Cada agente y cada clave aparecen en tunchub.com → Agents & keys, con la forma en que se conectó y lo que puede hacer. Cámbiale el nombre, usa Change access para quitarle acceso (el agente te pedirá más si lo necesita) o desconéctalo con Disconnect: deja de funcionar en menos de un minuto. Todos tus agentes comparten tu estante Personal.
Qué hacen las herramientas
- art_write: guarda un archivo de cualquier tipo, de hasta 250 MiB. Los archivos pequeños van en línea (
textocontent_base64, de hasta 8 MiB); los más grandes usanmode: "begin"para obtener una URL de carga, un PUT de los bytes y luegomode: "complete". El resultado incluye elartifact_iddel archivo y su enlace privado. Los archivos nunca se sobrescriben: una nueva versión es un archivo nuevo. - art_read:
listencuentra archivos, los más recientes primero, y aceptatitle,mime_prefix,kind(image, pdf, workbook, presentation, document y otros),created_after,created_beforeysort(newest, oldest, name o largest).getconinclude_contentdevuelve lo que hay dentro: el texto como texto; un PNG, JPEG, GIF o WebP como imagen; un PDF como imágenes de sus páginas, de cuatro en cuatro (pageselige cuáles); los archivos de Word, PowerPoint, OpenDocument, iWork y correo electrónico como texto; una hoja de cálculo como texto porsheetyrange; un archivo comprimido como una lista de miembros para leerlos uno por uno conpart; una foto grande como una imagen reducida. Cualquier otra cosa, de hasta 8 MiB, vuelve comocontent_base64, yoffsetylengthleen parte de un archivo de cualquier tamaño. - art_delete: elimina un archivo que subiste. Su enlace deja de funcionar de inmediato, se desactiva cualquier contraseña para compartir y no se puede deshacer.
Usar una clave de API
Crea una clave de API en tunchub.com con tu cuenta de Tunc. Elige lo que puede hacer: leer Tunc Orb (todas las claves), guardar y eliminar en Tunc Orb, y abrir, subir y eliminar archivos de Tunc Art. La clave se muestra una sola vez; guárdala en el almacén de secretos de tu sistema, nunca en un prompt. Desconéctala cuando quieras desde Agents & keys, y deja de funcionar en menos de un minuto.
Una misma clave funciona en ambas API: https://api.tuncorb.com para Tunc Orb y https://api.tuncart.com para Tunc Art. Envíala como Authorization: Bearer <key>.
Conecta un cliente MCP
Las herramientas de Tunc Orb están en https://mcp.tuncorb.com/mcp y las de Tunc Art en https://mcp.tuncart.com/mcp. Agrega la que necesites con tu clave en el encabezado Authorization (reemplaza $TUNC_API_KEY):
Claude Code
claude mcp add --transport http tunc-art https://mcp.tuncart.com/mcp --header "Authorization: Bearer $TUNC_API_KEY"Cursor (mcp.json)
{
"mcpServers": {
"tunc-art": {
"url": "https://mcp.tuncart.com/mcp",
"headers": {
"Authorization": "Bearer $TUNC_API_KEY"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"tunc-art": {
"type": "http",
"url": "https://mcp.tuncart.com/mcp",
"headers": {
"Authorization": "Bearer $TUNC_API_KEY"
}
}
}
}Gemini CLI (settings.json)
{
"mcpServers": {
"tunc-art": {
"httpUrl": "https://mcp.tuncart.com/mcp",
"headers": {
"Authorization": "Bearer $TUNC_API_KEY"
}
}
}
}OpenAI Responses API (tools)
{
"type": "mcp",
"server_label": "tunc-art",
"server_url": "https://mcp.tuncart.com/mcp",
"authorization": "$TUNC_API_KEY"
}Una clave sin el acceso que necesita una herramienta recibe un error de herramienta que lo nombra en missing_scope; una clave desconectada recibe 401.
Llama a la API directamente
# Files you can open (paged)
curl -s "https://api.tuncart.com/v1/files?limit=20" -H "Authorization: Bearer $TUNC_API_KEY"
# Upload: start, send the bytes to upload.url, then complete
curl -s https://api.tuncart.com/v1/files \
-H "Authorization: Bearer $TUNC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"display_name":"q4-report.pdf","mime_type":"application/pdf","byte_count":482113}'
# → {"artifact":{"id":"…",…},"upload":{"method":"PUT","url":"…","headers":{…},…}}
curl -s https://api.tuncart.com/v1/files/<id>/complete \
-H "Authorization: Bearer $TUNC_API_KEY" \
-H "Content-Type: application/json" -d '{"byte_count":482113}'
# Download, and delete a file your key uploaded
curl -s https://api.tuncart.com/v1/files/<id>/content -H "Authorization: Bearer $TUNC_API_KEY" -o q4-report.pdf
curl -s -X DELETE https://api.tuncart.com/v1/files/<id> -H "Authorization: Bearer $TUNC_API_KEY"curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation":"create","name":"hello","about":"first record",
"text":"Hello from my agent","mutation_id":"mut_'"$(openssl rand -hex 13)"'"}'
curl -s https://api.tuncorb.com/v1/read \
-H "Authorization: Bearer $TUNC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation":"get","name":"hello"}'import os
import secrets
import requests
headers = {"Authorization": f"Bearer {os.environ['TUNC_API_KEY']}"}
# Tunc Orb: guardar un registro (un mutation_id por cambio; reutilízalo en los reintentos)
saved = requests.post("https://api.tuncorb.com/v1/write", headers=headers, json={
"operation": "create", "name": "hello", "about": "primer registro",
"text": "Hola desde mi agente", "mutation_id": "mut_" + secrets.token_hex(13),
})
print(saved.json())
# Tunc Art: listar tus archivos
print(requests.get("https://api.tuncart.com/v1/files", headers=headers).json())Límites
- Uso razonable: 50,000 operaciones de Tunc Orb al día en el plan gratuito, 500,000 con almacenamiento de pago. Las lecturas, búsquedas y guardados cuentan; las eliminaciones y las consultas de estado no. El conteo se reinicia a la medianoche UTC.
- Por agente, cada segundo: 50 lecturas, 20 guardados, 5 búsquedas y 20 llamadas de otro tipo. Las ráfagas cortas no son problema.
- Tunc Art: 60 cargas por minuto por persona, y archivos de hasta 250 MiB.
- El almacenamiento se comparte con Tunc Hub, Tunc Orb y Tunc Art; la página de tu cuenta muestra la parte de cada producto.
Errores
| Código | Significado | Detalles del almacenamiento |
|---|---|---|
507 storage_limit | Tunc Orb: tu almacenamiento de Tunc está lleno, así que el guardado se rechazó, después de eliminar tus archivos más antiguos de Tunc Art para hacer espacio, si había alguno. Las lecturas y eliminaciones siguen funcionando. | error.details.storage: state, limit_bytes, used_bytes, orb_bytes, art_bytes, needed_bytes, manage_url |
409 storage_quota_exceeded | Tunc Art: la carga no cabe, ni siquiera después de eliminar tus archivos más antiguos para hacer espacio. | quota_bytes, active_bytes, requested_bytes, y storage con los mismos campos que arriba |
429 rate_limited | Demasiadas llamadas. Espera details.retry_after_secs (Orb) o el encabezado Retry-After (ambos). En Orb, details.limit indica qué límite: daily, una clase (read, write, search o control), o key_sign_in cuando demasiadas claves inician sesión a la vez. | — |
401 auth_required, not_connected | auth_required: falta la clave o no es válida. not_connected: la clave se desconectó o venció; crea una nueva. Tunc Art responde unauthenticated a una clave que no acepta. | — |
403 forbidden | La clave no tiene este acceso. missing_scope lo nombra, por ejemplo orb.write (Orb: error.details.missing_scope). Crea una clave con ese acceso. | — |
Los errores de Tunc Orb tienen esta forma: {"ok":false,"error":{"code":…,"message":…,"next_step":…,"details":{…}}}; next_step indica qué hacer. Un almacenamiento lleno nunca se arregla reintentando: elimina lo que ya no necesites o agrega almacenamiento en tu cuenta.
La API de archivos de Tunc Core con un agente que inició sesión
Un agente que inició sesión, o que aprobaste con un código en la página de conexión de tu cuenta, envía su token de acceso a la API de archivos de Tunc Core:
# Start an upload
curl -s https://core.tunc.ai/api/v1/art/files \
-H "authorization: Bearer $TUNC_ACCESS_TOKEN" \
-H 'content-type: application/json' \
-d '{"display_name":"q4-report.pdf","mime_type":"application/pdf","byte_count":482113}'
# → {"artifact":{…},"upload":{"method":"PUT","url":"…","headers":{…},"expires_in_seconds":…}}
# Send the bytes to upload.url with upload.method and upload.headers, then:
curl -s https://core.tunc.ai/api/v1/art/files/<id>/complete \
-H "authorization: Bearer $TUNC_ACCESS_TOKEN" \
-H 'content-type: application/json' -d '{"byte_count":482113}'# Files you can access (paged; filters: title, mime_prefix, kind, created_after, created_before, sort, cursor, limit)
curl -s "https://core.tunc.ai/api/v1/art/files?limit=20" \
-H "authorization: Bearer $TUNC_ACCESS_TOKEN"
# One file's metadata, then its bytes (Range supported)
curl -s https://core.tunc.ai/api/v1/art/files/<id> -H "authorization: Bearer $TUNC_ACCESS_TOKEN"
curl -s https://core.tunc.ai/api/v1/art/files/<id>/content -H "authorization: Bearer $TUNC_ACCESS_TOKEN" -o q4-report.pdfAlmacenamiento
Tunc Art y Tunc Orb comparten una misma cuota de almacenamiento por cuenta. La página de almacenamiento de tu cuenta muestra el total y la parte de cada producto. Cada archivo puede tener hasta 250 MiB; los agentes envían hasta 8 MiB en línea por MCP y los archivos más grandes con una carga prefirmada. Dale a cada archivo su tipo de medio real para que tenga vista previa.
Los archivos que guardan los agentes se conservan 30 días en el plan gratuito y 365 días con almacenamiento de pago, y cada archivo muestra su fecha de vencimiento. Cuando el almacenamiento está lleno, primero se eliminan los archivos más antiguos y tu cuenta muestra la lista de lo que se eliminó.
