에이전트 설정 안내
에이전트 설정 안내
AI 코딩 에이전트는 애플리케이션 스캐폴딩, 배포 구성, 디버깅, infrastructure-as-code 생성에 대한 지능적인 지원을 제공해 서버리스 개발을 가속화할 수 있어요. 플러그인, 스킬, MCP 서버를 알맞게 조합해 에이전트를 구성하면, 서버리스 애플리케이션을 빌드하고 관리하는 데 필요한 전문성을 에이전트에 갖추게 됩니다.
본문
빠른 시작 참조를 위해 이 링크를 에이전트의 컨텍스트에 직접 넣을 수 있어요:
https://docs.aws.amazon.com/lambda/latest/dg/samples/aws-lambda-agent-setup.md
개발 환경에 맞는 설치 방법을 선택하세요.
사전 조건
aws-core 플러그인과 Serverless MCP Server를 설치하려면 다음 사전 조건이 갖춰져 있어야 해요:
- 시스템에 uv가 설치되어 있어야 합니다.
- (선택 사항) 로컬 머신에 IAM 자격 증명이 설정된 AWS 계정. 자격 증명은 AWS API 호출을 실행하고 스크립트를 실행하는 도구에 필요하지만, 문서 검색이나 스킬 발견에는 필요하지 않아요. 자격 증명이 설정되어 있지 않다면, 자세한 지침은 AWS MCP Server 설정 문서를 참고하세요.
Claude Code
Agent Toolkit for AWS의 일부인 aws-core 플러그인을 설치하세요. 이 플러그인은 AWS MCP Server 구성과 선별된 에이전트 스킬 세트(AWS serverless 스킬 포함)를 묶습니다.
Agent Toolkit for AWS에서 aws-core 플러그인 설치하기
다음 명령을 실행해 플러그인을 설치합니다:
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-core@agent-toolkit-for-aws
이 한 단계로 AWS serverless 스킬을 포함한 에이전트 스킬, 에이전트 훅, AWS MCP Server 구성을 설치합니다.
Serverless MCP Server 설치하기
AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
claude mcp add awslabs-aws-serverless-mcp \
-e AWS_PROFILE=default \
-e AWS_REGION=us-east-1 \
-e FASTMCP_LOG_LEVEL=ERROR \
--scope user \
-- uvx awslabs.aws-serverless-mcp-server@latest
Codex
Agent Toolkit for AWS에서 aws-core 플러그인 설치하기
다음 명령을 실행해 플러그인을 설치합니다:
codex plugin marketplace add aws/agent-toolkit-for-aws
그런 다음 Codex를 실행하고 /plugins를 입력해 aws-core 플러그인을 찾아 설치합니다.
Serverless MCP Server 설치하기
AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
codex mcp add awslabs-aws-serverless-mcp \
--env AWS_PROFILE=default \
--env AWS_REGION=us-east-1 \
--env FASTMCP_LOG_LEVEL=ERROR \
-- uvx awslabs.aws-serverless-mcp-server@latest
Cursor
AWS serverless 스킬 설치하기
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
Serverless MCP Server 설치하기
.cursor/mcp.json의 "mcpServers" 아래에 다음을 추가합니다. AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
"awslabs.aws-serverless-mcp": {
"command": "uvx",
"args": ["awslabs.aws-serverless-mcp-server@latest"],
"env": {
"AWS_PROFILE": "default",
"AWS_REGION": "us-east-1",
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
Kiro
Kiro CLI에 AWS serverless 스킬 설치하기
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
Serverless MCP Server 설치하기
~/.kiro/settings/mcp.json의 "mcpServers" 아래에 다음을 추가합니다. AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
"awslabs.aws-serverless-mcp": {
"command": "uvx",
"args": ["awslabs.aws-serverless-mcp-server@latest"],
"env": {
"AWS_PROFILE": "default",
"AWS_REGION": "us-east-1",
"FASTMCP_LOG_LEVEL": "ERROR"
},
"disabled": false
}
Kiro powers 설치하기
Kiro IDE에서 다음 Kiro powers를 설치하면 Kiro 에이전트에 전문화된 컨텍스트와 도구를 주문형으로 제공합니다:
- Serverless Application Model(SAM) — Kiro powers 링크를 통해 설치
- Lambda Managed Instances — Kiro powers 링크를 통해 설치
- Lambda Durable Functions — Kiro powers 링크를 통해 설치
GitHub Copilot
AWS serverless 스킬 설치하기
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
Serverless MCP Server 설치하기
.vscode/mcp.json의 "mcpServers" 아래에 다음을 추가합니다. AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
"awslabs.aws-serverless-mcp": {
"command": "uvx",
"args": ["awslabs.aws-serverless-mcp-server@latest"],
"env": {
"AWS_PROFILE": "default",
"AWS_REGION": "us-east-1",
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
Devin Desktop
AWS serverless 스킬 설치하기
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
Serverless MCP Server 설치하기
/.codeium/windsurf/mcp_config.json의 "mcpServers" 아래에 다음을 추가합니다. AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
"awslabs.aws-serverless-mcp": {
"command": "uvx",
"args": ["awslabs.aws-serverless-mcp-server@latest"],
"env": {
"AWS_PROFILE": "default",
"AWS_REGION": "us-east-1",
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
OpenCode
AWS serverless 스킬 설치하기
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
Serverless MCP Server 설치하기
/.config/opencode/opencode.jsonc의 "mcpServers" 아래에 다음을 추가합니다. AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
"awslabs.aws-serverless-mcp": {
"command": "uvx",
"args": ["awslabs.aws-serverless-mcp-server@latest"],
"env": {
"AWS_PROFILE": "default",
"AWS_REGION": "us-east-1",
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
에이전트 스킬과 MCP Server 구성을 지원하는 다른 모든 에이전트
오픈소스 에이전트 스킬 형식과 MCP Server 구성을 지원하는 다른 에이전트는 다음 단계를 따르세요:
AWS serverless 스킬 설치하기
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
Serverless MCP Server 설치하기
에이전트의 MCP 클라이언트 구성 파일의 "mcpServers" 아래에 Serverless MCP Server를 추가합니다. AWS_PROFILE을 로컬 AWS 프로필 이름으로 교체하세요.
{
"mcpServers": {
"awslabs.aws-serverless-mcp": {
"command": "uvx",
"args": ["awslabs.aws-serverless-mcp-server@latest"],
"env": {
"AWS_PROFILE": "default",
"AWS_REGION": "us-east-1",
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
추가 Lambda 스킬 설치하기
Agent Toolkit for AWS에는 AI 에이전트에게 Lambda 기능에 대한 지식을 주는 전문화된 서버리스 스킬이 포함되어 있어요. 이 스킬들을 Claude Code, Cursor, Kiro CLI, GitHub Copilot, Codex, Devin Desktop, OpenCode 또는 오픈소스 에이전트 스킬 형식과 호환되는 다른 에이전트로 설치하면, 에이전트가 Lambda MicroVMs, Lambda Managed Instances, Lambda durable functions를 사용해 워크로드를 빌드·배포·관리할 수 있게 됩니다.
- Lambda MicroVMs 스킬 — Lambda MicroVMs는 VM 수준 격리, 거의 즉각적인 시작·재개 속도, 상태 보존을 제공해 격리된 상태 저장 실행 환경에서 사용자 또는 AI 생성 코드를 실행하는 서버리스 컴퓨트 프리미티브입니다.
npx skills add https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/serverless-skills/aws-lambda-microvms --yes --global
- Lambda Managed Instances 스킬 — Lambda Managed Instances를 사용하면 인프라를 관리하지 않고도 Amazon EC2 인스턴스에서 Lambda 함수를 실행하면서 Lambda의 운영 단순성을 유지하고, Amazon EC2 요금 이점을 통한 비용 효율성과 전문화된 컴퓨트 구성을 얻을 수 있어요.
npx skills add https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/serverless-skills/aws-lambda-managed-instances --yes --global
- Lambda durable functions 스킬 — Lambda durable functions를 사용하면 진행 상황을 체크포인트하고, 실패에서 자동으로 복구하며, 인간이 개입하는 프로세스(human-in-the-loop) 같은 장기 실행 작업을 기다리는 동안 최대 1년간 실행을 일시 중단할 수 있는 내결함성 있는 장기 실행 애플리케이션을 구축할 수 있어요.
npx skills add https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/serverless-skills/aws-lambda-durable-functions --yes --global