agent-toolkit-for-aws: cho AI agent làm việc với AWS an toàn — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về aws/agent-toolkit-for-aws — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: agent-toolkit-for-aws: cho AI agent làm việc với AWS — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Agent Toolkit for AWS là bộ công cụ chính thức do AWS hỗ trợ, gồm plugin, skill, rules và AWS MCP Server để trợ lý AI lập trình làm việc với dịch vụ AWS. Bạn dùng nó để AI biết chọn dịch vụ, viết CDK/CloudFormation, triển khai và theo dõi hệ thống trên AWS. Với Claude Code, cài chỉ cần một lệnh /plugin install, nhưng cần có tài khoản AWS và đã cấu hình thông tin đăng nhập.
Agent Toolkit for AWS là bộ công cụ chính thức do AWS hỗ trợ, giúp các trợ lý AI lập trình (Claude Code, Codex, Cursor, Devin, Kiro, fx) biết cách xây dựng, triển khai và quản lý ứng dụng trên AWS. Bộ này gồm plugin, skill (gói hướng dẫn cho AI), file rules và một AWS MCP Server do AWS vận hành.
Nếu bạn từng nhờ AI viết hạ tầng AWS rồi nhận về lệnh sai, dịch vụ lỗi thời hoặc cấu hình mơ hồ, repo này nhắm đúng vào chuyện đó. Thay vì để AI tự đoán, bạn cho nó tài liệu AWS mới nhất, các quy trình đã được kiểm thử và một cổng truy cập có kiểm soát. Người nên dùng là dev, chủ startup nhỏ và đội kỹ thuật đang đưa sản phẩm lên AWS bằng trợ lý AI.
Điểm đáng giá nhất là phần kiểm soát. AWS cho phép viết chính sách IAM phân biệt hành động của agent với hành động của người, và mọi yêu cầu đều có số liệu CloudWatch cùng nhật ký CloudTrail. Repo hiện có khoảng 3478 sao và 457 fork, giấy phép Apache-2.0. Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi cài.
aws/agent-toolkit-for-aws
Bộ plugin, skill và AWS MCP Server chính thức của AWS, giúp Claude Code, Codex, Cursor, Kiro... xây dựng và quản lý ứng dụng trên AWS.
I.Agent Toolkit for AWS làm được gì
Bộ công cụ có năm phần chính. Bạn không cần dùng hết, thường chỉ cần một plugin là đủ bắt đầu.
A.Plugin gom sẵn mọi thứ vào một lần cài
Mỗi plugin gói cấu hình AWS MCP Server cùng các skill liên quan. Bạn cài một lần là trợ lý có cả hai. Repo liệt kê năm plugin:
- aws-corekiến thức lõi về chọn dịch vụ, CDK/CloudFormation, serverless, container, lưu trữ, giám sát, chi phí, dùng SDK và triển khai. README ghi rõ đây là plugin nên bắt đầu.
- aws-agentsxây dựng AI agent trên AWS với Amazon Bedrock và AgentCore.
- aws-data-analyticsdata lake, phân tích và ETL với S3 Tables, AWS Glue, Athena.
- aws-agents-for-devsecopsđiều tra sự cố, review code, chạy UAT trước khi phát hành, quét lỗ hổng và chạy kiểm thử xâm nhập, dựa trên AWS DevOps Agent và AWS Security Agent.
- aws-startup-advisorđóng vai kiến trúc sư giải pháp cho startup. Đề xuất kiến trúc nhỏ nhất hợp với giai đoạn, ngân sách tín dụng và đội ngũ của bạn. Có thể dựng sườn, chuyển từ Azure, Google Cloud hoặc Heroku sang AWS, chuyển lời gọi mô hình sang Amazon Bedrock, điều tra sự cố và trả lời câu hỏi về tín dụng AWS Activate.
B.Skill nạp theo nhu cầu
Skill là gói hướng dẫn và tài liệu tham khảo cho từng việc cụ thể trên AWS. Trợ lý chỉ lấy phần liên quan đến việc đang làm, nên không bị nhồi quá nhiều chữ. Mỗi skill là một thư mục có file SKILL.md, đôi khi kèm thư mục references.
C.AWS MCP Server do AWS vận hành
Đây là cổng để AI chạm vào AWS qua giao thức MCP. README nêu bốn điểm:
- Phủ API của hơn 300 dịch vụ AWS qua một endpoint đã xác thực.
- Chạy script Python trong môi trường cô lập (sandbox) cho các thao tác nhiều bước.
- Tìm và đọc tài liệu AWS mới nhất mà không cần xác thực.
- Kiểm soát doanh nghiệp: số liệu CloudWatch, khoá điều kiện IAM riêng cho agent, nhật ký CloudTrail.
D.Rules file
Thư mục rules/ chứa các file cấu hình mẫu cho dự án, dặn agent cách dùng AWS hiệu quả: dùng MCP Server, tìm skill có sẵn, tra tài liệu trước khi hành động.
E.Quan hệ với AWS Labs
Theo README, đây là bản kế nhiệm các MCP server, skill, plugin từng phát hành trong AWS Labs. Bản AWS Labs vẫn chạy và nhận đóng góp, nhưng AWS khuyên dùng toolkit này vì có khoá điều kiện IAM cho agent, nhật ký kiểm toán đầy đủ và skill đã qua đánh giá từ đầu đến cuối.
II.Cần chuẩn bị gì
Tư liệu chỉ nêu những điều sau, mình không thêm gì khác:
- Một trợ lý AI lập trình được hỗ trợ: Claude Code, Codex, Cursor, Devin, Kiro hoặc fx. Plugin hiện có cho Claude Code, Codex, Cursor và Devin. Agent khác thì cấu hình AWS MCP Server thủ công rồi cài skill.
- Với Kiro, fx và các agent khác: cài sẵn công cụ uv (README dẫn về trang tài liệu uv để cài) vì cấu hình MCP dùng lệnh
uvx. Lệnhnpx skills addcần có Node.js, nhưng README không ghi phiên bản. - Một tài khoản AWS có thông tin đăng nhập đã cấu hình trên máy. Cần cho việc gọi API và chạy script. Tìm tài liệu và khám phá skill thì không cần.
- Với Devin: chạy
devin auth logintrước. - Hệ điều hành và phần cứng: README không nêu yêu cầu cụ thể. Không thấy yêu cầu GPU.
Tài khoản AWS có thể phát sinh chi phí khi AI tạo tài nguyên thật. Hãy thử trên tài khoản thử nghiệm hoặc quyền chỉ-đọc trước, và đọc kỹ những gì AI định làm trước khi cho phép.
III.Cài đặt từng bước
Cách cài phụ thuộc trợ lý bạn đang dùng. Mình hướng dẫn kỹ Claude Code (phổ biến nhất), rồi nêu ngắn các agent còn lại.
- Chọn trợ lý AIXác định bạn dùng Claude Code, Codex, Cursor, Devin, Kiro hay fx
- Cài plugin aws-coreMột lệnh /plugin install trong Claude Code
- Cấu hình AWSCó tài khoản AWS và thông tin đăng nhập trên máy
- Cài thêm plugin khácaws-agents, aws-data-analytics... khi cần
- Hoặc cài skill thủ côngVới Kiro, fx, agent khác: MCP Server cộng npx skills add
A.Cài plugin aws-core trong Claude Code
Mở Claude Code trong thư mục dự án, rồi gõ lệnh dưới đây vào khung chat của Claude Code (không gõ vào terminal thường). Plugin nằm trên marketplace chính thức claude-plugins-official, vốn có sẵn trong Claude Code.
/plugin install aws-core@claude-plugins-officialNếu báo Plugin not found, cập nhật danh mục marketplace trước rồi cài lại:
/plugin marketplace update claude-plugins-officialB.Cài các plugin còn lại
Cũng gõ trong Claude Code. Chỉ cài khi bạn thật sự cần mảng đó.
/plugin install aws-agents@claude-plugins-official
/plugin install aws-data-analytics@claude-plugins-officialPlugin aws-agents-for-devsecops có hai cách cài, dùng marketplace của repo hoặc marketplace chính thức, rồi chạy lệnh setup:
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-agents-for-devsecops
/reload-plugins
# Or from Claude's official marketplace:
/plugin install aws-agents-for-devsecops@claude-plugins-official
/reload-plugins
# Setup:
/aws-agents-for-devsecops:setupPlugin aws-startup-advisor cài từ marketplace của repo này:
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-startup-advisor@agent-toolkit-for-aws
/reload-pluginsC.Cài bằng AWS CLI
README còn có một cách dùng ngay từ terminal với AWS CLI. Chạy lệnh này, rồi xem hướng dẫn tích hợp AWS CLI trong tài liệu AWS để biết cấu hình và cách dùng chi tiết:
aws configure agent-toolkitD.Cài cho Codex
Trong terminal:
codex plugin marketplace add aws/agent-toolkit-for-awsSau đó mở Codex, gõ /plugins để duyệt và cài plugin aws-core.
E.Cài cho Cursor
Cursor cài qua giao diện, không có lệnh. Vào Settings → Plugins → Team Marketplaces → Add Marketplace → Import from Repo, nhập aws/agent-toolkit-for-aws. Sau đó mở bảng Plugins và cài aws-core (hoặc aws-agents, aws-data-analytics khi cần).
F.Cài cho Devin
Đăng nhập bằng devin auth login trước, rồi chạy:
devin plugins install aws/agent-toolkit-for-aws#plugins/aws-coreThêm --local nếu chỉ muốn cài trên máy này. Muốn plugin khác thì thay aws-core bằng tên plugin đó. Trên web Devin, vào Customize → Plugins → Add plugin → From repository, nhập aws/agent-toolkit-for-aws và đặt thư mục con là plugins/aws-core.
G.Cài cho Kiro: hai phần độc lập
Kiro cần hai phần riêng: AWS MCP Server (gọi API và tra tài liệu) và skill cục bộ (hướng dẫn theo việc). Skill không cần MCP Server và ngược lại.
Phần 1: thêm đoạn sau vào file .kiro/settings/mcp.json:
{
"mcpServers": {
"aws": {
"command": "uvx",
"args": [
"mcp-proxy-for-aws-cli@latest",
"https://aws-mcp.us-east-1.api.aws/mcp",
"--metadata",
"AWS_REGION=us-west-2"
]
}
}
}Phần 2: cài skill. Lệnh này chép skill vào ~/.kiro/skills/ (toàn cục) hoặc .kiro/skills/ (theo dự án):
npx skills add aws/agent-toolkit-for-aws/skillsH.Cài cho fx và agent khác
Với fx, thêm MCP Server bằng một lệnh:
fx mcp add aws uvx mcp-proxy-for-aws-cli@latest https://aws-mcp.us-east-1.api.aws/mcp --metadata AWS_REGION=us-west-2Rồi cài skill cho fx (thêm -g nếu muốn cài toàn cục):
npx skills add aws/agent-toolkit-for-aws/skills -a fxNếu đang mở phiên fx khi sửa file cấu hình, gõ /mcp reload để nạp lại. Với agent khác, làm theo hướng dẫn AWS MCP Server getting started trong tài liệu AWS, rồi chạy npx skills add aws/agent-toolkit-for-aws/skills.
Chỗ người mới hay vấp: gõ nhầm chỗ. Lệnh bắt đầu bằng /plugin gõ trong khung chat của Claude Code. Lệnh npx, codex, devin, fx gõ trong terminal.
IV.Kiểm tra đã chạy được chưa
README không đưa lệnh kiểm tra riêng, nên mình gợi ý cách đơn giản dựa trên những gì có trong tư liệu:
- Với Claude Code: sau khi cài, gõ
/reload-pluginsrồi kiểm tra trong danh sách plugin xem aws-core đã có chưa. Với Codex, gõ/pluginsxem aws-core đã cài. Với Cursor, mở bảng Plugins. - Với fx: gõ
/skillshoặc$ở khung soạn để xem skill đã cài. - Với Kiro: skill được phát hiện tự động. Kiểm tra thư mục
~/.kiro/skills/hoặc.kiro/skills/có các thư mục skill. - Thử một câu hỏi tra tài liệu (không cần đăng nhập AWS), ví dụ nhờ trợ lý tìm hướng dẫn một dịch vụ AWS. Nếu trợ lý trả lời kèm nội dung từ tài liệu AWS, phần MCP đã thông.
Muốn biết chắc việc gọi API thật chạy được, bạn cần thông tin đăng nhập AWS đã cấu hình trên máy.
V.Dùng vào việc thật
Những tình huống dưới đây bám theo mô tả plugin trong README. Câu lệnh mẫu chỉ là gợi ý cách nói chuyện với trợ lý, không phải lệnh cố định của repo.
A.Chủ startup nhỏ muốn dựng hệ thống đầu tiên
Bạn làm sản phẩm với hai dev, ngân sách hạn chế, chưa biết nên dùng dịch vụ AWS nào. Cài aws-startup-advisor rồi nói với trợ lý:
Chúng tôi là startup 3 người, cần web app có đăng nhập và lưu file ảnh. Hãy đề xuất kiến trúc nhỏ nhất trên AWS, ưu tiên chi phí thấp, rồi giải thích từng dịch vụ.Theo README, plugin này đề xuất kiến trúc nhỏ nhất hợp với giai đoạn, tín dụng và đội ngũ, rồi có thể dựng sườn cho bạn. Kết quả là một bản đề xuất có lý do cho từng lựa chọn, thay vì danh sách dịch vụ chung chung.
Cho AI đọc tài liệu AWS mới nhất trước khi nó viết lệnh, đỡ hơn nhiều so với sửa lỗi sau khi nó đoán sai.
Ông T
B.Dev chuyển hệ thống từ Heroku hoặc Azure sang AWS
Bạn có app chạy trên Heroku và muốn chuyển. Với aws-startup-advisor, README nói plugin hỗ trợ chuyển từ Azure, Google Cloud, Heroku, và chuyển lời gọi mô hình từ OpenAI hay Gemini sang Amazon Bedrock. Bạn mở dự án, rồi viết:
App này đang chạy trên Heroku. Hãy đọc mã nguồn, đề xuất kế hoạch chuyển sang AWS theo từng bước và chỉ rõ chỗ nào cần tôi quyết định.Bạn nhận một kế hoạch chuyển đổi để duyệt trước khi cho AI làm thật. Nên duyệt từng bước, đừng cho chạy một mạch.
C.Dev viết hạ tầng bằng CDK hoặc CloudFormation
Với aws-core, trợ lý có kiến thức về CDK/CloudFormation, serverless, container và triển khai. Ví dụ bạn viết:
Tạo một API serverless nhận dữ liệu đơn hàng và lưu vào cơ sở dữ liệu. Dùng CDK, giải thích từng tài nguyên sẽ tạo trước khi triển khai.Kết quả là mã hạ tầng được viết dựa trên tài liệu hiện hành. Bạn đọc kỹ mã trước khi triển khai và theo dõi chi phí.
D.Đội kỹ thuật cần kiểm soát AI trong môi trường công ty
Trưởng nhóm lo AI lỡ tay xoá hay sửa tài nguyên thật. Theo README, bạn có thể viết chính sách IAM chỉ cho phép thao tác đọc khi đi qua MCP Server, kể cả khi vai trò IAM của người dùng có quyền ghi. Mọi yêu cầu còn để lại số liệu CloudWatch và nhật ký CloudTrail để kiểm toán. Cách làm cụ thể xem tài liệu AWS về AWS MCP Server, vì README không đưa mẫu chính sách.
VI.Lỗi hay gặp và cách xử lý
A.Báo Plugin not found khi cài
Danh mục marketplace trên máy bạn đã cũ. README hướng dẫn chạy /plugin marketplace update claude-plugins-official rồi cài lại.
B.Gõ lệnh đúng nhưng không có gì xảy ra
Thường là gõ sai chỗ: lệnh /plugin phải gõ trong Claude Code, còn npx, codex, devin gõ trong terminal. Sau khi cài plugin, chạy /reload-plugins để nạp lại.
C.Gọi API AWS bị từ chối hoặc báo thiếu quyền
Bạn chưa cấu hình thông tin đăng nhập AWS trên máy, hoặc vai trò IAM không đủ quyền. README nói cần thông tin đăng nhập cho việc gọi API và chạy script, nhưng không cần cho tìm tài liệu. Kiểm tra lại cấu hình theo tài liệu AWS. Đừng vì vội mà cấp quyền quản trị toàn phần cho agent.
D.Cấu hình Kiro hoặc fx không chạy được MCP
Cả hai cách đều dùng uvx, nên máy phải cài sẵn uv. Kiểm tra uv đã có chưa, và file .kiro/settings/mcp.json hoặc ~/.fx/mcp.json đúng định dạng. Lưu ý fx dùng khoá mcp chứ không phải mcpServers. Nếu đang mở phiên fx, gõ /mcp reload.
E.Cài skill xong nhưng AI không dùng
Skill nạp theo nhu cầu, nên chỉ kích hoạt khi việc bạn nhờ khớp với skill. Hãy nói rõ bạn đang làm gì trên AWS. Với Kiro, bạn cũng nên kiểm tra thư mục skill đã có đủ file SKILL.md.
VII.Có nên dùng không
Điểm mạnh. Đây là bộ công cụ chính thức do AWS hỗ trợ, có giấy phép Apache-2.0, nhiều đường cài cho nhiều trợ lý, và được cập nhật trong những tháng gần đây. Điểm khác biệt lớn là phần kiểm soát dành cho doanh nghiệp: khoá IAM riêng cho agent, CloudWatch, CloudTrail. Skill cũng được AWS cho biết đã qua đánh giá end-to-end.
Giới hạn. Công cụ này chỉ phục vụ AWS, nếu bạn dùng đám mây khác thì không phải lựa chọn của bạn. Dùng đầy đủ cần tài khoản AWS và thiết lập thông tin đăng nhập, nên với người hoàn toàn mới sẽ cần thêm thời gian làm quen. README cũng không nói về chi phí của AWS MCP Server hay yêu cầu hệ điều hành, các mục đó bạn cần xem trong tài liệu AWS. Plugin hiện chỉ có cho Claude Code, Codex, Cursor và Devin, agent khác phải cấu hình tay.
Khi nên chọn cách khác. Nếu bạn chỉ cần hỏi đáp về AWS thỉnh thoảng, đọc tài liệu trực tiếp là đủ. Nếu bạn đang dùng các MCP server trong AWS Labs và chúng chạy ổn, bạn không buộc phải đổi ngay, vì AWS nói chúng vẫn hoạt động. Còn nếu bắt đầu mới và dùng AI để làm việc với AWS, mình khuyên bắt đầu từ plugin aws-core trên tài khoản thử nghiệm, thử một việc nhỏ rồi mới mở rộng.
Câu hỏi thường gặp
Agent Toolkit for AWS có miễn phí không?
Repo dùng giấy phép Apache-2.0 nên bạn tải và dùng mã nguồn tự do. Tuy nhiên, README không nêu chi phí của AWS MCP Server hay các dịch vụ đi kèm. Tài nguyên AWS mà AI tạo ra trong tài khoản của bạn sẽ tính phí theo quy định của AWS.
Có cần tài khoản AWS không?
Cần nếu bạn muốn AI gọi API và chạy script trên AWS, và phải cấu hình thông tin đăng nhập trên máy. Riêng việc tìm tài liệu AWS và khám phá skill thì README nói không cần tài khoản.
Dùng với trợ lý AI nào được?
README nêu Claude Code, Codex, Cursor, Devin, Kiro và fx. Plugin có sẵn cho Claude Code, Codex, Cursor và Devin. Với agent khác, bạn cấu hình AWS MCP Server thủ công rồi cài skill bằng npx skills add.
Có chạy được trên Windows không? Cần GPU không?
README không nêu yêu cầu hệ điều hành hay phần cứng, nên chưa có thông tin chính thức về Windows. Cũng không thấy yêu cầu GPU. Bạn nên xem user guide của AWS trước khi cài.
Làm sao để AI không tự ý sửa hoặc xoá tài nguyên?
AWS cung cấp khoá điều kiện IAM phân biệt hành động của agent với hành động của người. Nhờ đó bạn có thể chỉ cho phép thao tác đọc qua MCP Server, kể cả khi vai trò IAM của bạn có quyền ghi. Mọi yêu cầu cũng có nhật ký CloudTrail để kiểm tra lại.
Khác gì các MCP server trong AWS Labs?
Theo README, Agent Toolkit for AWS là bản kế nhiệm các công cụ của AWS Labs. Nó có khoá điều kiện IAM cho agent, CloudWatch và CloudTrail cho mọi yêu cầu, và skill đã qua đánh giá end-to-end. Bản AWS Labs vẫn chạy và nhận đóng góp.
Nên bắt đầu với plugin nào?
README ghi rõ nên bắt đầu với aws-core, bao gồm chọn dịch vụ, CDK/CloudFormation, serverless, container, lưu trữ, giám sát, chi phí, SDK và triển khai. Khi cần làm AI agent hoặc phân tích dữ liệu, bạn cài thêm aws-agents hoặc aws-data-analytics.


