Amazon Q Developer

Manual Configuration

Option 1: stdio (Recommended)

1. Install Amazon Q Developer in VS Code, or use the standalone app
2. Edit ~/.aws/amazonq/mcp.json (create the file if it doesn't exist)
3. Add the following configuration:

{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}

4. Save and restart your editor

Option 2: HTTP with API Key

If stdio doesn't work, you can connect via HTTP using an API Key:

1. Open Macuse Settings → Connections, click +, enter "Amazon Q" as the name, and click Create
2. Copy the API key immediately (it is only shown once)
3. Add the following to your ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "macuse": {
      "url": "http://127.0.0.1:35729/mcp",
      "headers": {
        "Authorization": "Bearer <your_api_key>"
      }
    }
  }
}

4. Save and restart your editor

See the API Keys page for more details.

Verifying the Connection

1. Open VS Code with Amazon Q Developer installed
2. Start a new chat and ask the AI to "list available Macuse tools"
3. If configured correctly, the AI will show the available toolboxes