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 và AWS MCP Server để các AI coding agent làm việc với AWS an toàn hơn. Bạn dùng nó để nhờ agent chọn dịch vụ, viết CDK/CloudFormation, triển khai, xem chi phí hay điều tra sự cố. Với Claude Code, cài chỉ cần một dòng lệnh /plugin install; các agent khác cần thêm vài bước cấu hình.
Agent Toolkit for AWS là bộ công cụ chính thức do AWS hỗ trợ, giúp các AI coding agent (Claude Code, Codex, Cursor, Devin, Kiro, fx) xây dựng, triển khai và quản lý ứng dụng trên AWS. Bộ này gồm ba thứ: plugin (cài một lần là có đủ), skill (các gói hướng dẫn cho từng việc cụ thể) và AWS MCP Server (cổng để agent gọi vào AWS).
Vấn đề nó giải quyết khá quen thuộc. Nếu bạn nhờ một AI viết code cho AWS mà không có công cụ chuyên biệt, AI thường đoán mò: sai tên dịch vụ, cấu hình lỗi thời, hoặc không biết cách triển khai cho đúng. Toolkit này đưa cho agent kiến thức chuẩn, tài liệu AWS cập nhật và cả những hàng rào an toàn để nó làm việc có kiểm soát hơn.
Bạn nên đọc bài này nếu là lập trình viên mới, người làm kỹ thuật ở công ty nhỏ, hoặc founder startup đang dùng (hoặc định dùng) AWS cùng một AI agent. Điểm đáng giá nhất là phần kiểm soát: AWS cho phép đặt chính sách IAM chỉ áp dụng cho hành động của agent, kèm số liệu CloudWatch và nhật ký CloudTrail. Repo hiện có khoảng 3476 sao và 454 fork. Bạn có thể xem video ngắn bên dưới để hình dung nhanh trước khi đọc tiếp.
aws/agent-toolkit-for-aws
Bộ plugin, skill và MCP server chính thức của AWS giúp AI agent như 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ụ chia thành mấy nhóm. Hiểu từng nhóm giúp bạn biết cần cài gì, khỏi cài thừa.
A.Plugin: cài một lần, có đủ cấu hình và skill
Plugin gói sẵn cấu hình AWS MCP Server cùng các skill vào một lần cài. Hiện có năm plugin:
- aws-corenền tảng, README ghi rõ là nơi nên bắt đầu. Bao phủ chọn dịch vụ, CDK/CloudFormation, serverless, container, lưu trữ, quan sát hệ thống (observability), hoá đơn (billing), cách dùng SDK và triển khai.
- aws-agentsdành cho việc xây AI agent trên AWS với Amazon Bedrock và AgentCore.
- aws-data-analyticsdành cho data lake, phân tích và ETL với S3 Tables, AWS Glue và Athena.
- aws-agents-for-devsecopsđiều tra sự cố, review code, chạy UAT để kiểm tra mức sẵn sàng phát hành, quét lỗ hổng và chạy thử xâm nhập, thông qua AWS DevOps Agent và AWS Security Agent.
- aws-startup-advisornhư có một Solutions Architect của AWS cho startup ngồi trong trợ lý lập trình. Nó đề xuất kiến trúc nhỏ nhất phù hợp giai đoạn, ngân sách credit và quy mô đội. Sau đó nó có thể dựng khung, hỗ trợ chuyển từ Azure, Google Cloud hay Heroku sang AWS, chuyển lời gọi mô hình sang Amazon Bedrock, điều tra sự cố production, trả lời câu hỏi về điều kiện nhận credit AWS Activate và tìm ưu đãi cho startup.
B.Skill: hướng dẫn nạp khi cần
Skill là các gói chỉ dẫn và tài liệu tham khảo giúp agent làm một việc AWS cụ thể. Agent chỉ tải đúng skill liên quan đến việc đang làm, nên không bị nhồi đầy thông tin. 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: cổng để agent gọi AWS
Đây là server do AWS quản lý, nói chuyện với agent qua giao thức MCP (Model Context Protocol). Theo tư liệu, nó cung cấp:
- Truy cập hơn 300 dịch vụ AWS qua một điểm kết nối đã 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 theo thời gian thực. Phần này không cần xác thực.
- Kiểm soát cấp doanh nghiệp: số liệu CloudWatch, khoá điều kiện IAM riêng cho agent và nhật ký CloudTrail.
D.Rules files: luật chơi cho dự án
Thư mục rules/ chứa các file cấu hình khuyến nghị ở cấp dự án. Chúng dặn agent nên dùng AWS MCP Server, nên tìm skill có sẵn và nên tra tài liệu trước khi làm. Chi tiết xem trong thư mục rules/ của repo.
E.Khác gì các công cụ AWS Labs trước đây
Từ 2025 AWS đã phát hành MCP server, skill và plugin trong AWS Labs. README nói Agent Toolkit là bản kế nhiệm và khuyên dùng bản này vì ba lý do: có 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; có CloudWatch và CloudTrail cho mọi yêu cầu; và skill đã qua đánh giá đầu-cuối. Công cụ AWS Labs vẫn chạy bình thường.
II.Cần chuẩn bị gì
Tuỳ bạn dùng agent nào, yêu cầu sẽ khác. Dưới đây là những gì README nêu:
- Một AI coding agent trong danh sách 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 MCP Server trực tiếp rồi cài skill.
- uv nếu bạn dùng Kiro, fx hoặc agent khác (README yêu cầu cài sẵn uv).
- Tài khoản AWS và thông tin đăng nhập đã cấu hình trên máy. Cần khi agent gọi API hoặc chạy script. Không cần nếu bạn chỉ tìm tài liệu hoặc xem danh sách skill.
- Devin: cần chạy được
devin auth login. - Lệnh
npx skills add ...dùng npx nên máy cần có Node.js. README không ghi phiên bản cụ thể.
README không nói gì về hệ điều hành hay phần cứng (như GPU), nên mình không khẳng định. Công cụ này chạy phía agent, còn việc nặng nằm ở dịch vụ AWS.
Agent có thể gọi API AWS thật bằng quyền của tài khoản bạn đã cấu hình. Nếu chỉ để học, hãy dùng tài khoản thử nghiệm hoặc vai trò (role) chỉ có quyền đọc. Đừng gắn quyền quản trị cho agent khi bạn chưa quen. Việc thao tác trên AWS có thể phát sinh chi phí.
III.Cài đặt từng bước
Cách cài phụ thuộc agent bạn dùng. Mình hướng dẫn Claude Code trước vì ngắn nhất, rồi tóm tắt các agent còn lại.
- Chọn agentXác định bạn dùng Claude Code, Codex, Cursor, Devin, Kiro hay fx
- Cài plugin aws-coreBắt đầu với plugin nền tảng, README khuyên làm đầu tiên
- Cấu hình thông tin AWSĐăng nhập AWS trên máy nếu cần gọi API thật
- Cài thêm plugin khácaws-agents, aws-data-analytics, devsecops hoặc startup-advisor khi cần
- Với Kiro/fx/agent khácThêm AWS MCP Server rồi cài skill bằng npx
A.Cài plugin aws-core trong Claude Code
Mở Claude Code (trong terminal, tại thư mục dự án của bạn) rồi gõ lệnh sau ngay trong khung chat của Claude Code, không phải trong terminal thường:
/plugin install aws-core@claude-plugins-officialPlugin nằm trên kho chính thức của Anthropic (claude-plugins-official), kho này có sẵn trong Claude Code. Nếu báo Plugin not found, hãy cập nhật danh mục trước rồi cài lại:
/plugin marketplace update claude-plugins-officialB.Cài các plugin còn lại
Các plugin khác cài tương tự, chỉ đổi tên:
/plugin install aws-agents@claude-plugins-official
/plugin install aws-data-analytics@claude-plugins-officialPlugin aws-agents-for-devsecops có hai cách. Cách thứ nhất là thêm kho của repo, cài, rồi nạp lại:
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-agents-for-devsecops
/reload-pluginsCách thứ hai là cài từ kho chính thức của Anthropic:
/plugin install aws-agents-for-devsecops@claude-plugins-official
/reload-pluginsSau đó chạy lệnh thiết lập:
/aws-agents-for-devsecops:setupPlugin aws-startup-advisor cài từ kho của chính repo này:
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-startup-advisor@agent-toolkit-for-aws
/reload-plugins/reload-plugins giúp Claude Code nạp plugin mới mà không cần mở lại phiên.
C.Dùng từ AWS CLI
Nếu bạn đã quen AWS CLI, README ghi một lệnh để dùng toolkit ngay từ terminal:
aws configure agent-toolkitCách thiết lập chi tiết nằm ở hướng dẫn tích hợp AWS CLI trong tài liệu chính thức của AWS (README có dẫn link tới).
D.Cài cho Codex
Trong terminal:
codex plugin marketplace add aws/agent-toolkit-for-awsRồi mở Codex, gõ /plugins để duyệt và cài plugin aws-core.
E.Cài cho Cursor
Cursor cài bằng 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 (bắt đầu từ đây), cần thì cài thêm aws-agents hoặc aws-data-analytics.
F.Cài cho Devin
Trước hết đăng nhập, rồi cài plugin:
devin auth login
devin plugins install aws/agent-toolkit-for-aws#plugins/aws-corePlugin sẽ được thêm vào bộ plugin cá nhân của bạn. Thêm --local nếu chỉ muốn cài trên máy này. Muốn plugin khác, thay aws-core bằng tên plugin đó. Trên web Devin, chọn 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: thêm MCP Server
Kiro cần hai phần độc lập. Phần một là AWS MCP Server. Bạn thêm đoạn sau vào file cấu hình MCP của Kiro là .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"
]
}
}
}Đoạn này dùng uvx, nên bạn phải cài uv trước. Nếu file đã có nội dung, hãy thêm mục aws vào trong mcpServers hiện có, đừng ghi đè cả file. Giá trị AWS_REGION là vùng AWS bạn muốn dùng.
H.Cài skill (Kiro và các agent khác)
Phần hai là cài skill từ repo:
npx skills add aws/agent-toolkit-for-aws/skillsVới Kiro, skill được lưu vào ~/.kiro/skills/ (toàn cục) hoặc .kiro/skills/ (theo dự án). Kiro tự phát hiện và kích hoạt skill khi việc bạn nhờ phù hợp. Skill không cần MCP Server và MCP Server cũng không phục vụ skill đã cài tại máy, hai phần chạy độc lập.
I.Cài cho 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-2Hoặc sửa tay file ~/.fx/mcp.json. fx dùng khoá mcp chứ không phải mcpServers:
{
"mcp": {
"aws": {
"type": "local",
"command": [
"uvx",
"mcp-proxy-for-aws-cli@latest",
"https://aws-mcp.us-east-1.api.aws/mcp",
"--metadata",
"AWS_REGION=us-west-2"
]
}
}
}Nếu phiên fx đang mở lúc bạn sửa file, chạy /mcp reload để nạp lại. Rồi cài skill:
npx skills add aws/agent-toolkit-for-aws/skills -a fxMặc định skill vào .fx/skills/ (theo dự án); thêm -g để cài toàn cục vào ~/.fx/skills/.
J.Các agent khác
Làm theo hướng dẫn bắt đầu với AWS MCP Server trong tài liệu chính thức (README có link), rồi cài skill bằng chính lệnh npx skills add aws/agent-toolkit-for-aws/skills ở trên.
IV.Kiểm tra đã chạy được chưa
README không đưa ra một lệnh kiểm tra chính thức. Bạn có thể tự kiểm tra theo cách an toàn sau, dựa trên những gì tư liệu mô tả:
- Claude Codesau
/reload-plugins, gõ/pluginđể xem plugin vừa cài có trong danh sách không. Với devsecops, lệnh/aws-agents-for-devsecops:setupphải chạy được. - Codexgõ
/plugins, thấy aws-core trong danh sách để cài là kho đã nhận. - Fxgõ
/skillshoặc ký tự$ở khung soạn để xem skill đã cài;/mcp reloadsau khi sửa file. - Kiro và các agent kháckiểm tra thư mục
.kiro/skills/(hoặc~/.kiro/skills/) có các thư mục skill, mỗi thư mục chứa SKILL.md. - Thử hỏinhờ agent một câu chỉ cần tra tài liệu, ví dụ "Tìm trong tài liệu AWS xem S3 Tables là gì". Việc này theo README không cần thông tin đăng nhập AWS, nên giúp bạn tách lỗi cài đặt khỏi lỗi tài khoản.
V.Dùng vào việc thật
Bạn không cần học cú pháp mới. Bạn nói chuyện với agent như bình thường, còn plugin và skill lo phần kiến thức AWS phía sau. Dưới đây là các tình huống bám đúng khả năng của từng plugin.
A.Founder startup chọn kiến trúc cho sản phẩm đầu tiên
Bạn là người làm sản phẩm nhỏ, chưa có đội hạ tầng, còn credit AWS Activate chưa biết dùng sao. Cài aws-startup-advisor, rồi nhờ trong Claude Code:
Mình là startup 3 người, làm ứng dụng đặt lịch. Hãy đề xuất kiến trúc AWS nhỏ nhất phù hợp giai đoạn này, và nói rõ chi phí cần để ý.Theo mô tả của plugin, agent sẽ đề xuất kiến trúc tối thiểu theo giai đoạn, đội ngũ và credit. Nếu bạn đồng ý, nó có thể dựng khung dự án. Bạn cũng có thể hỏi về điều kiện nhận credit Activate.
Không cần thuê kiến trúc sư AWS riêng: cài plugin, hỏi đúng câu, rồi đọc kỹ đề xuất trước khi bấm triển khai.
Ông T
B.Lập trình viên triển khai ứng dụng serverless
Bạn có một API nhỏ và muốn chạy trên AWS nhưng chưa rành CloudFormation. Với aws-core, nhờ agent:
Dùng CDK để tạo hạ tầng serverless cho API này, giải thích từng tài nguyên sẽ tạo trước khi triển khai.Skill CDK/CloudFormation và serverless trong aws-core hướng dẫn agent làm đúng quy trình. Kết quả là bộ mã hạ tầng và lời giải thích để bạn đọc. Hãy xem lại trước khi cho phép triển khai thật.
C.Người phụ trách chi phí kiểm tra hoá đơn
Bạn làm văn phòng hoặc vận hành và cần hiểu vì sao hoá đơn AWS tăng. aws-core có phần billing, nên bạn có thể hỏi:
Giải thích giúp mình các khoản đang tốn nhiều nhất trong tài khoản AWS và gợi ý chỗ có thể giảm.Việc này cần thông tin đăng nhập AWS đã cấu hình vì agent phải đọc dữ liệu thật. Nên dùng quyền chỉ đọc. Kết quả phụ thuộc vào quyền bạn cấp và dữ liệu có trong tài khoản.
D.Đội dev kiểm tra an ninh trước khi phát hành
Với aws-agents-for-devsecops, sau khi chạy /aws-agents-for-devsecops:setup, bạn có thể nhờ agent quét lỗ hổng trong code, review code, chạy UAT để kiểm tra mức sẵn sàng phát hành, hoặc điều tra một sự cố. Việc này dựa trên AWS DevOps Agent và AWS Security Agent, là hai dịch vụ riêng của AWS. Hãy đọc tài liệu của hai dịch vụ này để biết điều kiện sử dụng và chi phí, vì README không nói rõ.
VI.Lỗi hay gặp và cách xử lý
A.Báo Plugin not found
Đây là lỗi README có nhắc. Danh mục plugin trên máy bạn đã cũ. Chạy /plugin marketplace update claude-plugins-official rồi cài lại.
B.Cài xong nhưng chưa thấy plugin hoặc skill
Với Claude Code, chạy /reload-plugins. Với fx, nếu bạn vừa sửa file MCP khi phiên đang mở, chạy /mcp reload. Nếu vẫn không thấy, đóng và mở lại agent.
C.Lệnh uvx hoặc npx báo không tìm thấy
Máy bạn chưa cài công cụ tương ứng. README yêu cầu cài uv cho Kiro, fx và các agent khác. Còn npx đi kèm Node.js. Cài xong, mở lại terminal rồi thử lại.
D.Agent báo thiếu quyền hoặc không gọi được API
Thường do chưa cấu hình thông tin đăng nhập AWS trên máy, hoặc vai trò của bạn không đủ quyền. Nhớ rằng tra cứu tài liệu và tìm skill không cần đăng nhập, còn gọi API và chạy script thì cần. Nếu tổ chức của bạn có chính sách IAM riêng cho agent (ví dụ chỉ cho đọc), một số thao tác ghi sẽ bị chặn. Đó là hành vi đúng thiết kế, hãy nhờ quản trị viên AWS điều chỉnh thay vì tìm cách lách.
E.Sửa nhầm file cấu hình MCP
File JSON sai dấu phẩy hoặc ngoặc sẽ làm agent không đọc được cấu hình. Sao lưu file trước khi sửa, thêm mục aws vào đúng chỗ rồi kiểm tra lại cú pháp. Nhớ fx dùng khoá mcp, còn Kiro dùng mcpServers.
VII.Có nên dùng không
Điểm mạnh. Đây là bộ công cụ chính thức, giấy phép Apache-2.0, repo vẫn được cập nhật trong vài tháng gần đây. Cài cho Claude Code chỉ cần một dòng lệnh. Kiểm soát cho agent tốt hơn hẳn việc đưa thẳng khoá truy cập cho một AI: có khoá điều kiện IAM riêng, CloudWatch và CloudTrail. Skill được nạp theo nhu cầu nên agent không bị rối. Bộ plugin cũng phủ nhiều tình huống từ chọn kiến trúc, dữ liệu, xây agent đến bảo mật.
Giới hạn. Công cụ này chỉ dành cho AWS. Nếu bạn dùng Azure hay Google Cloud, nó không giúp được, trừ khi bạn đang tính chuyển sang AWS. Bạn vẫn cần hiểu cơ bản về AWS để biết agent đang làm gì, và phải tự duyệt trước khi cho triển khai, vì thao tác trên AWS có thể tốn tiền. Cài cho Kiro, fx hay agent khác phải làm hai phần (MCP Server và skill), phức tạp hơn so với Claude Code. README cũng chưa nêu rõ yêu cầu hệ điều hành hay phiên bản Node.
Khi nào nên chọn cách khác. Nếu chỉ cần hỏi đáp kiến thức AWS, bạn có thể đọc thẳng tài liệu. Nếu bạn đang dùng công cụ từ AWS Labs và chạy ổn, README cho biết chúng vẫn hoạt động, bạn có thể chuyển sang bản này khi cần các tính năng kiểm soát và audit. Với người mới, mình khuyên bắt đầu bằng aws-core, dùng tài khoản thử nghiệm với quyền chỉ đọc, và chỉ mở rộng quyền khi đã quen.
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 mã nguồn dùng tự do. Tuy nhiên README không nói về chi phí của AWS MCP Server hay các dịch vụ như AWS DevOps Agent, AWS Security Agent. Việc agent tạo tài nguyên trên AWS có thể phát sinh phí, bạn nên xem trang giá của AWS.
Cần GPU hay máy cấu hình mạnh không?
README không yêu cầu GPU hay phần cứng riêng. Công cụ này chủ yếu gồm cấu hình, skill và kết nối tới AWS MCP Server do AWS quản lý.
Dùng được với những AI agent nào?
README nêu Claude Code, Codex, Cursor, Devin, Kiro và fx. Plugin hiện có cho Claude Code, Codex, Cursor và Devin. Với agent khác, bạn cấu hình AWS MCP Server trực tiếp rồi cài skill bằng npx.
Chạy trên Windows được không?
README không nói riêng về hệ điều hành. Các lệnh là lệnh của agent, uvx, npx và AWS CLI, nên khả năng chạy phụ thuộc vào việc những công cụ đó chạy được trên máy bạn. Chưa có thông tin chính thức về Windows trong tư liệu.
Có cần tài khoản AWS không?
Cần nếu agent phải gọi API hoặc chạy script, và thông tin đăng nhập phải được cấu hình sẵn trên máy. Nếu chỉ tìm tài liệu AWS hoặc xem danh sách skill thì không cần tài khoản.
Agent có thể làm hỏng tài khoản AWS của tôi không?
Agent hành động bằng quyền của thông tin đăng nhập bạn cấp, nên quyền càng rộng rủi ro càng lớn. README nói bạn có thể viết chính sách IAM chỉ áp dụng cho agent, ví dụ chỉ cho đọc, và theo dõi bằng CloudWatch, CloudTrail. Hãy bắt đầu với quyền chỉ đọc.
Khác gì các MCP server trong AWS Labs?
README nói Agent Toolkit là bản kế nhiệm các công cụ AWS Labs. Nó bổ sung khoá điều kiện IAM phân biệt agent với người, CloudWatch và CloudTrail cho mọi yêu cầu, và skill đã qua đánh giá đầu-cuối. Công cụ AWS Labs vẫn tiếp tục hoạt động.


