AWS bedrock-agentcore documentation change
Summary
Complete restructuring of documentation with detailed setup steps for MCP server integration, agent transformation, deployment, and testing. Added client-specific configuration examples and prerequisites.
Security assessment
Changes focus on procedural setup/configuration without mentioning vulnerabilities or security patches. The 'Identity management' mention in next steps references secure access control but doesn't document implementation. No evidence of addressing existing security issues.
Diff
diff --git a/bedrock-agentcore/latest/devguide/mcp-getting-started.md b/bedrock-agentcore/latest/devguide/mcp-getting-started.md index 050e97d84..cda162e26 100644 --- a//bedrock-agentcore/latest/devguide/mcp-getting-started.md +++ b//bedrock-agentcore/latest/devguide/mcp-getting-started.md @@ -5 +5 @@ -Topics +PrerequisitesStep 1: Install the MCP serverStep 2: Transform an existing agent for AgentCore runtimeStep 3: Deploy your agent to AgentCore runtimeStep 4: Test your deployed agentNext steps @@ -7,3 +7 @@ Topics -Amazon Bedrock AgentCore is in preview release and is subject to change. - -# Get started with Amazon Bedrock AgentCore MCP server +# Amazon Bedrock AgentCore MCP Server: Vibe coding with your coding assistant @@ -15 +13,307 @@ The MCP server works with popular MCP clients including Kiro, Cursor, Claude Cod -## Topics +###### Topics + + * Prerequisites + + * Step 1: Install the MCP server + + * Step 2: Transform an existing agent for AgentCore runtime + + * Step 3: Deploy your agent to AgentCore runtime + + * Step 4: Test your deployed agent + + * Next steps + + + + +## Prerequisites + +Before you begin, verify that you have the following: + + * An AWS account with Amazon Bedrock AgentCore permissions + + * AWS CLI installed and configured with appropriate credentials. For setup instructions, see [Installing or updating to the latest version of the AWS CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-installing.html). + + * One of the supported MCP clients: + + * Kiro + + * Cursor + + * Claude Code + + * Amazon Q CLI + + * An existing AgentCore agent built with a supported framework (Strands Agents, LangGraph, CrewAI, or similar) + + + + +For more information about Amazon Bedrock AgentCore, see the [Amazon Bedrock AgentCore documentation](https://docs.aws.amazon.com/bedrock-agentcore/). + +### Install required dependencies + +Install the necessary packages for Amazon Bedrock AgentCore development. + +To install the required packages, run the following commands: + + + # Install AgentCore dependencies + pip install bedrock-agentcore + pip install bedrock-agentcore-starter-toolkit + + +## Step 1: Install the MCP server + +To install the AgentCore MCP server, add it to your MCP client's configuration file. Each MCP client stores this configuration in a different location. + +### Add MCP server configuration + +Choose your MCP client and add the corresponding configuration: + +#### For Kiro + +Add to `.kiro/settings/mcp.json` (if it doesn't exist, see [Creating Configuration Files ](https://kiro.dev/docs/mcp/configuration/#creating-configuration-files)): + + + { + "mcpServers": { + "bedrock-agentcore-mcp-server": { + "command": "uvx", + "args": [ + "awslabs.amazon-bedrock-agentcore-mcp-server@latest" + ], + "env": { + "FASTMCP_LOG_LEVEL": "ERROR" + }, + "disabled": false, + "autoApprove": [ + "search_agentcore_docs", + "fetch_agentcore_doc" + ] + } + } + } + + +#### For Cursor + +Add to `.cursor/mcp.json`: + + + { + "mcpServers": { + "bedrock-agentcore-mcp-server": { + "command": "uvx", + "args": [ + "awslabs.amazon-bedrock-agentcore-mcp-server@latest" + ], + "env": { + "FASTMCP_LOG_LEVEL": "ERROR" + }, + "disabled": false, + "autoApprove": [ + "search_agentcore_docs", + "fetch_agentcore_doc" + ] + } + } + } + + +#### For Amazon Q + +The best practice is to configure MCP servers for individual Q CLI agents. For configuration instructions, see [Configuring MCP servers for Amazon Q CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-config-CLI.html). + +For Amazon Q in IDEs (VS Code and JetBrains), see [Using MCP servers with Amazon Q in your IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/mcp-ide.html). + +#### For Claude Code + +Configuration depends on your installation: + + * **Standalone app** : Add to `~/.claude/mcp.json` + + * **VS Code extension** : Configure MCP servers through the Claude Code CLI first, then the extension will automatically use them. See the [Claude Code VS Code documentation](https://docs.claude.com/en/docs/claude-code/vs-code) for setup details. + + + + +For standalone Claude Code app: + + + { + "mcpServers": { + "bedrock-agentcore-mcp-server": { + "command": "uvx", + "args": [ + "awslabs.amazon-bedrock-agentcore-mcp-server@latest" + ], + "env": { + "FASTMCP_LOG_LEVEL": "ERROR" + }, + "disabled": false, + "autoApprove": [ + "search_agentcore_docs", + "fetch_agentcore_doc" + ] + } + } + } + + +### Verify MCP server installation + +To verify that the MCP server is connected and working successfully, restart your MCP client after adding the configuration and confirm that the following tools are available: + + * `search_agentcore_docs` \- Search Amazon Bedrock AgentCore documentation + + * `fetch_agentcore_doc` \- Fetch specific Amazon Bedrock AgentCore documentation pages + + + + +## Step 2: Transform an existing agent for AgentCore runtime + +To make your existing AgentCore agent code compatible with Amazon Bedrock AgentCore Runtime, use the MCP server to guide the transformation process. For example, if you have a Strands AgentCore agent, the transformation helps convert it to be Amazon Bedrock AgentCore-compatible by updating imports, dependencies, and application structure. + +### Transform your agent code + +The MCP server guides your MCP client to make the following changes to your AgentCore agent code: + +#### Add runtime library imports + +The MCP server adds the required AgentCore imports: + + + from bedrock_agentcore.runtime import BedrockAgentCoreApp + + +#### Update dependencies + +The MCP server updates your `requirements.txt` file: + + + bedrock-agentcore + strands-agents