> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chkk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code + Chkk in 5 minutes

> Use Chkk to provide precise, environment-aware context to plan safe software upgrades and create pull requests with updated configuration files and manifests.

## Prerequisites

1. [Install Docker](https://docs.docker.com/get-docker/): Required to run the Chkk-Upgrade-Context-MCP Server.

2. [Install Claude Code](/resources/installation-guides/claude-code): Required to begin generating environment-aware pull requests.

3. A [Claude.ai](https://claude.ai/) (recommended) or [Anthropic Console](https://console.anthropic.com/) account

<Info>
  Agent Responses on this page are illustrative. Exact phrasing from your AI
  model may vary depending on the model, settings, and repository context.
</Info>

<Note>
  For the best experience, it is recommended to use the **claude-4-sonnet** model with the Chkk-Upgrade-Context-MCP Server.
</Note>

<Steps>
  <Step title="Clone the Sample Chkk IaC repo">
    Run the following command to clone the sample Chkk IaC repo:

    ```bash theme={"dark"}
    git clone git@github.com:chkk-io/upgrade-playground.git && \
    cd upgrade-playground
    ```
  </Step>

  <Step title="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.

           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/chkk-access-token.gif?s=f0f979e1e97c8531d96868a9db175c25" alt="Tokens Tab" width="1920" height="1080" data-path="images/features/chkk-access-token.gif" />
  </Step>

  <Step title="Install in Claude Code">
    Install the `Chkk-Upgrade-Context-MCP` using the Claude Code CLI:

    ```bash theme={"dark"}
    claude mcp add Chkk-Upgrade-Context-MCP --env CHKK_ACCESS_TOKEN="<CHKK_TOKEN>"  -- docker run -i --rm -e CHKK_ACCESS_TOKEN public.ecr.aws/chkk/chkk-mcp-upgrade-context:latest
    ```

    Replace `<CHKK_TOKEN>` with your Chkk Access Token.
  </Step>

  <Step title="Verify Chkk-Upgrade-Context-MCP Server is installed">
    Verify via CLI that the server is registered:

    ```bash theme={"dark"}
    claude mcp get Chkk-Upgrade-Context-MCP
    ```

    The command should return server details indicating it is installed and enabled.

    <img src="https://mintcdn.com/chkk/jVz5fXAMivd3Hr6E/images/ai/claude-code-mcp-setup.png?fit=max&auto=format&n=jVz5fXAMivd3Hr6E&q=85&s=8c9d625d12d42a5fdc2db59701a14677" alt="Claude Code Chkk MCP Server" width="3010" height="414" data-path="images/ai/claude-code-mcp-setup.png" />
  </Step>

  <Steps title="Retrieve the Upgrade ID">
    1. In the **left-hand column** of the **Chkk Dashboard**, expand **Upgrade Copilot**.

    2. Under **Upgrade Plans** select **Add-on & App Services**.

           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/navigation/nav-project-upgrade-plans.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=5f7a62b414f23a14f92997ef9c855916" alt="Navigate to Project Upgrade Plans" width="3516" height="2166" data-path="images/navigation/nav-project-upgrade-plans.png" />

    3. On the **Middle Right** corner of the page, enable the **Show Example Data** toggle, as shown in the image below.

    4. This will switch the view to only show example data and displays a confirmation banner.

           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/enable-show-example-data-toggle.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=014dc909a160122f2b2c08ea0bdc140e" alt="Enable Example Data" width="3510" height="2160" data-path="images/features/enable-show-example-data-toggle.png" />

    5. In the table below, you will see a list of Projects **Example Upgrade Plans**.

    6. Select any Upgrade Plan from the table that has the **AI Context Generated** badge, as shown in the image below.

    <Info>
      The **AI Context Generated** badge indicates that these Upgrade Plans are supported by the **Chkk-Upgrade-Context-MCP Server**.
    </Info>

    <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/highlight-example-project-plan-with-ai-context-generated.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=70657d45165b34cf2d4146ab9eebdf7c" alt="Example Project Upgrade Plan with AI Context Generated Badge" width="3516" height="2110" data-path="images/features/highlight-example-project-plan-with-ai-context-generated.png" />

    7. At the top of the page, under the name of the Upgrade Plan, you will see the **Upgrade ID**.
    8. Click the **clipboard** icon to copy the Upgrade ID to your clipboard.

           <img src="https://mintcdn.com/chkk/ErQAF5e5P7IkmW9z/images/features/step-copy-project-upgrade-plan-id.png?fit=max&auto=format&n=ErQAF5e5P7IkmW9z&q=85&s=785f980f08904d1dd8cce4e4b6eb4bde" alt="Upgrade ID" width="3516" height="2160" data-path="images/features/step-copy-project-upgrade-plan-id.png" />
  </Steps>

  <Step title="Open the project in Claude Code">
    From inside the `upgrade-playground` directory, start Claude Code.

    ```bash theme={"dark"}
    claude
    ```

    <img src="https://mintcdn.com/chkk/jVz5fXAMivd3Hr6E/images/ai/claude-code-open.png?fit=max&auto=format&n=jVz5fXAMivd3Hr6E&q=85&s=9952355b570985d680ddae6e88a0bc74" alt="Open Claude Code" width="3024" height="1286" data-path="images/ai/claude-code-open.png" />
  </Step>

  <Step title="Load the Chkk Upgrade Agent">
    Open a chat in Claude Code and send:

    <CodeBlock wrap language="text">
      You're in a K8s repo. Fetch "addon-upgrade-agent" from Chkk MCP and upgrade the package listed in the upgrade plan. Start by asking for the upgrade ID.
    </CodeBlock>

    <Info>
      Your opening prompt is flexible, but it **must** explicitly instruct the assistant to **fetch "addon-upgrade-agent" from Chkk MCP**.
    </Info>

    **Agent Response:**

    <img src="https://mintcdn.com/chkk/jVz5fXAMivd3Hr6E/images/ai/claude-code-init-prompt.png?fit=max&auto=format&n=jVz5fXAMivd3Hr6E&q=85&s=dbd03222df1be9e4ec36ab8917f8c04a" alt="Claude Code Chkk MCP Server start" width="3024" height="394" data-path="images/ai/claude-code-init-prompt.png" />
  </Step>

  <Step title="Provide the upgrade ID of the Example Upgrade Plan">
    Paste your **upgrade ID** (from your instantiated [Project Upgrade Plan](/resources/glossary#project-upgrade-plan)), for example:

    <CodeBlock copy={false}>
      upgr\_ea53db65-3d8d-4744-b8b7-92e3c7552932
    </CodeBlock>

    **Agent Response:**

    <img src="https://mintcdn.com/chkk/jVz5fXAMivd3Hr6E/images/ai/claude-code-upgrade-id.png?fit=max&auto=format&n=jVz5fXAMivd3Hr6E&q=85&s=65aa6381b36b760d934c2c5a53c93a12" alt="Claude Code Chkk MCP Server upgrade" width="2936" height="826" data-path="images/ai/claude-code-upgrade-id.png" />
  </Step>

  <Step title="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:**

    <img src="https://mintcdn.com/chkk/jVz5fXAMivd3Hr6E/images/ai/claude-code-apply-changes.png?fit=max&auto=format&n=jVz5fXAMivd3Hr6E&q=85&s=94f07cabd7577601fc5d685971b7d6d5" alt="Claude Code Apply Changes" width="2220" height="1538" data-path="images/ai/claude-code-apply-changes.png" />

    <Info>
      To ensure your model is not overwhelmed by the task scope, any modifications are processed in batches of 5 files at a time.
    </Info>
  </Step>

  <Step title="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:**

    <img src="https://mintcdn.com/chkk/jVz5fXAMivd3Hr6E/images/ai/claude-code-review-changes.png?fit=max&auto=format&n=jVz5fXAMivd3Hr6E&q=85&s=b691454b2d07bcf64948d4607524e28d" alt="Claude Code Review Changes" width="3014" height="1286" data-path="images/ai/claude-code-review-changes.png" />
  </Step>
</Steps>

<Info>
  Learn more in the [Upgrade Agent guide](/ai/upgrade-agent).
</Info>

## Next steps

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