Kanta MCP Server
Un serveur MCP (Model Context Protocol) pour l'API Kanta, permettant l'intégration avec des modèles de langage comme Claude.
Description
Ce serveur MCP expose les fonctionnalités de l'API Kanta v1.1 à travers le protocole MCP, permettant aux assistants IA d'interagir avec les données Kanta pour :
- Gérer les clients (création, mise à jour, recherche, assignation)
- Administrer les utilisateurs
- Consulter les données des personnes
- Accéder aux informations des cabinets et structures
- Récupérer les résumés de risques
Fonctionnalités
Gestion des Clients
get_customers: Lister les clients avec paginationget_customer: Récupérer un client par IDcreate_customer: Créer un nouveau clientupdate_customer: Mettre à jour un client existantsearch_customers: Rechercher des clientsassign_customers: Assigner superviseurs/contributeursget_customer_risk_summary: Récupérer le résumé des risques
Gestion des Utilisateurs
get_users: Lister les utilisateursget_user: Récupérer un utilisateur par IDcreate_user: Créer un nouvel utilisateurdelete_user: Supprimer un utilisateur
Gestion des Personnes
get_persons: Lister les personnesget_person: Récupérer une personne par ID
Autres Fonctionnalités
get_firms: Lister les cabinetsget_structure: Récupérer les informations de structure
Installation
Installing via Smithery
To install kanta-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Kanta-Inc/kanta-mcp-server --client claude
Manual Installation
- Cloner le repository :
git clone <repository-url>
cd kanta-mcp-server
- Installer les dépendances :
npm install
- Construire le serveur pour Smithery :
npm run build
Configuration
Configuration Smithery
Le serveur est configuré via Smithery avec les paramètres suivants :
apiKey: Votre clé API Kanta (obligatoire)apiUrl: URL de base de l'API (optionnel, défaut: https://app.kanta.fr/api/v1)
Obtention de la clé API
Pour obtenir votre clé API Kanta :
- Connectez-vous à https://app.kanta.fr
- Allez dans "Gestion du cabinet"
- Sélectionnez "Clés API"
- Générez ou copiez votre clé API
Utilisation
Lancement du serveur
# Lancement du serveur construit
npm start
# Mode développement avec Smithery
npm run dev
Configuration MCP
Pour utiliser avec Claude Desktop, installez via Smithery :
npx -y @smithery/cli install @Kanta-Inc/kanta-mcp-server --client claude
La configuration de l'API key se fait via l'interface Smithery lors de l'installation.
Développement
Scripts disponibles
npm run build: Construit le serveur pour le déploiement Smitherynpm start: Lance le serveur construit localementnpm run dev: Lance en mode développement avec Smithery CLInpm run watch: Lance en mode watch avec tsx
Structure du projet
src/
├── index.ts # Point d'entrée principal
├── types.ts # Définitions de types et schémas Zod
├── kanta-client.ts # Client HTTP pour l'API Kanta
└── tools/
├── customers.ts # Outils pour la gestion des clients
├── users.ts # Outils pour la gestion des utilisateurs
├── persons.ts # Outils pour la gestion des personnes
└── misc.ts # Autres outils (cabinets, structure, fichiers)
API Kanta
Ce serveur utilise l'API Kanta v1.1. Pour plus d'informations sur l'API :
- URL de base : https://app.kanta.fr/api/v1
- Authentification : Clé API via l'en-tête
X-API-Key - Documentation complète disponible dans le fichier
api-docs.json
Limitations
- Les fonctionnalités d'upload/download de fichiers ne sont pas disponibles (limitation MCP)
- Toutes les opérations nécessitent une clé API valide Kanta
- Focus sur les opérations CRUD et la consultation des données JSON
Licence
MIT
Support
Pour les questions relatives à l'API Kanta, consultez la documentation officielle Kanta. Pour les problèmes liés à ce serveur MCP, créez une issue dans ce repository.