- Antigravity CLI - Agent basé sur le terminal avec prise en charge de MCP. Idéal pour les développeurs qui travaillent dans le terminal.
- Antigravity Desktop - IDE autonome avec la même configuration MCP. Idéal pour les développeurs qui préfèrent un éditeur visuel.
Prérequis
- Un compte Firma avec une clé API
- Antigravity CLI ou Antigravity Desktop installé
- Au moins un modèle Firma avec des champs de signature configurés
Firma utilise la clé API brute comme valeur de l’en-tête
Authorization - ne la préfixez pas avec Bearer. Cela diffère de nombreuses autres API.Pour commencer
- Antigravity CLI
- Antigravity Desktop
Antigravity CLI (Sur Windows (PowerShell) :Le binaire s’installe sous le nom Lister vos demandes de signature :Envoyer une demande de signature :Ajouter une signature intégrée à une application React :Configurer des webhooks :Faire référence explicitement à « la documentation Firma » indique à l’agent d’interroger le serveur MCP
agy) est un agent IA basé sur le terminal qui prend en charge les serveurs MCP pour l’intégration d’outils externes. Connecter les serveurs MCP de Firma permet à l’agent de construire des intégrations Firma et d’opérer sur vos données Firma.Étape 1 : Installer Antigravity CLI
Si ce n’est pas déjà fait, installez le CLI :agy. Vous devrez peut-être ajouter ~/.local/bin à votre PATH.Étape 2 : Ajouter les serveurs MCP de Firma
Créez ou modifiez~/.gemini/antigravity/mcp_config.json et ajoutez les deux serveurs Firma :- firma-api donne à Antigravity un accès direct à l’API Firma - 84 outils couvrant les demandes de signature, les modèles, les espaces de travail et les webhooks.
- firma-docs donne à Antigravity accès à l’ensemble de la documentation Firma afin qu’il génère du code d’intégration précis.
Quand utiliser quel serveur :
firma-api sert à faire des choses (envoyer des demandes de signature, gérer des modèles). firma-docs sert à construire des choses (générer du code d’intégration avec des détails d’API précis). La plupart des développeurs veulent connecter les deux.Étape 3 : Utiliser Firma depuis le CLI
Une fois connecté, vous pouvez demander à Antigravity de construire des intégrations Firma ou d’opérer sur vos données :Générer une intégration backend :firma-docs avant d’écrire du code. Sans cela, il peut se rabattre sur des connaissances générales et manquer des détails sur les endpoints ou l’authentification.Ce que l’agent génère
Lorsque vous demandez à Antigravity de construire une intégration Firma, le code backend généré devrait ressembler à ceci :create-and-send crée la demande de signature et l’envoie aux destinataires de manière atomique. Si vous devez examiner ou modifier la demande avant l’envoi, utilisez POST /signing-requests pour créer un brouillon, puis POST /signing-requests/{id}/send séparément.
Intégration des webhooks
Pour suivre les événements de signature en temps réel, demandez à Antigravity d’ajouter un gestionnaire de webhook :Signature intégrée
Pour les applications où les signataires complètent les documents directement dans votre interface utilisateur plutôt que d’ouvrir une page hébergée par Firma, la réponsecreate-and-send inclut first_signer.id (le signing_request_user_id) et un first_signer.signing_link prêt à l’emploi. Chargez l’URL du signataire dans une iframe :
Migration depuis Gemini CLI
Si vous utilisiez auparavant Firma avec Gemini CLI, voici ce qui a changé :| Gemini CLI | Antigravity CLI |
|---|---|
~/.gemini/settings.json | ~/.gemini/antigravity/mcp_config.json |
httpUrl pour les serveurs distants | serverUrl pour les serveurs distants |
binaire gemini | binaire agy |
Gemini CLI cesse de fonctionner pour les utilisateurs de niveau individuel le 18 juin 2026. Si vous disposez d’une licence Gemini Code Assist Standard/Enterprise, les extensions IDE de Gemini CLI continuent de fonctionner.
Conseils
- Utilisez
firma-docspour construire,firma-apipour opérer. Le serveur de documentation aide l’agent à écrire du code d’intégration correct. Le serveur API permet à l’agent de gérer directement les demandes de signature, les modèles et les espaces de travail. - Passez
template_idexplicitement. Les modèles sont le moyen le plus sûr de limiter ce que l’agent peut envoyer. Laissez l’agent choisir un ID de modèle dans une liste courte et nommée que vous contrôlez. - Validez avant d’envoyer. Pour les documents à plus fort enjeu, demandez à l’agent de créer un brouillon avec
POST /signing-requests, puis de confirmer avant d’appelerPOST /signing-requests/{id}/send. - Espaces de travail pour les applications multi-tenant. Si vous construisez un produit SaaS, donnez à chaque client final son propre espace de travail Firma afin que les modèles et l’utilisation restent isolés.
Prochaines étapes
- Authentification API - Clés API et périmètre des espaces de travail
- Guide des webhooks - Types d’événements, payloads et vérification de signature
- Signature intégrée - Expérience de signature intégrée à l’application
- Création d’espaces de travail - Configurations multi-tenant pour les applications SaaS
- Intégration MCP - Référence complète du serveur MCP avec les 84 outils
- Guide de configuration complet - Parcours complet d’intégration Firma
- Référence API - Documentation complète des endpoints