# Foxmayn Frappe CLI : ligne de commande et serveur MCP pour Frappe

> Une ligne de commande, un serveur MCP et une application de bureau pour les sites Frappe et ERPNext. Travaillez sur les documents depuis le terminal, ou laissez un assistant IA le faire.

Updated: 2026-10-27

- **Détails:** Foxmayn Frappe CLI (ffc)
- **Dernière version:** v1.21.1 (2026-10-25) https://github.com/nasroykh/foxmayn_frappe_cli/releases/tag/v1.21.1
- **Licence:** MIT
- **Langage:** Go
- **Liens:** https://github.com/nasroykh/foxmayn_frappe_cli

Projet non officiel. Sans lien avec Frappe Technologies.

## Ce que fait l'outil

`ffc` dialogue avec un site Frappe ou ERPNext via son API REST. Vous pouvez lire, créer, modifier, valider et annuler des documents depuis le terminal. Il s'adresse aux administrateurs, aux développeurs et à toute personne qui veut qu'un assistant IA comme Claude travaille sur son ERP.

Il agit toujours avec les permissions de l'utilisateur Frappe sous lequel vous vous connectez. Il ne peut pas faire plus que cet utilisateur dans Desk.

## Fonctionnalités

- **Documents :** `list-docs`, `get-doc`, `create-doc`, `update-doc`, `submit-doc`, `cancel-doc`, `bulk-update`.
- **Workflows :** `workflow apply`.
- **Recherche et impression :** `search`, `pdf`.
- **Fichiers :** `files upload`, `files download`.
- **Configuration :** `init` crée un profil de site, `whoami` indique sous quel utilisateur vous êtes connecté.
- **Options de sécurité :** `--dry-run` montre ce qui serait modifié. `--read-only` bloque toute écriture.
- **Serveur MCP :** `ffc mcp` lance un serveur Model Context Protocol pour les assistants IA. Il est aussi livré sous forme de bundle `.mcpb` et référencé dans le registre MCP sous le nom `io.github.nasroykh/ffc`. Utilisez `ffc mcp install` et `ffc mcp uninstall` pour configurer les clients pris en charge.
- **Application de bureau :** `ffc desktop install` et `ffc desktop status`. L'application de bureau fonctionne sous Windows et macOS. C'est une préversion bêta (0.11.x) et n'est pas signée.
- **Mises à jour :** `ffc update`.

## Installation

Linux et macOS :

```bash
curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.sh | sh
```

Windows PowerShell :

```powershell
irm https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.ps1 | iex
```

Homebrew :

```bash
brew install nasroykh/tap/ffc
```

Scoop :

```bash
scoop bucket add foxmayn https://github.com/nasroykh/scoop-bucket
scoop install ffc
```

Connectez ensuite votre premier site :

```bash
ffc init
ffc whoami
```

Les versions couvrent Linux, macOS (amd64 et arm64) et Windows (amd64 et arm64). Les sommes de contrôle sont signées en Ed25519, et le script d'installation les vérifie lorsque OpenSSL 3 est présent. La CI exécute `go vet` et `go test` avant chaque version, et le workflow de publication produit une attestation de provenance.

## Pourquoi nous l'avons construit

Nous travaillons chaque jour sur des sites Frappe. Cliquer dans Desk pour vérifier un enregistrement ou en modifier cinquante est lent. Une ligne de commande scriptable est plus rapide, et elle s'intègre aux scripts shell et aux tâches de CI.

Les assistants IA rendent cela plus utile, et aussi plus risqué. Le serveur MCP leur donne un vrai accès à un site, mais seulement avec les permissions d'un utilisateur, et le mode `--read-only` permet de commencer par la lecture seule. Nous utilisons `ffc` dans notre propre [travail d'IA sur ERPNext](https://foxmayn.com/fr/services).

L'outil est écrit en Go et publié sous licence MIT. Retrouvez le code source, les versions et les tickets sur [GitHub](https://github.com/nasroykh/foxmayn_frappe_cli). Outils associés : [Foxmayn Frappe Manager](https://foxmayn.com/fr/open-source/ffm) pour les benches et [Foxmayn Frappe Types](https://foxmayn.com/fr/open-source/fft) pour TypeScript.

---
Contact: foxmayn@protonmail.com · https://foxmayn.com/fr#contact
HTML: https://foxmayn.com/fr/open-source/ffc · [en](https://foxmayn.com/en/open-source/ffc.md) · [ar](https://foxmayn.com/ar/open-source/ffc.md)