Docs/MCP Integration/Amazon Q

Amazon Q Developer Setup

Connect Nexlayer to Amazon Q Developer, AWS's AI coding assistant.

Recommended: npx Install

The fastest way to get started. Run this command in your terminal:

bash
npx @nexlayer/mcp-install

This will automatically detect Amazon Q and configure the Nexlayer MCP server.

Manual Installation

Amazon Q Developer supports two configuration levels: global (all projects) and workspace (current project only).

Global Configuration

Config file location:

~/.aws/amazonq/mcp.json
json
{
  "mcpServers": {
    "nexlayer-mcp": {
      "type": "sse",
      "url": "https://mcp.nexlayer.ai/api/mcp"
    }
  }
}

Workspace Configuration

Config file location (in your project):

.amazonq/mcp.json

Workspace configuration takes precedence over global configuration for servers with the same name.

Note:

Amazon Q uses "type" instead of "transport" for specifying the connection type.

IDE Integration

If you're using Amazon Q in an IDE (VS Code, JetBrains), the MCP configuration is stored in:

  • •Global scope: ~/.aws/amazonq/default.json
  • •Local scope: .amazonq/default.json in your project

Verify Installation

  1. 1

    Restart Amazon Q

    Close and reopen your IDE or terminal session

  2. 2

    Check MCP status (CLI)

    In Amazon Q CLI, use /mcp to see active servers

  3. 3

    Test a deployment

    Ask Amazon Q to deploy your project to Nexlayer

Troubleshooting

Config file not found?

Create the directory and file manually: mkdir -p ~/.aws/amazonq && touch ~/.aws/amazonq/mcp.json

Server not connecting?

Check for JSON syntax errors in your config file. Amazon Q will show warnings for invalid configuration.

Zed SetupLovable Setup