From 30e5756fd5be0ba12dca72c2b8eeb89a9a106585 Mon Sep 17 00:00:00 2001 From: Rohan Gupta <52221549+thisrohangupta@users.noreply.github.com> Date: Wed, 17 Sep 2025 15:36:47 -0700 Subject: [PATCH 1/4] Document Amazon Q Developer CLI integration --- .../harness-aida/harness-ai-amazon-q.md | 116 ++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 docs/platform/harness-aida/harness-ai-amazon-q.md diff --git a/docs/platform/harness-aida/harness-ai-amazon-q.md b/docs/platform/harness-aida/harness-ai-amazon-q.md new file mode 100644 index 00000000000..d1efd424115 --- /dev/null +++ b/docs/platform/harness-aida/harness-ai-amazon-q.md @@ -0,0 +1,116 @@ +--- +title: Harness AI x Amazon Q Developer +description: Leverage Amazon Q CLI with Harness AI MCP Server to unleash your developer workflows +sidebar_position: 12 + +# Amazon Q Developer CLI Integration with Harness MCP Server + +## What is Amazon Q Developer + +Amazon Q Developer is a generative AI-powered assistant by AWS built on Amazon Bedrock. It helps with understanding, building, extending, and operating AWS applications. You can use it in various environments including the CLI (command line), IDEs, AWS Console, chat applications, etc. It supports features like conversational assistance, code suggestions, inline completions, and translating natural language into shell commands.  + +In the CLI context, Amazon Q Developer enhances your terminal experience by: + • providing command autocompletion for many common CLIs (like git, npm, docker, aws)  + • enabling “chat mode” where you can ask questions in natural language from the terminal and get responses that help you build, debug, or operate your code or infrastructure  + • translating plain language instructions into executable shell commands  + • understanding context (files in the project, existing settings, AWS resource state) so that suggestions and completions are more relevant  + +There are pricing tiers including a Free Tier; Amazon Q Developer provides features in its Free and Pro tiers.  + + + +## Prerequisites + +- Amazon Q Developer CLI installed and configured with AWS credentials +- Harness account with an API Key (Org ID and Project ID optional) +- Go installed to build the Harness MCP Server +- Docker Installed to run the Harness MCP + + + +## Step 1: Build the Harness MCP Server + +Clone the MCP server repository +```sh +git clone https://github.com/harness/mcp-server.git +cd mcp-server +``` + +Build the binary if building locally + +```sh +go build -o cmd/harness-mcp-server/harness-mcp-server ./cmd/harness-mcp-server + +# Make executable if needed +chmod +x harness-mcp-server +``` + + +⸻ + +## Step 2: Run the Harness MCP Server + +```sh +HARNESS_API_KEY= \ +HARNESS_DEFAULT_ORG_ID= \ +HARNESS_DEFAULT_PROJECT_ID= \ +./cmd/harness-mcp-server/harness-mcp-server stdio +``` + +You can also set `HARNESS_BASE_URL` if using a custom Harness domain. + + +## Step 3: Configure Amazon Q Developer CLI + +Edit or create the MCP configuration file at: `~/.aws/amazonq/mcp.json` + +```json +{ + "mcpServers": { + "harness": { + "command": "/path/to/harness-mcp-server", + "args": ["stdio"], + "env": { + "HARNESS_API_KEY": "", + "HARNESS_DEFAULT_ORG_ID": "", + "HARNESS_DEFAULT_PROJECT_ID": "", + "HARNESS_BASE_URL": "" + } + } + } +} +``` + + + +## Step 4: Query Harness with Amazon Q + +Start a session with: + +```sh +q chat +``` + +Then interact with Harness using natural language prompts. + + +## Sample Prompts + +- List all my pipelines in Harness +- What repositories are linked to my account? +- Show me all artifacts in my project +- Find feature flags created in my org +- Summarize the last 5 deployments in project XYZ +- Which connectors are configured in Harness? + + +## Troubleshooting + +- If Amazon Q cannot connect to Harness MCP, check the command path, arguments, and environment variables in mcp.json. +- If you see credential errors, regenerate the API key in Harness. +- If no resources are returned, confirm that Org ID, Project ID, or Base URL are set correctly. +- For performance or latency issues, ensure the MCP server has sufficient resources and review its logs. + + + +If you like, I can also include a “Security & Governance Considerations” section about Amazon Q (e.g. permissions, IAM policies, data privacy) for the doc. From 2a59771a0a4d9f5a39ebdd2db55882a0169fbf52 Mon Sep 17 00:00:00 2001 From: Rohan Gupta <52221549+thisrohangupta@users.noreply.github.com> Date: Wed, 17 Sep 2025 15:38:44 -0700 Subject: [PATCH 2/4] Add metadata to Amazon Q Developer CLI document --- docs/platform/harness-aida/harness-ai-amazon-q.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/platform/harness-aida/harness-ai-amazon-q.md b/docs/platform/harness-aida/harness-ai-amazon-q.md index d1efd424115..7723023c4dd 100644 --- a/docs/platform/harness-aida/harness-ai-amazon-q.md +++ b/docs/platform/harness-aida/harness-ai-amazon-q.md @@ -2,6 +2,7 @@ title: Harness AI x Amazon Q Developer description: Leverage Amazon Q CLI with Harness AI MCP Server to unleash your developer workflows sidebar_position: 12 +--- # Amazon Q Developer CLI Integration with Harness MCP Server From 77e0da73920a09df0862e2d187b1e0812bfb7571 Mon Sep 17 00:00:00 2001 From: Rohan Gupta <52221549+thisrohangupta@users.noreply.github.com> Date: Wed, 17 Sep 2025 15:49:49 -0700 Subject: [PATCH 3/4] Suggest adding Security & Governance section --- docs/platform/harness-aida/harness-ai-amazon-q.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/platform/harness-aida/harness-ai-amazon-q.md b/docs/platform/harness-aida/harness-ai-amazon-q.md index 7723023c4dd..98f4782c8a1 100644 --- a/docs/platform/harness-aida/harness-ai-amazon-q.md +++ b/docs/platform/harness-aida/harness-ai-amazon-q.md @@ -112,6 +112,3 @@ Then interact with Harness using natural language prompts. - If no resources are returned, confirm that Org ID, Project ID, or Base URL are set correctly. - For performance or latency issues, ensure the MCP server has sufficient resources and review its logs. - - -If you like, I can also include a “Security & Governance Considerations” section about Amazon Q (e.g. permissions, IAM policies, data privacy) for the doc. From bef7ce6a2139d6d8472f0fcb88104532bac2c27e Mon Sep 17 00:00:00 2001 From: Rohan Gupta <52221549+thisrohangupta@users.noreply.github.com> Date: Wed, 17 Sep 2025 15:50:00 -0700 Subject: [PATCH 4/4] Update docs/platform/harness-aida/harness-ai-amazon-q.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/platform/harness-aida/harness-ai-amazon-q.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/platform/harness-aida/harness-ai-amazon-q.md b/docs/platform/harness-aida/harness-ai-amazon-q.md index 98f4782c8a1..e9ed9533cf7 100644 --- a/docs/platform/harness-aida/harness-ai-amazon-q.md +++ b/docs/platform/harness-aida/harness-ai-amazon-q.md @@ -8,15 +8,15 @@ sidebar_position: 12 ## What is Amazon Q Developer -Amazon Q Developer is a generative AI-powered assistant by AWS built on Amazon Bedrock. It helps with understanding, building, extending, and operating AWS applications. You can use it in various environments including the CLI (command line), IDEs, AWS Console, chat applications, etc. It supports features like conversational assistance, code suggestions, inline completions, and translating natural language into shell commands.  +Amazon Q Developer is a generative AI-powered assistant by AWS built on Amazon Bedrock. It helps with understanding, building, extending, and operating AWS applications. You can use it in various environments including the CLI (command line), IDEs, AWS Console, chat applications, etc. It supports features like conversational assistance, code suggestions, inline completions, and translating natural language into shell commands. In the CLI context, Amazon Q Developer enhances your terminal experience by: - • providing command autocompletion for many common CLIs (like git, npm, docker, aws)  - • enabling “chat mode” where you can ask questions in natural language from the terminal and get responses that help you build, debug, or operate your code or infrastructure  - • translating plain language instructions into executable shell commands  - • understanding context (files in the project, existing settings, AWS resource state) so that suggestions and completions are more relevant  + • providing command autocompletion for many common CLIs (like git, npm, docker, aws) + • enabling “chat mode” where you can ask questions in natural language from the terminal and get responses that help you build, debug, or operate your code or infrastructure + • translating plain language instructions into executable shell commands + • understanding context (files in the project, existing settings, AWS resource state) so that suggestions and completions are more relevant -There are pricing tiers including a Free Tier; Amazon Q Developer provides features in its Free and Pro tiers.  +There are pricing tiers including a Free Tier; Amazon Q Developer provides features in its Free and Pro tiers.