From 9c0a098de6f7b21f10ac4e6834968032f83c59a2 Mon Sep 17 00:00:00 2001 From: "codegen-sh[bot]" <131295404+codegen-sh[bot]@users.noreply.github.com> Date: Thu, 18 Sep 2025 17:12:17 +0000 Subject: [PATCH] docs: add MCP server naming constraints - Document required naming pattern: ^[a-zA-Z0-9_-]{1,128}$ - Specify allowed characters: alphanumeric, hyphens, underscores only - Add warning about dots and special characters causing failures - Include example of correct naming convention Fixes issue where MCP servers with dots in names (like awslabs.aws-documentation-mcp-server) cause malformed tool calls due to Anthropic's regex validation. Co-authored-by: Edo Pujol --- docs/integrations/mcp-servers.mdx | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/integrations/mcp-servers.mdx b/docs/integrations/mcp-servers.mdx index f6406c7ef..1ba8f6cf8 100644 --- a/docs/integrations/mcp-servers.mdx +++ b/docs/integrations/mcp-servers.mdx @@ -57,6 +57,18 @@ MCP servers are configured per repository using a JSON configuration file. The c - **Access controls** - Specify permissions and security settings - **Environment variables** - Configure server-specific settings and secrets +### Server Naming Requirements + +MCP server names must follow strict naming conventions to ensure compatibility: + +- **Allowed characters**: Only alphanumeric characters (a-z, A-Z, 0-9), hyphens (-), and underscores (_) +- **Length limit**: Maximum 128 characters +- **Pattern**: Must match the regex `^[a-zA-Z0-9_-]{1,128}$` + + + Server names containing dots (.), spaces, or other special characters will cause connection failures. For example, `awslabs.aws-documentation-mcp-server` should be renamed to `awslabs-aws-documentation-mcp-server`. + + ## Permissions The Codegen MCP integration requires the following permissions: