Clés d’API, l’API Craftkite et MCP

L’API Craftkite permet à votre propre code de faire ce que vous faites dans le studio : créer des apps à partir d’une description, envoyer des messages, approuver des plans, suivre la construction, ouvrir l’aperçu, publier, exporter le code, rechercher des problèmes de sécurité et créer des documents. Le serveur MCP propose les mêmes actions sous forme d’outils, afin qu’un assistant d’IA compatible MCP puisse utiliser Craftkite pour vous.

Créer une clé

1. Ouvrez Compte et allez dans API et MCP.
2. Cliquez sur Créer une clé, donnez-lui un Nom (par exemple « chaîne de build ») et choisissez ses Autorisations :
   • Lire les projets : lister les projets, tâches, aperçus, publications et analyses de sécurité.
   • Créer et modifier : créer des apps, envoyer des messages et approuver des plans (utilise des crédits).
   • Publier, Exporter le code et Documents.
3. Choisissez son Expiration et, si vous possédez ou administrez un espace de travail d’équipe, si elle est Pour vos projets personnels ou ceux de l’espace.
4. Copiez la clé. Elle ne s’affiche qu’une fois ; Craftkite n’en conserve qu’une empreinte.

Révoquez une clé à tout moment avec l’icône de corbeille : les outils qui l’utilisent cessent aussitôt de fonctionner. Les clés d’API sont incluses dans les forfaits payants.

Utiliser l’API REST

Envoyez la clé dans l’en-tête Authorization comme jeton Bearer. L’adresse de l’API REST et la description OpenAPI figurent dans API et MCP. Un déroulé type :

1. POST /projects avec un prompt crée l’app ; la réponse inclut sa première tâche.
2. GET /tasks/{id} (ou les événements en direct sur /tasks/{id}/events) jusqu’au statut awaiting_approval ; la tâche affiche le plan et son devis en crédits.
3. POST /tasks/{id}/approve lance la construction. POST /projects/{id}/preview renvoie l’adresse de l’aperçu.
4. POST /projects/{id}/deployments publie l’app. Si l’analyse de sécurité trouve un problème critique, la réponse est security-critical ; publiez à nouveau avec confirmSecurity: true pour continuer.

Connecter un assistant d’IA (MCP)

Ajoutez l’adresse du Serveur MCP à tout client MCP qui prend en charge les serveurs distants (HTTP) et envoyez votre clé comme jeton Bearer. L’assistant voit des outils comme create_project, send_message, wait_for_task, approve_plan, get_preview_url et publish_project, limités aux autorisations de votre clé.

Crédits et limites

Tout ce qu’une clé lance utilise vos crédits et les limites de votre forfait, exactement comme dans le studio : chaque construction affiche d’abord son devis et ne coûte jamais plus que le devis que vous approuvez. La lecture, les aperçus, les analyses de sécurité et les exports sont gratuits. Les clés ont leurs propres limites de requêtes ; si vous en envoyez trop, la réponse indique combien de secondes attendre.