View a markdown version of this page

에이전트 설정 가이드 - AWS Lambda
사전 조건Claude CodeCodexCursorKiroGitHub CopilotDevin 데스크톱OpenCode에이전트 스킬 및 MCP 서버 구성과 호환되는 다른 모든 에이전트의 경우추가 Lambda 스킬 설치

에이전트 설정 가이드

AI 코딩 에이전트는 애플리케이션 스캐폴딩, 배포 구성, 디버깅 및 코드형 인프라 생성에 대한 지능형 지원을 제공하여 서버리스 개발을 가속화할 수 있습니다. 플러그인, 기술 및 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 서버 설정을 참조하세요.

Claude Code

AWS MCP 서버 구성과 선별된 에이전트 스킬 세트(AWS 서버리스 스킬 포함)를 번들링하는 Agent Toolkit for AWS의 일부인 aws-core 플러그인을 설치합니다.

Agent Toolkit for AWS에서 aws-core 플러그인 설치

다음 명령을 실행하여 플러그인을 설치합니다.

/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-core@agent-toolkit-for-aws

이렇게 하면 AWS 서버리스 스킬, 에이전트 후크 및 AWS MCP 서버 구성을 포함한 에이전트 스킬이 한 번에 설치됩니다.

서버리스 MCP 서버 설치

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 플러그인을 찾아 설치합니다.

서버리스 MCP 서버 설치

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 서버리스 스킬 설치

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

서버리스 MCP 서버 설치

"mcpServers" 아래의 .cursor/mcp.json에 다음을 추가합니다. 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 서버리스 스킬 설치

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

서버리스 MCP 서버 설치

"mcpServers" 아래의 ~/.kiro/settings/mcp.json에 다음을 추가합니다. 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 전원 설치(Kiro IDE에서)

온디맨드 방식으로 Kiro 에이전트에 특수 컨텍스트와 도구를 제공하는 다음 Kiro 파워를 설치합니다.

GitHub Copilot

AWS 서버리스 스킬 설치

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

서버리스 MCP 서버 설치

"mcpServers" 아래의 .vscode/mcp.json에 다음을 추가합니다. 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 데스크톱

AWS 서버리스 스킬 설치

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

서버리스 MCP 서버 설치

"mcpServers" 아래의 /.codeium/windsurf/mcp_config.json에 다음을 추가합니다. 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 서버리스 스킬 설치

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

서버리스 MCP 서버 설치

"mcpServers" 아래의 /.config/opencode/opencode.jsonc에 다음을 추가합니다. 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 서버 구성과 호환되는 다른 모든 에이전트의 경우

오픈 소스 에이전트 스킬 형식 및 MCP 서버 구성을 지원하는 다른 에이전트의 경우 다음 단계를 따르세요.

AWS 서버리스 스킬 설치

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

서버리스 MCP 서버 설치

"mcpServers"에서 에이전트의 MCP 클라이언트 구성 파일에 서버리스 MCP 서버를 추가합니다. 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 스킬 설치

AWS용 에이전트 툴킷에는 AI 에이전트가 Lambda 기능을 습득하는 데 도움이 되는 특수 서버리스 스킬이 포함되어 있습니다. Claude Code, Cursor, Kiro CLI, GitHub Copilot, Codex, Devin Desktop, OpenCode 등의 에이전트 또는 오픈 소스 에이전트 스킬 형식과 호환되는 기타 에이전트를 사용하여 이러한 스킬을 설치하면 에이전트가 Lambda MicroVM, Lambda Managed Instances 및 Lambda 내구성 함수를 사용하여 워크로드를 빌드, 배포 및 관리를 도울 수 있습니다.

  1. Lambda MicroVM - Lambda MicroVM은 격리된 상태 저장 실행 환경에서 사용자 또는 AI 생성 코드를 실행하기 위한 VM 수준 격리, 거의 즉각적인 시작 및 재개 속도, 상태 보존을 제공하는 서버리스 컴퓨팅 프리미티브입니다.

    npx skills add https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/serverless-skills/aws-lambda-microvms --yes --global

  2. Lambda Managed Instances 스킬 - Lambda Managed Instances를 사용하면 Lambda의 운영 편의성을 유지하면서 Amazon EC2 인스턴스에서 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

  3. Lambda 내구성 함수 스킬 - Lambda 내구성 함수를 사용하면 휴먼 인 더 루프 프로세스와 같은 장기 실행 작업에서 대기할 때 진행 상황에 체크포인트를 지정하고, 장애로부터 자동 복구하고, 최대 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