Amazon DynamoDB
List og beskriv DynamoDB-tabeller, administrér tabel-lifecycle, og query eller mutér items via MCP med IAM access keys.
Overblik
Forbind Amazon DynamoDB, så AI-klienter kan liste og beskrive tabeller, oprette, opdatere eller slette tabeller, og query, scan, get, put, update eller delete items i din AWS-konto.
Integrationen bruger Amazon DynamoDB API med IAM access keys, der gemmes krypteret i stackgate.ai. Forbruget afregnes på din AWS-konto.
Forudsætninger
- En AWS-konto med DynamoDB-tabeller, som AI-klienter skal have adgang til (eller rettighed til at oprette nye tabeller)
- En stackgate.ai-konto
Credentials
- Opret en IAM-bruger i AWS IAM-konsollen med programmatic access.
- Vedhæft en least-privilege-politik. Den engelske guide har JSON-eksempler for read-only, read-write og table-admin.
- Opret en access key og kopiér key ID og secret.
- Gå til Mine integrationer → Amazon DynamoDB på stackgate.ai.
- Klik Aktivér og indtast access key ID, secret access key, AWS-region og evt. et standard DynamoDB-table-navn.
Til DynamoDB Local eller LocalStack kan du angive et valgfrit custom endpoint (fx http://localhost:8000).
Brug med AI-klienter
- Dedikeret endpoint:
POST /mcp/dynamodbmed Sanctum bearer token - Private gateway: én config til alle integrationer — brug
dynamodb__*-navngivne værktøjer
Typisk workflow:
- list_tables — find tabeller (paginér med
exclusive_start_key) - describe_table — lær partition/sort keys og GSIs før læs/skriv
- query_table — foretrukken læsesti når partition key er kendt
- get_item — hent ét item med fuld primary key
- put_item / update_item / delete_item — ændr items (bekræft med bruger)
- create_table / update_table / delete_table — administrér tabeller (
delete_tablekræverconfirm: true)
Keys og items bruger DynamoDB AttributeValue JSON, fx:
{ "pk": { "S": "user#1" }, "count": { "N": "42" } }
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 inkluderer de nødvendige DynamoDB-actions og table-ARNs.
- table_name is required — angiv
table_nameeller sæt et standard-table i Mine integrationer. - ThrottlingException — DynamoDB throttler ved kapacitetsoverskridelse. Back off og retry; foretræk query_table frem for gentagne scan_table-kald.
- 1 MB sidegrænse — Query og Scan returnerer højst 1 MB pr. kald. Paginér med
exclusive_start_key/last_evaluated_key. - delete_table blokeret — send kun
confirm: trueefter eksplicit brugergodkendelse; sletter tabellen permanent. - AttributeValue-format — hvert attribut skal bruge typed keys (
S,N,B,BOOL,M,L, osv.) som i DynamoDB JSON-reference.
Tilgængelige værktøjer
-
list_tables
List DynamoDB-tabeller i den forbundne AWS-konto og region.
-
describe_table
Beskriv en DynamoDB-tabel: key schema, indexes, billing mode og status.
-
create_table
Create a new DynamoDB table with key schema and optional GSIs/LSIs.
-
update_table
Update a DynamoDB table: throughput, GSIs, streams, or SSE settings.
-
delete_table
Delete a DynamoDB table. Requires confirm=true and explicit user approval.
-
query_table
Query items efter partition key. Foretrukken læsesti; paginér med exclusive_start_key (1 MB/side).
-
scan_table
Scan a DynamoDB table. Expensive on large tables — prefer query_table; use limit and pagination.
-
get_item
Get a single item by primary key.
-
put_item
Put (opret eller erstat) et item i en DynamoDB-tabel.
-
update_item
Update attributes on an existing item.
-
delete_item
Delete an item by primary key.
MCP-endpoint:
https://stackgate.ai/mcp/dynamodb
(HTTP) eller via
private gateway.
Relaterede workflows
Multi-integrations-playbooks, der bruger Amazon DynamoDB til konkrete forretningsresultater.