MCP ERP Client

Serveur MCP (Model Context Protocol) pour interagir avec l'ERP via l'API REST.

Securite

Ce MCP ne contient aucun secret dans le code source. Toutes les donnees sensibles sont dans le fichier .env (exclu du repo via .gitignore).

Double verrou d'authentification :

1. Cle API (X-API-Key) — sans cette cle, l'API rejette toutes les requetes
2. Compte Microsoft (Azure AD Device Code Flow) — l'utilisateur doit s'authentifier avec un compte Microsoft autorise dans le tenant Azure AD

Meme si quelqu'un clone ce repo, il ne peut rien faire sans :

• La cle API (ERP_API_KEY)
• Un compte Microsoft dans le bon tenant Azure AD (AZURE_AD_TENANT_ID)
• L'ID de l'application Azure AD (AZURE_AD_CLIENT_ID)

Installation

npm install
cp .env.example .env
# Remplir le .env avec les vraies valeurs
npm run build

Configuration (.env)

ERP_API_URL=https://votre-api.vercel.app
ERP_API_KEY=votre-cle-api
AZURE_AD_TENANT_ID=votre-tenant-id
AZURE_AD_CLIENT_ID=votre-client-id

Utilisation avec Claude Desktop / Claude Code

Ajouter dans la configuration MCP :

{
  "mcpServers": {
    "erp": {
      "command": "node",
      "args": ["/chemin/vers/mcp/dist/index.js"]
    }
  }
}

Outils disponibles (14)

Authentification (2)

Clients (4)

Devis (6)

Templates (2)

Architecture

mcp/
  src/
    index.ts          # Point d'entree (transport stdio)
    api-client.ts     # Client HTTP (X-API-Key + Bearer Microsoft)
    schemas.ts        # Validation Zod des inputs
    auth/
      device-code.ts  # Microsoft Device Code Flow
      refresh.ts      # Auto-refresh du token
      token-store.ts  # Stockage local (~/.erp-mcp/auth.json)
    tools/
      auth-tools.ts   # erp_login, erp_status
      clients.ts      # CRUD clients
      devis.ts        # CRUD devis + items
      templates.ts    # Lecture templates

Aucune connexion directe a la base de donnees. Tout passe par l'API REST.