VSA MCP

URL du serveur: https://le-87297705.ci.digitalfactory.kpconsulting.fr/mcp
Authentification: Entra ID actif
OAuth Client ID: 468a53bb-e3a7-42c7-be90-e3d3e8bf2255
Périmètre: Lecture seule 178 endpoints GET de l'API VSA

Connecter un client

Ouvrir Settings > Connectors sur claude.ai, puis Add custom connector.
Nom : VSA. URL du serveur :
https://le-87297705.ci.digitalfactory.kpconsulting.fr/mcp
Ouvrir Advanced settings et renseigner l'OAuth Client ID :
468a53bb-e3a7-42c7-be90-e3d3e8bf2255
Laisser le Client Secret vide.
Cliquer sur Add, puis Connect : la page de connexion Microsoft s'ouvre. Se connecter avec son compte KPC.
Dans une conversation, activer le connecteur VSA depuis le menu des outils.

Le connecteur ajouté sur claude.ai est disponible automatiquement dans Claude Desktop avec le même compte.

Ajouter le serveur :
claude mcp add --transport http vsa https://le-87297705.ci.digitalfactory.kpconsulting.fr/mcp --client-id 468a53bb-e3a7-42c7-be90-e3d3e8bf2255 --callback-port 8765
Lancer Claude Code, taper /mcp, sélectionner vsa puis Authenticate : le navigateur ouvre la connexion Microsoft.
Vérifier avec claude mcp list : le serveur doit apparaître Connected.

Le port 8765 doit rester celui-ci : il correspond à l'URL de redirection enregistrée dans Entra ID.

Transport: Streamable HTTP, POST https://le-87297705.ci.digitalfactory.kpconsulting.fr/mcp
Autorisation: OAuth 2.1, Authorization Code + PKCE (S256), client public
Métadonnées: https://le-87297705.ci.digitalfactory.kpconsulting.fr/.well-known/oauth-protected-resource/mcp
Scopes: api://468a53bb-e3a7-42c7-be90-e3d3e8bf2255/access_as_user offline_access
Client ID: 468a53bb-e3a7-42c7-be90-e3d3e8bf2255

L'URL de redirection du client doit être enregistrée dans l'application Entra ID. Demander son ajout à l'administrateur du serveur.

Outils exposés

search_endpoints

Recherche un endpoint VSA par mots-clés, en français ou en anglais.

describe_endpoint

Détaille les paramètres et le format de réponse d'un endpoint.

vsa_get

Interroge VSA. Seules les lectures (GET) sont autorisées.

Sales 57Human Ressource 36Recruitment 30Purchase 11Interface 9Billing 8Administration 8Referentials 6Media 4Activity 4Company 3Global 2

Exemples de questions

Quelles sont les factures fournisseurs reçues en septembre ?
Donne-moi la liste des clients dont le nom contient « Airbus ».
Quels collaborateurs sont absents la semaine prochaine ?
Quelles sont les priorités de tâches commerciales configurées dans VSA ?

Bon à savoir

Les réponses sont gardées en cache 5 minutes. Pour des données à jour, demander explicitement « données fraîches ».

Toutes les requêtes passent par un compte de service VSA commun : chaque utilisateur autorisé voit les mêmes données. Les appels sont journalisés avec l'identité Microsoft de l'utilisateur.

Les fichiers binaires (photos, PDF, factures électroniques) ne sont pas renvoyés, seulement leur type et leur taille.