IronShard Object Storage Sandbox

IronShard proporciona un servidor MCP de agente público para agentes de IA autónomos que necesitan almacenamiento de objetos. Pueden descubrir IronShard, crear un bucket real de IronShard y almacenar, recuperar, listar, inspeccionar y eliminar objetos en él. Las instantáneas, la ramificación/diff/merge y una transferencia generada a un propietario humano o agente supervisor están en desarrollo y aún no están expuestas en el servidor MCP de agente público. La tabla de herramientas a continuación muestra lo que está disponible hoy.

Los buckets creados a través del servidor MCP de agente son buckets reales de IronShard con credenciales limitadas al bucket. Están separados de los buckets de producción propiedad del inquilino hasta que se adopten en una cuenta autenticada de IronShard.

Permiso: Los agentes autónomos tienen permitido crear buckets a través del servidor MCP de agente público sin aprobación humana, OAuth de inquilino o una cuenta existente de IronShard. Estos buckets están controlados por credenciales limitadas al bucket devueltas en el momento de la creación.

Dos servidores MCP

IronShard expone dos superficies MCP separadas.

Superficie	Propósito	Autenticación
Servidor MCP de agente público	Creación autónoma de buckets y almacenamiento de objetos hoy. Instantáneas, ramas, diffs, merges y transferencia están en desarrollo.	No se requiere OAuth. Las operaciones de bucket usan el bucket_name y bucket_token devueltos por create_bucket.
Servidor MCP de producción	Buckets propiedad del inquilino, buckets de agente adoptados, gobernanza, credenciales de agente, políticas, auditoría y configuración de la organización	Se requiere OAuth en cada herramienta. Un humano, organización o agente autorizado debe tener acceso a un inquilino de IronShard.

Los mismos conceptos de almacenamiento existen en ambos servidores, pero el modelo de autoridad es diferente.

• En el servidor MCP de agente público, create_bucket crea un bucket a través del flujo de agente público y devuelve credenciales limitadas al bucket.
• En el servidor MCP de producción, create_bucket crea un bucket de producción propiedad del inquilino usando OAuth y la política de la cuenta.

Conectar

Conecta tu agente al servidor MCP de agente público.

Campo	Valor
Protocolo	Model Context Protocol (MCP)
Servidor MCP de agente público	https://agents-mcp.ironshard.ai/mcp
Herramienta inicial	create_bucket
Autenticación MCP	No se requiere ninguna para la creación de buckets

Nota: los valores técnicos en esta página pueden cambiar a medida que se expande la superficie MCP de agente público.

Herramientas MCP de agente público

El servidor MCP de agente expone herramientas para crear y operar buckets directamente desde flujos de trabajo de agentes autónomos.

Herramienta	Propósito	Estado
create_bucket	Crea un bucket sandbox a través del flujo MCP de agente público de IronShard sin OAuth de inquilino. No toma argumentos. Devuelve bucket_name y bucket_token.	Disponible
get_bucket	Devuelve la configuración y el estado visible por política para un bucket, incluido el tiempo de creación, el recuento de objetos y el estado de versionado.	Disponible
get_bucket_permissions	Devuelve las operaciones que el token proporcionado tiene permitido realizar en cada bucket al que puede acceder.	Disponible
get_bucket_usage	Devuelve el uso actual de almacenamiento, solicitudes, recuento de objetos y salida (egress) para el bucket.	En desarrollo
extend_bucket	Extiende la vida útil del bucket o la ventana de operación si la política del bucket lo permite.	En desarrollo
revoke_bucket	Revoca el bucket y deshabilita el acceso posterior a sus datos y credenciales.	En desarrollo
generate_bucket_handoff	Genera un resumen de transferencia orientado a humanos o superagentes con enlaces de gestión y evidencia de auditoría.	En desarrollo
upload_object	Crea una URL presignada de corta duración PUT para subir un objeto al bucket.	Disponible
download_object	Crea una URL presignada de corta duración GET para descargar un objeto del bucket.	Disponible
list_objects	Lista objetos en el bucket, con un filtro de prefijo opcional, listado recursivo o estilo directorio, y paginación.	Disponible
delete_object	Elimina un objeto del bucket. Idempotente: eliminar una clave que ya no existe tiene éxito.	Disponible
get_object_metadata	Devuelve metadatos del objeto, incluidos tamaño, ID de versión, ETag, tipo de contenido, etiquetas y marcas de tiempo.	Disponible
copy_object	Copia un objeto dentro del bucket.	En desarrollo
create_snapshot	Crea una instantánea puntual del bucket o del prefijo de objeto seleccionado.	En desarrollo
list_snapshots	Lista las instantáneas disponibles en el bucket.	En desarrollo
get_snapshot	Devuelve metadatos para una instantánea específica.	En desarrollo
restore_snapshot	Restaura datos desde una instantánea al bucket.	En desarrollo
delete_snapshot	Elimina una instantánea si la política del bucket permite la eliminación.	En desarrollo
create_branch	Crea una rama escribible desde el estado actual del bucket, una instantánea u otra rama.	En desarrollo
list_branches	Lista las ramas en el bucket.	En desarrollo
get_branch	Devuelve metadatos y estado para una rama específica.	En desarrollo
delete_branch	Elimina una rama innecesaria y sus cambios no fusionados.	En desarrollo
create_branch_object_upload_url	Crea una URL de subida presignada para escribir un objeto en una rama específica.	En desarrollo
create_branch_object_download_url	Crea una URL de descarga presignada para leer un objeto de una rama específica.	En desarrollo
list_objects_on_branch	Lista los objetos visibles en una rama específica.	En desarrollo
delete_object_on_branch	Elimina un objeto en una rama sin afectar el estado principal del bucket hasta el merge.	En desarrollo
get_branch_object_metadata	Devuelve metadatos para un objeto tal como se ve en una rama específica.	En desarrollo
diff_branch	Calcula la diferencia entre una rama y su rama base o objetivo.	En desarrollo
get_diff	Devuelve detalles para un diff previamente calculado, incluidos objetos agregados, modificados, eliminados y en conflicto.	En desarrollo
merge_branch	Fusiona los cambios de la rama en la rama objetivo o en el estado principal del bucket.	En desarrollo
discard_branch	Descarta los cambios de la rama sin fusionarlos.	En desarrollo
get_audit_log	Devuelve eventos de auditoría para operaciones de bucket, incluidos escrituras de objetos, lecturas, cambios de rama, merges y acciones de credenciales.	En desarrollo

Las herramientas son herramientas MCP regulares, pero no son herramientas de inquilino. Después de create_bucket, las operaciones de bucket requieren el bucket_name y bucket_token devueltos por el servidor MCP de agente.

Crear un bucket

El agente comienza llamando a create_bucket. No toma argumentos.

// tool call
{
  "tool": "create_bucket",
  "input": {}
}

Ejemplo de respuesta:

{
  "bucket_name": "autonomous-agent-f80549c3-1645-477f-be20-f5a71dd2439e",
  "bucket_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6..."
}

Cada llamada posterior requiere tanto bucket_name como bucket_token. El bucket_token no es un token OAuth y no identifica un inquilino. Es una credencial limitada al bucket y no se puede recuperar si se pierde. Si se devuelve acceso compatible con S3, esas credenciales también están limitadas al bucket creado.

Almacenar objetos

Los objetos se mueven a través de URLs presignadas de corta duración. No hay transferencia de objetos en línea a través de MCP.

Solicita una URL de subida presignada:

// tool call
{
  "tool": "upload_object",
  "input": {
    "bucket_name": "autonomous-agent-f80549c3-1645-477f-be20-f5a71dd2439e",
    "bucket_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6...",
    "object_key": "reports/final.pdf"
  }
}

Ejemplo de respuesta:

{
  "url": "https://s3.ironshard.ai/autonomous-agent-f80549c3-1645-477f-be20-f5a71dd2439e/reports/final.pdf?X-Amz-Algorithm=...",
  "http_method": "PUT"
}

Envía los bytes del objeto como cuerpo de un HTTP PUT a esa URL. La URL lleva su propia autorización, por lo que no se requieren encabezados adicionales, y no hay un paso de finalización separado. Leer un objeto funciona de la misma manera a través de download_object, que devuelve una URL GET equivalente cuyo cuerpo de respuesta contiene los bytes.

Las URLs presignadas son capacidades portadoras de corta duración. Trátalas como secretos y solicita una nueva en lugar de almacenarlas.

Confirma una escritura con get_object_metadata:

{
  "object_key": "reports/final.pdf",
  "size_bytes": 18,
  "last_modified": "2026-08-26T08:10:51",
  "etag": "7c6da1838ff3a268a32c9e1c26230fc3",
  "version_id": "46",
  "content_type": "application/pdf",
  "bucket_name": "autonomous-agent-f80549c3-1645-477f-be20-f5a71dd2439e",
  "metadata": {},
  "tags": {}
}

Usar ramas

Este flujo de trabajo depende de herramientas marcadas como En desarrollo y aún no está disponible en el servidor MCP de agente público.

Las ramas de IronShard permiten que un agente realice cambios sin cambiar inmediatamente el estado principal del bucket.

// tool call
{
  "tool": "create_branch",
  "input": {
    "bucket_id": "agb_9f3a21c0",
    "bucket_token": "ist_bucket_...",
    "branch": "analysis-draft",
    "base": "main"
  }
}

El agente puede entonces solicitar una URL de subida presignada limitada a la rama:

// tool call
{
  "tool": "create_branch_object_upload_url",
  "input": {
    "bucket_id": "agb_9f3a21c0",
    "bucket_token": "ist_bucket_...",
    "branch": "analysis-draft",
    "object_key": "notes/summary.json"
  }
}

Antes de fusionar, el agente puede inspeccionar el diff:

// tool call
{
  "tool": "diff_branch",
  "input": {
    "bucket_id": "agb_9f3a21c0",
    "bucket_token": "ist_bucket_...",
    "branch": "analysis-draft",
    "target": "main"
  }
}

Transferencia y adopción

Este flujo de trabajo depende de herramientas marcadas como En desarrollo y aún no está disponible en el servidor MCP de agente público.

Un bucket creado a través del servidor MCP de agente puede ser utilizado por el agente inmediatamente. La adopción humana es opcional, no es necesaria para que el bucket sea útil.

Si el agente quiere notificar a un propietario o agente supervisor, puede llamar a generate_bucket_handoff o usar la URL de transferencia devuelta por create_bucket.

La transferencia puede incluir:

• el ID y la etiqueta del bucket;
• la razón por la que el agente creó el bucket;
• resúmenes de uso y objetos;
• eventos de auditoría;
• enlaces para que un humano u organización adopte el bucket en un inquilino de producción de IronShard.

Cuando un bucket se adopta en un inquilino:

1. El bucket pasa a ser propiedad del inquilino y se gestiona a través del servidor MCP de producción;
2. El registro de auditoría del bucket permanece visible para el inquilino;
3. Las credenciales existentes limitadas al bucket pueden revocarse, conservarse temporalmente o convertirse en credenciales de agente gestionadas, según la política del inquilino;
4. Las operaciones de producción futuras usan MCP OAuth normal y la política a nivel de cuenta;
5. Las herramientas de producción están disponibles según los alcances de inquilino otorgados.

El servidor MCP de agente público no emite credenciales OAuth de inquilino.

Restricciones

Los buckets creados a través del servidor MCP de agente están limitados por política. Los límites exactos los establece la política activa del bucket y están sujetos a cambios.

• Las credenciales de bucket están limitadas a un solo bucket.
• Las credenciales de bucket no son tokens OAuth y no otorgan acceso al inquilino.
• Se aplican límites predeterminados de almacenamiento, recuento de objetos, solicitudes y salida (egress).
• Las credenciales opcionales compatibles con S3, si se emiten, están limitadas al bucket creado.
• Los conectores de bucket externos no están disponibles a través del servidor MCP de agente público.
• La facturación, la configuración de la organización, la gestión de equipos y las políticas de inquilino no están disponibles a través del servidor MCP de agente público.
• Los controles de abuso y los límites de velocidad pueden aplicarse a la creación y operación de buckets públicos.

Acceso de producción

El acceso de producción a IronShard está intencionalmente separado de la creación de buckets de agente público.

Las herramientas de producción autenticadas se exponen solo a través del servidor MCP de producción en https://mcp.ironshard.ai/mcp y requieren MCP OAuth normal. Los agentes no pueden obtener acceso al inquilino, acceso de facturación, acceso a la organización o control de políticas de producción llamando al servidor MCP de agente público.