interface AddMcpServerTargetOptions 🔹

Language	Type name
.NET	Amazon.CDK.AWS.Bedrock.Agentcore.Alpha.AddMcpServerTargetOptions
Go	github.com/aws/aws-cdk-go/awsbedrockagentcorealpha/v2#AddMcpServerTargetOptions
Java	software.amazon.awscdk.services.bedrock.agentcore.alpha.AddMcpServerTargetOptions
Python	aws_cdk.aws_bedrock_agentcore_alpha.AddMcpServerTargetOptions
TypeScript (source)	@aws-cdk/aws-bedrock-agentcore-alpha » AddMcpServerTargetOptions

Options for adding an MCP Server target to a gateway.

Example

const gateway = new agentcore.Gateway(this, "MyGateway", {
  gatewayName: "my-gateway",
});

const oauth = agentcore.OAuth2CredentialProvider.usingGithub(this, "GhOAuth", {
  oAuth2CredentialProviderName: "github-oauth",
  clientId: "your-client-id",
  clientSecret: cdk.SecretValue.unsafePlainText("your-client-secret"),
});

gateway.addMcpServerTarget("Mcp", {
  gatewayTargetName: "mcp-server",
  description: "MCP with GitHub OAuth",
  endpoint: "https://my-mcp-server.example.com",
  credentialProviderConfigurations: [
    agentcore.GatewayCredentialProvider.fromOauthIdentity(oauth, {
      scopes: ["read:user"],
    }),
  ],
});

Properties

Name	Type	Description
credentialProviderConfigurations🔹	ICredentialProviderConfig[]	Credential providers for authentication.
endpoint🔹	string	The HTTPS endpoint URL of the MCP server.
description?🔹	string	Optional description for the gateway target.
gatewayTargetName?🔹	string	The name of the gateway target Valid characters are a-z, A-Z, 0-9, _ (underscore) and - (hyphen).

---

credentialProviderConfigurations🔹

Type: ICredentialProviderConfig[]

Credential providers for authentication.

MCP servers require explicit authentication configuration. OAuth2 is strongly recommended over NoAuth.

---

endpoint🔹

Type: string

The HTTPS endpoint URL of the MCP server.

The endpoint must:

• Use HTTPS protocol
• Be properly URL-encoded
• Point to an MCP server that implements tool capabilities

---

description?🔹

Type: string (optional, default: No description)

Optional description for the gateway target.

---

gatewayTargetName?🔹

Type: string (optional, default: auto generate)

The name of the gateway target Valid characters are a-z, A-Z, 0-9, _ (underscore) and - (hyphen).