# leadtech-bmad-mcp — Quickstart dev local

Objectif : installer et verifier rapidement le serveur MCP sur une machine vierge ou un nouvel environnement local.

## Prerequis

- Python `>= 3.10`
- acces au repo Lead_tech
- shell POSIX

## Installation

```bash
cd /srv/helpers/_Assistant_Lead_Tech/mcp/leadtech_bmad_mcp
python3.10 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
```

## Verification minimale

```bash
source .venv/bin/activate
pytest tests -q
leadtech-bmad-build-index
```

Attendus :

- tous les tests passent
- un fichier `.leadtech_mcp_index.json` est genere a la racine de `LEADTECH_ROOT`

## Lancement local

```bash
source .venv/bin/activate
export LEADTECH_ROOT=/srv/helpers/_Assistant_Lead_Tech
leadtech-bmad-mcp
```

En dev local hors `/srv/helpers`, `LEADTECH_ROOT` peut pointer vers le checkout courant.

## Variables utiles

- `LEADTECH_ROOT` : racine de la base Lead_tech
- `LEADTECH_GATES_CONFIG` : chemin alternatif vers `config/gates.yaml`
- `LEADTECH_MCP_ALLOW_WRITE=1` : active les writes controles (`95_a_capitaliser.md`, memoire projet)

## Depannage

- `ModuleNotFoundError: yaml` : relancer `pip install -e ".[dev]"` pour installer `PyYAML`
- `command not found: pytest` : verifier que `.venv` est active
- index ecrit au mauvais endroit : verifier `LEADTECH_ROOT`
