- Antigravity CLI - Agente basado en terminal con soporte para MCP. Ideal para desarrolladores que trabajan en la terminal.
- Antigravity Desktop - IDE independiente con la misma configuración de MCP. Ideal para desarrolladores que prefieren un editor visual.
Requisitos previos
- Una cuenta de Firma con una Clave API
- Antigravity CLI o Antigravity Desktop instalado
- Al menos una Plantilla de Firma con campos de firma configurados
Firma usa la Clave API sin procesar como valor del encabezado
Authorization; no la antepongas con Bearer. Esto difiere de muchas otras API.Primeros pasos
- Antigravity CLI
- Antigravity Desktop
Antigravity CLI (En Windows (PowerShell):El binario se instala como Listar tus Solicitudes de Firma:Enviar una Solicitud de Firma:Agregar firma incrustada a una app de React:Configurar webhooks:Referirse explícitamente a “los docs de Firma” le indica al agente que consulte el servidor MCP
agy) es un agente de IA basado en terminal que admite servidores MCP para la integración de herramientas externas. Conectar los servidores MCP de Firma le permite al agente construir integraciones de Firma y operar sobre tus datos de Firma.Paso 1: Instala Antigravity CLI
Si aún no lo has hecho, instala el CLI:agy. Es posible que debas agregar ~/.local/bin a tu PATH.Paso 2: Agrega los servidores MCP de Firma
Crea o edita~/.gemini/antigravity/mcp_config.json y agrega ambos servidores de Firma:- firma-api le da a Antigravity acceso directo a la API de Firma: 84 herramientas para Solicitudes de Firma, Plantillas, Espacios de Trabajo y webhooks.
- firma-docs le da a Antigravity acceso a toda la documentación de Firma para que genere código de integración preciso.
Cuándo usar cada servidor:
firma-api es para hacer cosas (enviar Solicitudes de Firma, gestionar Plantillas). firma-docs es para construir cosas (generar código de integración con detalles precisos de la API). La mayoría de los desarrolladores querrán ambos conectados.Paso 3: Usa Firma desde el CLI
Una vez conectado, puedes pedirle a Antigravity que construya integraciones de Firma u opere sobre tus datos:Generar una integración de backend:firma-docs antes de escribir código. Sin eso, puede recurrir a conocimiento general y pasar por alto detalles de endpoints o autenticación.Qué genera el agente
Cuando le pides a Antigravity que construya una integración de Firma, el código de backend generado debería verse así:create-and-send crea la Solicitud de Firma y la envía a los Destinatarios de forma atómica. Si necesitas revisar o modificar la solicitud antes de enviarla, usa POST /signing-requests para crear un borrador y luego POST /signing-requests/{id}/send por separado.
Integración de webhooks
Para rastrear eventos de firma en tiempo real, pídele a Antigravity que agregue un manejador de webhooks:Firma incrustada
Para apps donde los Firmantes completan documentos dentro de tu interfaz en lugar de abrir una página alojada por Firma, la respuesta decreate-and-send incluye first_signer.id (el signing_request_user_id) y un first_signer.signing_link ya generado. Carga la URL del Firmante en un iframe:
Migración desde Gemini CLI
Si antes usabas Firma con Gemini CLI, esto es lo que cambió:| Gemini CLI | Antigravity CLI |
|---|---|
~/.gemini/settings.json | ~/.gemini/antigravity/mcp_config.json |
httpUrl para servidores remotos | serverUrl para servidores remotos |
binario gemini | binario agy |
Gemini CLI deja de dar servicio a usuarios del nivel individual el 18 de junio de 2026. Si tienes una licencia Gemini Code Assist Standard/Enterprise, las extensiones de IDE de Gemini CLI seguirán funcionando.
Consejos
- Usa
firma-docspara construir,firma-apipara operar. El servidor de docs ayuda al agente a escribir código de integración correcto. El servidor de la API le permite al agente gestionar Solicitudes de Firma, Plantillas y Espacios de Trabajo directamente. - Pasa
template_idexplícitamente. Las Plantillas son la forma más segura de limitar lo que el agente puede enviar. Deja que el agente elija un ID de Plantilla de una lista corta y con nombre que tú controles. - Valida antes de enviar. Para documentos de mayor riesgo, pídele al agente que cree un borrador con
POST /signing-requestsy que confirme antes de llamar aPOST /signing-requests/{id}/send. - Espacios de Trabajo para apps multiusuario. Si estás construyendo un producto SaaS, dale a cada cliente final su propio Espacio de Trabajo de Firma para que las Plantillas y el uso se mantengan aislados.
Próximos pasos
- Autenticación de la API - Claves API y alcance de Espacios de Trabajo
- Guía de webhooks - Tipos de eventos, payloads y verificación de firma
- Firma incrustada - Experiencia de firma dentro de la app
- Creación de Espacios de Trabajo - Configuraciones multiusuario para apps SaaS
- Integración MCP - Referencia completa del servidor MCP con las 84 herramientas
- Guía de configuración completa - Recorrido de integración de Firma de principio a fin
- Referencia de la API - Documentación completa de endpoints