Skip to main content

​
Prerequisites

  1. Install Docker: Required to run the Chkk-Upgrade-Context-MCP Server.
  2. Install Claude Code: Required to begin generating environment-aware pull requests.
  3. A Claude.ai (recommended) or Anthropic Console account
Agent Responses on this page are illustrative. Exact phrasing from your AI model may vary depending on the model, settings, and repository context.
For the best experience, it is recommended to use the claude-4-sonnet model with the Chkk-Upgrade-Context-MCP Server.
1

Clone the Sample Chkk IaC repo

Run the following command to clone the sample Chkk IaC repo:
2

Retrieve your Chkk Access Token

  1. In the Chkk Dashboard, expand Configure on the left menu and click Settings.
  2. Select the Tokens tab. Here you’ll see a list of all your active tokens (if any), along with options to create new ones or revoke existing ones.
  3. Click on the clipboard icon next to a token to copy it. Tokens Tab
3

Install in Claude Code

Install the Chkk-Upgrade-Context-MCP using the Claude Code CLI:
Replace <CHKK_TOKEN> with your Chkk Access Token.
4

Verify Chkk-Upgrade-Context-MCP Server is installed

Verify via CLI that the server is registered:
The command should return server details indicating it is installed and enabled.Claude Code Chkk MCP Server
5

Open the project in Claude Code

From inside the upgrade-playground directory, start Claude Code.
Open Claude Code
6

Load the Chkk Upgrade Agent

Open a chat in Claude Code and send:
Your opening prompt is flexible, but it must explicitly instruct the assistant to fetch “addon-upgrade-agent” from Chkk MCP.
Agent Response:Claude Code Chkk MCP Server start
7

Provide the upgrade ID of the Example Upgrade Plan

Paste your upgrade ID (from your instantiated Project Upgrade Plan), for example:
Agent Response:Claude Code Chkk MCP Server upgrade
8

Let the assistant apply changes to your IaC

The assistant will fetch Upgrade Context, stage artifacts in a local Scratchpad (.chkk/scratchpad/upgrade-agent/ in the current working directory), apply targeted edits (Chart.yaml, values.yaml, minimal templates), and summarize the changes it has made.Agent Response:Claude Code Apply Changes
To ensure your model is not overwhelmed by the task scope, any modifications are processed in batches of 5 files at a time.
9

Review the changes

You can now review the changes made within each file, which you would have otherwise would have had to do manually.Agent Response:Claude Code Review Changes
Learn more in the Upgrade Agent guide.

​
Next steps

  • Add your own upgrade plans in Chkk and repeat the flow
  • Enable auto-confirm in trusted repos for zero-click edits