Intégrez KatappultAI dans votre IDE
KatappultAI expose un serveur MCP complet — 28 outils structurés, sécurisés et documentés. Pilotez votre application depuis Claude Code, Cursor, Windsurf ou n'importe quel client MCP compatible.
Prérequis — Obtenir un token API
Créer un compte KatappultAI
Rendez-vous sur platform.katappult.ai et créez votre compte.
Générer un token API
Paramètres → Sécurité → Tokens API → Générer un nouveau token. Copiez-le — il n'est affiché qu'une fois.
Configurer votre client
Ajoutez l'URL et le token dans votre client MCP (voir les guides ci-dessous).
Guides d'intégration par client
Configuration pas à pas pour chaque outil IA compatible MCP
terminal
claude mcp add --transport http katappultAi \
https://api.katappult.ai/mcp \
--header "Authorization: Bearer VOTRE_TOKEN_API"Vérification
Tapez /mcp dans une session Claude Code pour vérifier que katappultAi est actif avec au moins 28 outils.
28 outils MCP — Référence complète
KatappultAI expose 28 outils structurés en 3 catégories
La plupart des opérations de modification nécessitent d'appeler checkout_project au préalable.
| list_projects | Liste vos projets avec pagination |
| get_project | Détails d'un projet |
| create_project | Crée un nouveau projet |
| checkout_project | Passe un projet en mode édition |
| rename_project | Renomme un projet |
| archive_project | Archive un projet (soft delete) |
| delete_project | Supprime définitivement un projet |
| get_project_model | Modèle JSON complet du projet |
| list_entities | Liste des noms d'entités dans le modèle |
| get_entity | Configuration complète d'une entité |
| get_generator_config | Configuration du générateur |
| add_or_update_entity | Ajoute ou remplace une entité complète |
| delete_entity | Supprime une entité du modèle |
| update_generator_config | Met à jour la configuration du générateur |
| add_attribute | Ajoute un attribut à une entité |
| remove_attribute | Supprime un attribut |
| update_attribute_required | Met à jour le caractère requis d'un attribut |
| add_relation | Crée une relation (oneToMany, oneToOne, manyToMany) |
| remove_relation | Supprime une relation |
| list_available_features | Liste toutes les features (Knoers) disponibles |
| add_feature | Active une feature sur une entité |
| remove_feature | Désactive une feature |
| add_business_type | Ajoute un type métier à une entité |
| remove_business_type | Supprime un type métier |
| apply_changes | Applique plusieurs modifications en une transaction atomique |
| get_entity_workflow | Récupère le workflow d'une entité LifecycleManaged |
| update_entity_workflow | Met à jour le workflow d'une entité |
| reset_entity_workflow | Remet le workflow à l'état par défaut |
Exemples de workflows
Ce que vous pouvez accomplir avec une seule phrase en langage naturel
Modèle e-commerce de zéro
Votre prompt
Séquence d'outils automatique
- 1
create_project → obtient l'internalId - 2
checkout_project - 3
add_attribute × 4 sur Product + × 1 sur Category - 4
add_relation (Product ↔ Category, manyToMany) - 5
add_feature (Numberable sur Product)
Cycle de vie d'une commande
Votre prompt
Séquence d'outils automatique
- 1
checkout_project - 2
add_feature (LifecycleManaged sur Order) - 3
get_entity_workflow (lire l'état existant) - 4
update_entity_workflow (appliquer les nouveaux états)
Inspection et refactoring
Votre prompt
Séquence d'outils automatique
- 1
list_entities - 2
get_entity (Contact) - 3
apply_changes (removeAttribute + addAttribute — transaction atomique)
Sécurité & Bonnes pratiques
Protection du token API
Ne commitez jamais votre token API dans Git. Utilisez une variable d'environnement KATAPPULT_TOKEN.
Isolation des données
Chaque token est strictement isolé. Vous ne pouvez accéder qu'à vos propres projets. Révoquez immédiatement un token compromis depuis Paramètres → Sécurité → Tokens API.
Opérations irréversibles
- ⚠delete_project — Irréversible. Recommandez get_project_model avant.
- ⚠delete_entity — Irréversible. Sauvegardez le modèle avant.
- ↩archive_project — Réversible depuis l'interface.