Amazon Q Developer Integration Guide

This guide explains how to integrate the Atlantis MCP Server with Amazon Q Developer, enabling AI-assisted development with access to Atlantis templates and documentation.

Prerequisites

Configuration Steps

Option 1: VS Code Extension

1. Install Amazon Q Extension

  1. Open VS Code
  2. Go to Extensions (Cmd+Shift+X or Ctrl+Shift+X)
  3. Search for “Amazon Q”
  4. Click “Install”

2. Configure MCP Integration

To add the Atlantis MCP (Model Context Protocol) server to Amazon Q Developer, you configure it in a JSON file depending on your scope:

The format looks like this:

{
  "mcpServers": {
    "atlantis": {
      "url": "https://mcp.atlantis.63klabs.net/mcp/v1",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Auto-Approve Tools

Configure which tools run without confirmation:

{
  "mcpServers": {
    "atlantis": {
      "url": "https://mcp.atlantis.63klabs.net/mcp/v1",
      "disabled": false,
      "autoApprove": [
        "validate_naming",
        "list_categories",
        "list_templates",
        "get_template",
        "list_template_versions",
        "list_tools",
        "list_starters",
        "get_starter_info",
        "search_documentation",
        "check_template_updates",
        "get_template_chunk"
      ]
    }
  }
}

3. Authenticate with Amazon Q

  1. Click Amazon Q icon in sidebar
  2. Sign in with AWS Builder ID or IAM Identity Center
  3. Grant necessary permissions

4. Verify Connection

In Amazon Q chat:

Show me available Atlantis templates

Option 2: JetBrains IDEs

1. Install Amazon Q Plugin

  1. Open Settings/Preferences
  2. Go to Plugins
  3. Search for “Amazon Q”
  4. Click “Install” and restart IDE

2. Configure MCP Integration

Create or edit .idea/amazonq.xml:

<component name="AmazonQSettings">
  <option name="mcpServers">
    <map>
      <entry key="atlantis">
        <value>
          <McpServer>
            <option name="url" value="https://mcp.atlantis.63klabs.net/mcp/v1" />
            <option name="name" value="Atlantis" />
            <option name="enabled" value="true" />
          </McpServer>
        </value>
      </entry>
    </map>
  </option>
</component>

3. Authenticate and Verify

Follow same steps as VS Code above.

Adding Your API Key

Register for a free account to get an API key with higher rate limits. After registration, copy your unique API key and add it to the configuration.

VS Code / Global Config

Add the headers field to your .amazonq/mcp.json:

{
  "mcpServers": {
    "atlantis": {
      "url": "https://mcp.atlantis.63klabs.net/mcp/v1",
      "headers": {
        "x-api-key": "atl_your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

JetBrains

Add the API key header to your .idea/amazonq.xml:

<component name="AmazonQSettings">
  <option name="mcpServers">
    <map>
      <entry key="atlantis">
        <value>
          <McpServer>
            <option name="url" value="https://mcp.atlantis.63klabs.net/mcp/v1" />
            <option name="name" value="Atlantis" />
            <option name="enabled" value="true" />
            <option name="headers">
              <map>
                <entry key="x-api-key" value="atl_your_api_key_here" />
              </map>
            </option>
          </McpServer>
        </value>
      </entry>
    </map>
  </option>
</component>

If you need to regenerate your key, visit your profile page.

Next Steps

Additional Resources