本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 代理安装指南
<a name="eb-agent-setup-guide"></a>

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

**与你的编码代理合作**  
如需快速入门参考，您可以将此链接直接拖放到代理的上下文中：`https://docs.aws.amazon.com/eventbridge/latest/userguide/samples/aws-eventbridge-agent-setup.md`

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

## 先决条件
<a name="eb-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="eb-agent-setup-claude-code"></a>

安装 aws-core 插件，这是[代理工具包](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/what-is-agent-toolkit.html)的一部分 AWS，它捆绑了 AWS MCP 服务器配置和一组精选的代理技能（包括无服务器技能）。 AWS 

### 从代理工具包中安装 aws-core 插件适用于 AWS
<a name="eb-agent-setup-claude-code-plugin"></a>

运行以下命令安装插件：

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

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

### 安装无服务器 MCP 服务器
<a name="eb-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="eb-agent-setup-codex"></a>

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

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

### 安装无服务器 MCP 服务器
<a name="eb-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="eb-agent-setup-cursor"></a>

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

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

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

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

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

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

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

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

安装以下 Kiro 权力，按需为 Kiro 代理提供专门的上下文和工具：
+ **无服务器应用程序模型 (SAM)**-通过 [Kiro powers 链接](https://kiro.dev/launch/powers/add/?name=aws-sam)进行安装。

## GitHub 副驾驶
<a name="eb-agent-setup-github-copilot"></a>

### 安装 AWS 无服务器技能
<a name="eb-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="eb-agent-setup-github-copilot-mcp"></a>

将以下内容添加到`.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"
  }
}
```

## Windsurf
<a name="eb-agent-setup-windsurf"></a>

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

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

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

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

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

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

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

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

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

### 安装 AWS 无服务器技能
<a name="eb-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="eb-agent-setup-other-agents-mcp"></a>

将无服务器 MCP 服务器添加到代理的 MCP 客户端配置文件下。`"mcpServers"`{{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"
      }
    }
  }
}
```