Actions agent via MCP — guide de configuration et de support

Connectez Claude, ChatGPT ou tout client MCP aux actions agent gouvernées de Numezis via OAuth 2.0 et Streamable HTTP.

Numezis expose des actions agent gouvernées via un serveur MCP distant. Claude, ChatGPT ou tout client compatible MCP peut préparer ou exécuter des opérations métier en comptabilité, ventes, achats, RH, inventaire, CRM et flux documentaires sous permissions, approbations et piste d'audit Numezis.

Vue d'ensemble

L'endpoint MCP est disponible à l'adresse https://www.numezis.com/mcp via Streamable HTTP et JSON-RPC 2.0. Le connecteur permet à un client agent d'exécuter des actions métier gouvernées pendant que Numezis applique permissions, politique d'approbation et portée de portail.

Prérequis

Abonnement Numezis actif avec accès au portail Entreprise ou Partenaire.
Un compte Claude.ai avec l'accès aux connecteurs activé.
Un utilisateur Numezis authentifié avec les permissions des modules souhaités.
Modules d'entreprise activés dans les paramètres Numezis (les outils sont régis par les capabilities).

Connecter dans Claude.ai

Ouvrez Claude.ai, allez dans Connecteurs et ajoutez un serveur MCP distant personnalisé.
Définissez l'URL du serveur sur https://www.numezis.com/mcp.
Choisissez l'authentification OAuth 2.0 (la Dynamic Client Registration est prise en charge).
Connectez-vous à Numezis et approuvez les scopes demandés.
Après autorisation, exécutez une requête tools/list pour confirmer la visibilité des modules.

Exemples de code

Utilisez ces extraits 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 only when the client cannot use 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

# If DCR is unavailable, use the fallback static client:
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 de vos modules activés et des permissions de l'utilisateur. Les groupes principaux incluent :

Finance — Comptabilité, ventes, achats, rapprochement, flux TVA et opérations de grand livre.
Personnes — Flux RH dont employés, contrats, absences et opérations liées à la paie.
Opérations — Inventaire, opérations de projet et gestion des tâches.
Clients — CRM, contacts et commentaires collaboratifs liés aux enregistrements métier.
Documents & données — Capture documentaire, classification et flux d'import de données gouvernés.
Intégrations — Connecteurs Google, Microsoft et d'enrichissement/intelligence lorsqu'ils sont activés.
Contrôles — Approbations, configuration des modules et fonctions centrales de gouvernance.

Sécurité et traitement des données

Le transport utilise HTTPS/TLS avec OAuth Protected Resource Metadata.
L'accès est restreint côté serveur via AccessMode, le contexte de portail et les contrôles de permissions.
Les mutations critiques peuvent exiger une approbation explicite avant exécution.
Les journaux opérationnels et les audits peuvent être conservés selon la politique de la plateforme ; voir la Politique de confidentialité et le DPA pour les détails.

FAQ

Ce connecteur est-il en lecture seule ?

Non. Il prend en charge les opérations de lecture et d'écriture, avec des contrôles de gouvernance et d'approbation pour les actions sensibles.

Puis-je utiliser une URL MCP personnalisée par utilisateur ?

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

Quel transport est pris en charge ?

Streamable HTTP est pris en charge. Les anciens endpoints SSE sont dépréciés.

Comment les permissions sont-elles appliquées ?

Les permissions sont appliquées à chaque requête via le rôle de l'utilisateur, les modules activés et les contrôles AccessMode à portée de portail.

Les actions critiques nécessitent-elles une confirmation ?

Oui. Selon la politique et la sécurité du manifeste de l'outil, les actions destructives peuvent déclencher une étape d'approbation.

Où obtenir du support ?

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

Support et aspects juridiques

Pour de l'aide à l'onboarding ou un support incident, contactez le support Numezis. La Politique de confidentialité et le DPA sont disponibles publiquement dans la section Sécurité.

Où dans l'application

Entreprise → Agent — /c/companies/:companyId/agent
Endpoint MCP — https://www.numezis.com/mcp

Pas à pas

Activez le module Agent et les permissions. Après OAuth, les outils sont visibles.
Enregistrez https://www.numezis.com/mcp dans le client (flux DCR ou client ID).
Terminez l'OAuth et exécutez tools/list. Seuls les outils autorisés apparaissent.
Exécutez un outil de lecture, puis une mutation. Les outils critiques renvoient un jeton d'approbation.
Approuvez dans l'interface lorsque demandé. La mutation se termine avec audit.
Vérifiez la piste d'audit sur l'enregistrement.

Permissions et modules

Module Agent ; contrôles au niveau des outils via AccessMode.