# 代理设置指南
<a name="agent-setup-guide"></a>

AI 编码代理通过为应用程序框架搭建、部署配置、调试以及基础设施即代码的生成提供智能辅助，能够加速无服务器开发。通过为您的代理配置正确的插件、技能和 MCP 服务器组合，您可以使其具备构建和管理无服务器应用程序所需的专业知识。

**与您的编码代理协作**  
如需快速入门参考，您可以将此链接直接拖放到代理的上下文中：  

```
https://docs.aws.amazon.com/lambda/latest/dg/samples/aws-lambda-agent-setup.md
```

选择与您的开发环境相匹配的安装方法。

## 先决条件
<a name="agent-setup-prerequisites"></a>

要安装 aws-core 插件和无服务器 MCP 服务器，请确保满足以下先决条件：
+ [uv](https://docs.astral.sh/uv/) 已安装在您的系统上。
+ （可选）在本地机器上配置了具有 IAM 凭证的 AWS 账户。对于执行 AWS API 调用和运行脚本的工具，需要凭证，但搜索文档或发现技能则不需要。如果您没有配置凭据，请参阅[设置 AWS MCP 服务器](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html)以获取详细说明。

## Claude Code
<a name="agent-setup-claude-code"></a>

安装 aws-core 插件，该插件属于 AWS 的一部分，它捆绑了 AWS MCP 服务器配置和一组精选的代理技能（包括 AWS 无服务器技能）。

### 从 AWS 的代理工具包中安装 aws-core 插件
<a name="agent-setup-claude-code-toolkit"></a>

运行以下命令以安装插件：

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

这将一步安装代理技能，包括 AWS 无服务器技能、代理挂钩和 AWS MCP 服务器配置。

### 安装无服务器 MCP 服务器
<a name="agent-setup-claude-code-mcp"></a>

将 `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
<a name="agent-setup-codex"></a>

### 安装 AWS 无服务器技能
<a name="agent-setup-codex-skill"></a>

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

### 安装无服务器 MCP 服务器
<a name="agent-setup-codex-mcp"></a>

将 `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
<a name="agent-setup-cursor"></a>

### 安装 AWS 无服务器技能
<a name="agent-setup-cursor-skill"></a>

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

### 安装无服务器 MCP 服务器
<a name="agent-setup-cursor-mcp"></a>

将以下内容添加到 `"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
<a name="agent-setup-kiro"></a>

### 在 Kiro CLI 中安装 AWS 无服务器技能
<a name="agent-setup-kiro-skill"></a>

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

### 安装无服务器 MCP 服务器
<a name="agent-setup-kiro-mcp"></a>

将以下内容添加到 `"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 powers（来自 Kiro IDE）
<a name="agent-setup-kiro-powers"></a>

安装以下 Kiro 能力包，它们按需为 Kiro 代理提供专门的上下文和工具：
+ **Serverless Application Model (SAM)** - 通过 [Kiro 能力包 链接](https://kiro.dev/launch/powers/add/?name=aws-sam)进行安装。
+ **Lambda 托管实例** - 通过 [Kiro 能力包链接](https://kiro.dev/launch/powers/add/?name=aws-lambda-managed-instances)进行安装。
+ **Lambda 持久性函数** - 通过 [Kiro 能力包链接](https://kiro.dev/launch/powers/add/?name=aws-lambda-durable-functions)进行安装。

## GitHub Copilot
<a name="agent-setup-github-copilot"></a>

### 安装 AWS 无服务器技能
<a name="agent-setup-github-copilot-skill"></a>

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

### 安装无服务器 MCP 服务器
<a name="agent-setup-github-copilot-mcp"></a>

将以下内容添加到 `"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
<a name="agent-setup-windsurf"></a>

### 安装 AWS 无服务器技能
<a name="agent-setup-windsurf-skill"></a>

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

### 安装无服务器 MCP 服务器
<a name="agent-setup-windsurf-mcp"></a>

将以下内容添加到 `"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
<a name="agent-setup-opencode"></a>

### 安装 AWS 无服务器技能
<a name="agent-setup-opencode-skill"></a>

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

### 安装无服务器 MCP 服务器
<a name="agent-setup-opencode-mcp"></a>

将以下内容添加到 `"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 服务器配置兼容的所有其他代理
<a name="agent-setup-other-agents"></a>

对于任何其他支持开源[代理技能](https://agentskills.io/specification)格式和 MCP 服务器配置的代理，请按照以下步骤操作：

### 安装 AWS 无服务器技能
<a name="agent-setup-other-agents-skill"></a>

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

### 安装无服务器 MCP 服务器
<a name="agent-setup-other-agents-mcp"></a>

将无服务器 MCP 服务器添加到代理的 `"mcpServers"` 下的 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"
      }
    }
  }
}
```