# cleancodemcp — Bootstrap Guide

This service is cleancodemcp, an MCP server: it hosts process definitions and a
knowledge base of atomic claims (status note/proven, bound to processes via
groups) that Claude Code agents consume at runtime over MCP.

This guide is the whole bootstrap procedure. Follow it in order.

## 1. Prerequisite

You need a project token issued by the owner of this deployment, for example:

```
<TOKEN>
```

Never use a real secret in place of `<TOKEN>` in this document — substitute
the token you were given.

## 2. Fetch the MCP client configuration

Fetch it with the token and save it to the workspace root:

```bash
curl -H "Authorization: Bearer <TOKEN>" https://cleancodemcp.com/bootstrap/mcp-config -o .mcp.json
```

## 3. Fetch the agent instructions

Fetch it with the same token and save it next to `.mcp.json`:

```bash
curl -H "Authorization: Bearer <TOKEN>" https://cleancodemcp.com/bootstrap/claude-md -o CLAUDE.md
```

## 4. Restart

Restart the agent session so the saved `.mcp.json` takes effect. Then follow
the fetched `CLAUDE.md`.

## 5. Lint canon fetch address

The fetched `CLAUDE.md` maintains a local `lint-canon/` directory from this
address, on the same token:

```
GET https://cleancodemcp.com/bootstrap/lint-canon
```

No action is needed here — this address is for reference only. The fetched
`CLAUDE.md` checks it against the local `lint-canon/MANIFEST.md` at the
start of every session and refreshes the directory itself when the served
version is newer.