Kanta MCP Server

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 pagination
• get_customer : Récupérer un client par ID
• create_customer : Créer un nouveau client
• update_customer : Mettre à jour un client existant
• search_customers : Rechercher des clients
• assign_customers : Assigner superviseurs/contributeurs
• get_customer_risk_summary : Récupérer le résumé des risques

Gestion des Utilisateurs

• get_users : Lister les utilisateurs
• get_user : Récupérer un utilisateur par ID
• create_user : Créer un nouvel utilisateur
• delete_user : Supprimer un utilisateur

Gestion des Personnes

• get_persons : Lister les personnes
• get_person : Récupérer une personne par ID

Autres Fonctionnalités

• get_firms : Lister les cabinets
• get_structure : Récupérer les informations de structure

Installation

Installing via Smithery

To install kanta-mcp-server for Claude Desktop automatically via Smithery:

Manual Installation

1. Cloner le repository :

2. Installer les dépendances :

3. Compiler le TypeScript :

Configuration

Variables d'environnement requises

• KANTA_API_KEY : Votre clé API Kanta (obligatoire)
• KANTA_API_URL : 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 :

1. Connectez-vous à https://app.kanta.fr
2. Allez dans "Gestion du cabinet"
3. Sélectionnez "Clés API"
4. Générez ou copiez votre clé API

Utilisation

Lancement du serveur

Configuration MCP

Ajoutez cette configuration à votre client MCP (comme Claude Desktop) :

Développement

Scripts disponibles

• npm run build : Compile le TypeScript
• npm start : Lance le serveur compilé
• npm run dev : Lance en mode développement avec tsx
• npm run watch : Lance en mode watch pour le développement

Structure du projet

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.