IronShard Object Storage Sandbox
Crie um bucket de armazenamento de objetos sandbox gratuito; envie, baixe, liste, inspecione e exclua objetos.
Documentação
IronShard fornece um servidor MCP público para agentes para agentes de IA autônomos que precisam de armazenamento de objetos. Eles podem descobrir o IronShard, criar um bucket real do IronShard e armazenar, recuperar, listar, inspecionar e excluir objetos nele. Snapshots, branch/diff/merge e um handoff gerado para um proprietário humano ou agente supervisor estão em desenvolvimento e ainda não estão expostos no servidor MCP público para agentes. A tabela de ferramentas abaixo mostra o que está disponível hoje.
Buckets criados por meio do servidor MCP para agentes são buckets reais do IronShard com credenciais com escopo no bucket. Eles são separados dos buckets de produção de propriedade do locatário até serem adotados em uma conta autenticada do IronShard.
Permissão: Agentes autônomos têm permissão para criar buckets por meio do servidor MCP público para agentes sem aprovação humana, OAuth de locatário ou uma conta existente do IronShard. Esses buckets são controlados por credenciais com escopo no bucket retornadas no momento da criação.
Dois servidores MCP
O IronShard expõe duas superfícies MCP separadas.
| Superfície | Finalidade | Autenticação |
|---|---|---|
| Servidor MCP público para agentes | Criação autônoma de buckets e armazenamento de objetos hoje. Snapshots, branches, diffs, merges e handoff estão em desenvolvimento. | Nenhum OAuth necessário. As operações de bucket usam o bucket_name e o bucket_token retornados por create_bucket. |
| Servidor MCP de produção | Buckets de propriedade do locatário, buckets de agentes adotados, governança, credenciais de agentes, políticas, auditoria e configurações da organização | OAuth obrigatório em todas as ferramentas. Um humano, organização ou agente autorizado deve ter acesso a um locatário do IronShard. |
Os mesmos conceitos de armazenamento existem em ambos os servidores, mas o modelo de autoridade é diferente.
- No servidor MCP público para agentes,
create_bucketcria um bucket por meio do fluxo público para agentes e retorna credenciais com escopo no bucket. - No servidor MCP de produção,
create_bucketcria um bucket de produção de propriedade do locatário usando OAuth e política da conta.
Conectar
Conecte seu agente ao servidor MCP público para agentes.
| Campo | Valor |
|---|---|
| Protocolo | Model Context Protocol (MCP) |
| Servidor MCP público para agentes | https://agents-mcp.ironshard.ai/mcp |
| Ferramenta inicial | create_bucket |
| Autenticação MCP | Nenhuma necessária para criação de bucket |
Observação: os valores técnicos nesta página podem mudar à medida que a superfície MCP pública para agentes se expande.
Ferramentas MCP públicas para agentes
O servidor MCP para agentes expõe ferramentas para criar e operar buckets diretamente de fluxos de trabalho autônomos de agentes.
| Ferramenta | Finalidade | Status |
|---|---|---|
create_bucket | Cria um bucket sandbox por meio do fluxo MCP público para agentes do IronShard sem OAuth de locatário. Não aceita argumentos. Retorna bucket_name e bucket_token. | Disponível |
get_bucket | Retorna a configuração e o estado visível pela política de um bucket, incluindo tempo de criação, contagem de objetos e status de versionamento. | Disponível |
get_bucket_permissions | Retorna as operações que o token fornecido tem permissão para executar em cada bucket que ele pode acessar. | Disponível |
get_bucket_usage | Retorna o uso atual de armazenamento, solicitações, contagem de objetos e egress do bucket. | Em desenvolvimento |
extend_bucket | Estende o tempo de vida do bucket ou a janela de operação se a política do bucket permitir. | Em desenvolvimento |
revoke_bucket | Revoga o bucket e desabilita o acesso posterior aos seus dados e credenciais. | Em desenvolvimento |
generate_bucket_handoff | Gera um resumo de handoff voltado para humanos ou superagentes com links de gerenciamento e evidências de auditoria. | Em desenvolvimento |
upload_object | Cria uma URL PUT pré-assinada de curta duração para enviar um objeto ao bucket. | Disponível |
download_object | Cria uma URL GET pré-assinada de curta duração para baixar um objeto do bucket. | Disponível |
list_objects | Lista objetos no bucket, com filtro de prefixo opcional, listagem recursiva ou no estilo de diretório e paginação. | Disponível |
delete_object | Exclui um objeto do bucket. Idempotente: excluir uma chave que já não existe é bem-sucedido. | Disponível |
get_object_metadata | Retorna metadados do objeto, incluindo tamanho, ID da versão, ETag, tipo de conteúdo, tags e carimbos de data/hora. | Disponível |
copy_object | Copia um objeto dentro do bucket. | Em desenvolvimento |
create_snapshot | Cria um snapshot pontual do bucket ou do prefixo de objeto selecionado. | Em desenvolvimento |
list_snapshots | Lista snapshots disponíveis no bucket. | Em desenvolvimento |
get_snapshot | Retorna metadados de um snapshot específico. | Em desenvolvimento |
restore_snapshot | Restaura dados de um snapshot para o bucket. | Em desenvolvimento |
delete_snapshot | Exclui um snapshot se a política do bucket permitir exclusão. | Em desenvolvimento |
create_branch | Cria um branch gravável a partir do estado atual do bucket, de um snapshot ou de outro branch. | Em desenvolvimento |
list_branches | Lista branches no bucket. | Em desenvolvimento |
get_branch | Retorna metadados e status de um branch específico. | Em desenvolvimento |
delete_branch | Exclui um branch desnecessário e suas alterações não mescladas. | Em desenvolvimento |
create_branch_object_upload_url | Cria uma URL de upload pré-assinada para gravar um objeto em um branch específico. | Em desenvolvimento |
create_branch_object_download_url | Cria uma URL de download pré-assinada para ler um objeto de um branch específico. | Em desenvolvimento |
list_objects_on_branch | Lista objetos visíveis em um branch específico. | Em desenvolvimento |
delete_object_on_branch | Exclui um objeto em um branch sem afetar o estado principal do bucket até a mesclagem. | Em desenvolvimento |
get_branch_object_metadata | Retorna metadados de um objeto conforme visto em um branch específico. | Em desenvolvimento |
diff_branch | Calcula a diferença entre um branch e seu branch base ou de destino. | Em desenvolvimento |
get_diff | Retorna detalhes de um diff calculado anteriormente, incluindo objetos adicionados, modificados, excluídos e conflitantes. | Em desenvolvimento |
merge_branch | Mescla alterações do branch no branch de destino ou no estado principal do bucket. | Em desenvolvimento |
discard_branch | Descarta alterações do branch sem mesclá-las. | Em desenvolvimento |
get_audit_log | Retorna eventos de auditoria para operações de bucket, incluindo gravações de objetos, leituras, alterações de branch, merges e ações de credenciais. | Em desenvolvimento |
As ferramentas são ferramentas MCP regulares, mas não são ferramentas de locatário. Após create_bucket, as operações de bucket exigem o bucket_name e o bucket_token retornados pelo servidor MCP para agentes.
Criar um bucket
O agente começa chamando create_bucket. Ele não aceita argumentos.
// tool call
{
"tool": "create_bucket",
"input": {}
}
Exemplo de resposta:
{
"bucket_name": "autonomous-agent-f80549c3-1645-477f-be20-f5a71dd2439e",
"bucket_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6..."
}
Toda chamada posterior exige tanto o bucket_name quanto o bucket_token. O bucket_token não é um token OAuth e não identifica um locatário. É uma credencial com escopo no bucket e não pode ser recuperada se for perdida. Se o acesso compatível com S3 for retornado, essas credenciais também terão escopo no bucket criado.
Armazenar objetos
Os objetos são transferidos por URLs pré-assinadas de curta duração. Não há transferência inline de objetos por meio do MCP.
Solicite uma URL de upload pré-assinada:
// tool call
{
"tool": "upload_object",
"input": {
"bucket_name": "autonomous-agent-f80549c3-1645-477f-be20-f5a71dd2439e",
"bucket_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6...",
"object_key": "reports/final.pdf"
}
}
Exemplo de resposta:
{
"url": "https://s3.ironshard.ai/autonomous-agent-f80549c3-1645-477f-be20-f5a71dd2439e/reports/final.pdf?X-Amz-Algorithm=...",
"http_method": "PUT"
}
Envie os bytes do objeto como corpo de um HTTP PUT para essa URL. A URL carrega sua própria autorização, portanto nenhum cabeçalho adicional é necessário, e não há etapa separada de conclusão. Ler um objeto funciona da mesma forma por meio de download_object, que retorna uma URL GET equivalente cujo corpo de resposta contém os bytes.
URLs pré-assinadas são capacidades portadoras de curta duração. Trate-as como segredos e solicite uma nova em vez de armazená-las.
Confirme uma gravação com 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 branches
Este fluxo de trabalho depende de ferramentas marcadas como Em desenvolvimento e ainda não está disponível no servidor MCP público para agentes.
Os branches do IronShard permitem que um agente faça alterações sem alterar imediatamente o estado principal do bucket.
// tool call
{
"tool": "create_branch",
"input": {
"bucket_id": "agb_9f3a21c0",
"bucket_token": "ist_bucket_...",
"branch": "analysis-draft",
"base": "main"
}
}
O agente pode então solicitar uma URL de upload pré-assinada com escopo no branch:
// 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 mesclar, o agente pode inspecionar o diff:
// tool call
{
"tool": "diff_branch",
"input": {
"bucket_id": "agb_9f3a21c0",
"bucket_token": "ist_bucket_...",
"branch": "analysis-draft",
"target": "main"
}
}
Handoff e adoção
Este fluxo de trabalho depende de ferramentas marcadas como Em desenvolvimento e ainda não está disponível no servidor MCP público para agentes.
Um bucket criado por meio do servidor MCP para agentes pode ser usado pelo agente imediatamente. A adoção humana é opcional, não sendo necessária para que o bucket seja útil.
Se o agente quiser notificar um proprietário ou agente supervisor, ele pode chamar generate_bucket_handoff ou usar a URL de handoff retornada por create_bucket.
O handoff pode incluir:
- o ID e o rótulo do bucket;
- o motivo pelo qual o agente criou o bucket;
- resumos de uso e de objetos;
- eventos de auditoria;
- links para um humano ou organização adotar o bucket em um locatário de produção do IronShard.
Quando um bucket é adotado em um locatário:
- O bucket passa a ser de propriedade do locatário e gerenciável por meio do servidor MCP de produção;
- O log de auditoria do bucket permanece visível para o locatário;
- As credenciais existentes com escopo no bucket podem ser revogadas, preservadas temporariamente ou convertidas em credenciais de agente gerenciadas, dependendo da política do locatário;
- As operações futuras de produção usam OAuth MCP normal e política de nível de conta;
- As ferramentas de produção ficam disponíveis de acordo com os escopos de locatário concedidos.
O servidor MCP público para agentes não emite credenciais OAuth de locatário.
Restrições
Buckets criados por meio do servidor MCP para agentes são limitados por política. Os limites exatos são definidos pela política ativa do bucket e estão sujeitos a alterações.
- As credenciais do bucket têm escopo em um único bucket.
- As credenciais do bucket não são tokens OAuth e não concedem acesso ao locatário.
- Os limites padrão de armazenamento, contagem de objetos, solicitações e egress se aplicam.
- Credenciais opcionais compatíveis com S3, se emitidas, têm escopo no bucket criado.
- Conectores externos de bucket não estão disponíveis por meio do servidor MCP público para agentes.
- Cobrança, configurações da organização, gerenciamento de equipe e políticas de locatário não estão disponíveis por meio do servidor MCP público para agentes.
- Controles de abuso e limites de taxa podem se aplicar à criação e operação pública de buckets.
Acesso de produção
O acesso de produção ao IronShard é intencionalmente separado da criação pública de buckets por agentes.
As ferramentas de produção autenticadas são expostas apenas pelo servidor MCP de produção em https://mcp.ironshard.ai/mcp e exigem OAuth MCP normal. Os agentes não podem obter acesso ao locatário, acesso a cobrança, acesso à organização ou controle de política de produção chamando o servidor MCP público para agentes.