# cegid-mcp

Serveur [MCP](https://modelcontextprotocol.io) open source pour les API **Cegid**, maintenu par [Nijal AI](https://github.com/nijal-ai).

Objectif : exposer les ressources Cegid (comptabilité, tiers, pièces, RH selon le produit ciblé) sous forme d'outils MCP consommables par un agent LLM.

> ⚠️ Projet en amorçage — le squelette est en place, les outils métier restent à implémenter.

## Stack

- Python ≥ 3.11
- [`mcp`](https://pypi.org/project/mcp/) (FastMCP), `httpx`, `pydantic-settings`
- Transport : stdio (HTTP/SSE à évaluer)

## Démarrage

```bash
uv sync --extra dev
cp .env.example .env   # renseigner les credentials
uv run cegid-mcp
```

Test rapide avec l'inspecteur MCP :

```bash
npx @modelcontextprotocol/inspector uv run cegid-mcp
```

## Configuration

Toutes les variables sont préfixées `CEGID_` (voir `.env.example`). Auth : OAuth2 `client_credentials` sur le endpoint `/token`, puis `Authorization: Bearer <token>`. Certains produits Cegid exigent en plus une clé de souscription APIM.

Doc de référence : https://developers.cegid.com

## Structure

```
src/cegid_mcp/
  config.py   # settings via env
  client.py   # client HTTP + OAuth2  (à implémenter)
  server.py   # déclaration des outils MCP
tests/
```

## Roadmap (à affiner)

- [ ] Auth OAuth2 : token, cache, refresh, gestion des erreurs
- [ ] Choisir le périmètre v0 (quel produit Cegid : Expert / XRP Flex / Loop / Retail ?)
- [ ] 3-4 outils en lecture seule sur ce périmètre
- [ ] Outils en écriture + garde-fous (confirmation, dry-run)


## Licence

MIT — voir [LICENSE](LICENSE).