stackgate.ai
Alle integrationer

Amazon S3

Gennemse S3-buckets, list og download objekter (inkl. Cypress-videoer), upload filer og administrér keys via MCP.

Manual setup 7 værktøjer

Overblik

Forbind Amazon S3, så AI-klienter kan gennemse buckets, liste objekter efter prefix, hente filer (inkl. Cypress-videoer og build-artifacts), uploade objekter og kopiere eller slette keys.

Integrationen bruger Amazon S3 API med IAM access keys, der gemmes krypteret i stackgate.ai. Forbruget afregnes på din AWS-konto.

Til build-scoped artifact-adgang via et CodeBuild run ID, brug AWS CodeBuild-integrationen i stedet.

Forudsætninger

  • En AWS-konto med én eller flere S3-buckets, som AI-klienter skal have adgang til
  • En stackgate.ai-konto

Credentials

  1. Opret en IAM-bruger i AWS IAM-konsollen med programmatic access.
  2. Vedhæft en least-privilege-politik med separate s3:ListBucket på bucket-ARN og objekt-handlinger på arn:aws:s3:::bucket/* (se den engelske guide for et JSON-eksempel).
  3. Opret en access key og kopiér key ID og secret.
  4. Gå til Mine integrationer → Amazon S3 på stackgate.ai.
  5. Klik Aktivér og indtast access key ID, secret access key, AWS-region og evt. en standard S3-bucket.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/s3 med Sanctum bearer token
  • Private gateway: én config til alle integrationer — brug s3__*-navngivne værktøjer

Typisk workflow:

  1. list_buckets — find bucket-navne (eller brug standard-bucket)
  2. list_objects — gennemse et prefix (suffix: .mp4 for Cypress-videoer)
  3. head_object — tjek størrelse og content-type før download
  4. get_object — presigned_url til store filer, temp_storage til videregivelse mellem værktøjer, eller inline til små tekstfiler
  5. put_object / delete_object / copy_object — ændr objekter når nødvendigt

Se Dokumentation for HTTP-autentificering og opsætning af private gateway.

Fejlfinding

  • 422 integration not configured — udfyld alle påkrævede credential-felter i Mine integrationer.
  • 403 / AccessDenied fra AWS — verificér at IAM-politikken har s3:ListBucket på bucket-ARN og objekt-handlinger på arn:aws:s3:::bucket/*.
  • bucket is required — angiv bucket eller sæt en standard-bucket i Mine integrationer.
  • Object too large for inline — brug output_mode=presigned_url eller temp_storage på get_object.
  • KMS-fejl — tilføj KMS decrypt/generate-rettigheder til SSE-KMS buckets.
  • Temp Storage-handoff — ved output_mode=temp_storage gælder Temp Storage-opbevaring (se privatlivspolitik).

Tilgængelige værktøjer

  • list_buckets

    List S3 buckets in the connected AWS account.

  • list_objects

    List objekter i en S3-bucket efter prefix. Filtrér med suffix (fx .mp4 til Cypress-videoer).

  • head_object

    Get object metadata (size, content-type, etag) without downloading the body.

  • get_object

    Download et S3-objekt. Brug presigned_url til store filer, temp_storage til videregivelse mellem værktøjer, eller inline til små tekstfiler.

  • put_object

    Upload et objekt til S3. Angiv body (tekst) eller body_base64 for binært indhold.

  • delete_object

    Delete an object from S3. This is destructive — confirm with the user first.

  • copy_object

    Copy an S3 object to a new key, within the same bucket or to another bucket.

MCP-endpoint: https://stackgate.ai/mcp/s3 (HTTP) eller via private gateway.

Relaterede workflows

Multi-integrations-playbooks, der bruger Amazon S3 til konkrete forretningsresultater.

Opret konto Dokumentation