Construire sur Spunto
Quatre portes d’entrée — appeler l’API, laisser un agent la piloter par MCP, brancher votre service comme une app, ou connecter vos utilisateurs avec leur compte Spunto.
Spunto est construit pour que ce à quoi il se branche ne soit pas codé en dur. Les dépôts viennent d’une app d’hébergement git, les sandboxes tournent sur une app runtime, les tâches s’exécutent sous une app d’agent — et GitHub, Google Cloud ou les machines que vous apportez vous-même sont chacun l’une de ces apps, qui parlent à la plateforme par le même contrat HTTP signé qu’utiliserait un tiers.
Il y a donc quatre façons de construire quelque chose avec Spunto, selon le côté qui engage la conversation.
Appeler Spunto — API REST
Créez des projets, démarrez des sandboxes, lancez des commandes et déléguez des tâches depuis un script ou une CI, avec une clé d’API à portée limitée.
Laisser un agent piloter — MCP
Pointez Claude Code, Cursor ou votre propre agent sur le serveur MCP : il peut trouver et lire vos projets.
Laisser Spunto vous appeler — apps
Implémentez une capability — un hébergeur git, un endroit où faire tourner des sandboxes — et les organisations l’installent comme elles installent GitHub.
Connecter vos utilisateurs — Connect with Spunto
OAuth 2 avec PKCE : savoir qui est un utilisateur, à quelles organisations il appartient, et avec quel rôle.
| Vous voulez… | Utilisez | Qui s’authentifie |
|---|---|---|
| Automatiser Spunto depuis un script, un job de CI ou un bot | API REST | Vous, avec une clé d’API spk_ |
| Donner à un agent IA des outils sur vos organisations | Serveur MCP | La même clé spk_ |
| Rendre votre forge, votre cloud ou vos machines disponibles pour les organisations Spunto | Une app | Spunto, qui signe chaque appel qu’il vous adresse |
| Mettre un bouton « Connect with Spunto » sur votre propre site | Connect with Spunto | L’utilisateur, sur l’écran de consentement de Spunto |
Les deux premières sont sortantes — votre code appelle Spunto. Les deux dernières sont entrantes — Spunto appelle votre code, ou lui envoie des utilisateurs.
Tout ce que décrivent ces pages est ouvert à toutes les organisations. Un owner ou un admin enregistre une app depuis Settings → Developer apps, et peut l’utiliser tout de suite dans sa propre organisation. Elle atteint les autres organisations une fois que Spunto l’a revue → Publier une app.
Une app déclare, dans un manifeste qu’elle sert, quelles capabilities elle implémente — git, runtime — et lesquelles de leurs opérations. Une organisation l’installe (un owner ou un admin la connecte, et l’app garde le credential qui en résulte). Quand la plateforme a besoin, par exemple, d’un credential pour cloner un dépôt, elle cherche quelle app installée implémente git.cloneCredential et l’appelle — un POST signé vers l’app, avec l’id de l’organisation et l’entrée de l’opération. La plateforme ne détient jamais les credentials de l’app : elle les demande.
→ Construire une app déroule tout, de bout en bout.