View a markdown version of this page

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

에이전트 설정 가이드

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

AWS 서버리스 스킬 설치

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

서버리스 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"
  }
}

Windsurf

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"
      }
    }
  }
}