MCP — guide de configuration et support

Numezis expose un serveur MCP distant qui permet à Claude, ChatGPT ou tout client compatible MCP d'exécuter des opérations métier gouvernées sur la comptabilité, les ventes, les achats, les RH, l'inventaire, le CRM et les flux documentaires.

Vue d'ensemble

Numezis expose un serveur MCP distant à l'adresse https://www.numezis.com/mcp via HTTP streamable et JSON-RPC 2.0. Le connecteur permet à Claude d'exécuter des opérations métier gouvernées sur la comptabilité, les ventes, les achats, les RH, l'inventaire, le CRM et les documents.

Prérequis

• Abonnement Numezis actif avec accès au portail Company ou Partner.
• Compte Claude.ai avec accès aux connecteurs.
• Utilisateur Numezis authentifié, avec permissions sur les modules ciblés.
• Modules activés dans les paramètres Numezis (les outils sont gouvernés par capacités).

Connexion dans Claude.ai

1. Ouvrez Claude.ai, allez dans Connectors et ajoutez un serveur MCP distant personnalisé.
2. Renseignez l'URL serveur : https://www.numezis.com/mcp.
3. Choisissez l'authentification OAuth 2.0 (Dynamic Client Registration supporté).
4. Connectez-vous à Numezis et validez les autorisations demandées.
5. Après autorisation, lancez une requête tools/list pour vérifier les modules visibles.

Exemples de code

Utilisez ces exemples prêts à copier pour vous connecter depuis Claude, ChatGPT ou un client HTTP direct.

Connecteur personnalisé Claude / Cowork

Name: Numezis
Server URL: https://www.numezis.com/mcp
Authentication: OAuth
OAuth registration: Dynamic Client Registration (DCR)
Default scopes:
  mcp.tools.read
  mcp.tools.execute
  mcp.tools.write
Base parameters: leave empty

# Fallback uniquement si le client ne supporte pas le DCR :
Client ID: numezis-mcp-connect
Client secret: leave empty

Application MCP personnalisée ChatGPT

Name: Numezis
Server URL: https://www.numezis.com/mcp
Authentication: OAuth
OAuth registration: Dynamic Client Registration (DCR)
Default scopes:
  mcp.tools.read
  mcp.tools.execute
  mcp.tools.write
Base parameters: leave empty

# Si le DCR n'est pas disponible, utilisez le client statique de secours :
Client ID: numezis-mcp-connect
Client secret: leave empty

HTTP JSON-RPC (comptes de service)

const response = await fetch("https://www.numezis.com/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json, text/event-stream",
    "Authorization": "Bearer " + process.env.NUMEZIS_SERVICE_ACCOUNT_KEY,
    "X-Portal": "company",
    "MCP-Protocol-Version": "2025-03-26",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: "tools-list-1",
    method: "tools/list",
    params: {},
  }),
});

const payload = await response.json();

Groupes de modules disponibles

La disponibilité des outils dépend des modules activés et des permissions utilisateur. Groupes principaux :

• Finance — Comptabilité, ventes, achats, rapprochements, TVA et opérations ledger.
• Ressources humaines — Workflows RH : employés, contrats, absences et opérations liées à la paie.
• Opérations — Inventaire, opérations projet et gestion des tâches.
• Client — CRM, contacts et commentaires collaboratifs liés aux enregistrements métier.
• Documents et données — Collecte documentaire, classification et flux d'import gouvernés.
• Intégrations — Connecteurs Google, Microsoft et intelligence/enrichment selon activation.
• Plateforme — Approbations, configuration de modules et utilitaires cœur de plateforme.

Sécurité et gestion des données

• Le transport utilise HTTPS/TLS avec metadata OAuth Protected Resource.
• Les accès sont scoppés côté serveur via AccessMode, contexte portail et permissions.
• Les mutations critiques peuvent nécessiter une approbation explicite avant exécution.
• Des logs et audits opérationnels peuvent être conservés selon la politique plateforme ; voir la Politique de confidentialité et la DPA.

FAQ

Ce connecteur est-il en lecture seule ?

Non. Il supporte la lecture et l'écriture, avec des garde-fous de gouvernance et une approbation pour les actions sensibles.

Puis-je avoir une URL MCP différente par utilisateur ?

Non. Numezis expose actuellement une URL distante universelle : https://www.numezis.com/mcp.

Quel transport est supporté ?

HTTP streamable est pris en charge. Les endpoints SSE hérités sont dépréciés.

Comment les permissions sont-elles appliquées ?

Les permissions sont contrôlées sur chaque requête via le rôle utilisateur, les modules activés et l'AccessMode scoppé par portail.

Les actions critiques demandent-elles une confirmation ?

Oui. Selon la politique et le niveau de sûreté du manifeste d'outil, une étape d'approbation peut être requise.

Où obtenir de l'aide ?

Contactez le support Numezis et consultez la Politique de confidentialité et la DPA dans la section Trust.

Support et liens légaux

Pour la prise en main ou un incident, contactez le support Numezis. La Politique de confidentialité et la DPA sont publiques dans la section Trust.