Cómo conectar signNow a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → signNow, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

signNow + Gemini

Firmas electrónicas con signNow para una cuenta: explora carpetas, documentos y plantillas, consulta el estado de las invitaciones y el historial de los documentos, descarga PDF firmados, crea documentos desde plantillas o archivos, rellena campos de antemano, envía invitaciones por roles, free form y de grupos de documentos, recuerda y cancela.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

SIGNNOW_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de signNow con acceso a la API; para pruebas basta una cuenta de desarrollador gratuita (https://www.signnow.com/developers).

1. Inicia sesión en signNow y abre el API Dashboard (https://app.signnow.com/webapp/api-dashboard).
2. Abre Apps and Keys, selecciona tu aplicación (o crea una) y copia la clave de la pestaña API Keys.
3. Pégala en SIGNNOW_API_KEY, sin Bearer y sin espacios. El conector la envía como Authorization: Bearer <key>. La clave no caduca; si la borras en el panel, el conector pierde el acceso.
4. Instala el conector y ejecuta signnow_get_user: muestra la cuenta a la que pertenece la clave y la confirma.

Por qué una clave API: signNow también ofrece el password grant (solo para el propietario de la app API) y el flujo OAuth 2.0 authorization code (para actuar en nombre de otros usuarios de signNow). Para automatizar una sola cuenta signNow recomienda la clave API, y es la opción más sencilla: sin renovación de tokens y sin contraseña guardada. El conector actúa como el usuario de signNow propietario de la clave.

Qué lee:

• Cuenta y carpetas: signnow_get_user, signnow_list_folders (raíz, Documents, Templates, Archive, Trash Bin y tus carpetas, con el número de documentos) y signnow_get_folder, que lista los documentos, plantillas y grupos de documentos de una carpeta. Filtra por estado de firma (signed, pending, waiting-for-me, waiting-for-others, unsent, expired) o por fecha; entity_type template lista plantillas.
• Documentos: signnow_get_document (roles, campos, invitaciones de campo con su estado, solicitudes free form), signnow_get_document_fields (los valores rellenados), signnow_get_document_history (cada evento con hora, email, dirección IP y app cliente), signnow_list_free_form_invites y signnow_get_routing_details (los roles de firmante de una plantilla en orden de firma).
• Archivos: signnow_download_document (un PDF aplanado o un ZIP, opcionalmente con el historial al final), signnow_get_download_link (un enlace público temporal, sin iniciar sesión) y signnow_download_document_group (un PDF combinado o un ZIP).
• Grupos de documentos: signnow_list_document_groups, signnow_get_document_group, signnow_get_document_group_recipients, signnow_get_group_invite (estado de cada paso), signnow_list_template_groups y signnow_get_template_group.

Qué escribe:

• Desde una plantilla: signnow_create_document_from_template, opcionalmente signnow_prefill_text_fields por nombre de campo, y luego signnow_send_invite con una entrada to por rol (nombres de rol como "Signer 1" de signnow_get_document), o signnow_create_signing_link para un enlace de firma directo sin email.
• Desde un archivo nuevo: signnow_upload_document_from_url (con check_fields true, las text tags del archivo se convierten en campos; con make_template true se guarda como plantilla), campos añadidos con signnow_update_document si hace falta, y luego signnow_send_invite. Un archivo sin campos sale con signnow_send_free_form_invite: un firmante por llamada, que coloca la firma donde quiera. signnow_create_template convierte un documento en plantilla.
• Seguimiento: signnow_resend_field_invite (recordatorio a un firmante pendiente), signnow_cancel_invite, signnow_cancel_free_form_invite, signnow_move_document y signnow_create_folder.
• Grupos de documentos: signnow_create_document_group, signnow_create_group_from_template, signnow_send_group_invite (firma por pasos, cada uno con los emails a avisar y las acciones sign o view), signnow_resend_group_invite y signnow_cancel_group_invite.

Las invitaciones, los recordatorios y las invitaciones de grupo llegan por email a personas reales, y los documentos firmados son legalmente vinculantes. La IA te muestra el documento, los firmantes con sus roles y el mensaje, y solo envía después de un sí claro. from debe ser el email de la cuenta de signNow a la que pertenece la clave. signnow_update_document con fields sustituye todos los campos del documento, así que la IA incluye los que deben quedarse. Una invitación cancelada no se puede restaurar.

Desactivadas al instalar: signnow_delete_document (las invitaciones pendientes del documento dejan de funcionar) y signnow_delete_document_group (los documentos se conservan; un grupo con una invitación pendiente debe cancelarse antes). No se pueden deshacer, así que un administrador del workspace las activa cuando el equipo las necesita.

Formatos de datos: los ids son cadenas hexadecimales de 40 caracteres. created y updated son marcas de tiempo Unix en segundos, a menudo como cadenas. Un documento es una plantilla cuando template es true. status de una invitación de campo: created (esperando a un firmante anterior), pending (enviada para firmar), fulfilled (firmada) y declined; invitaciones free form: pending, fulfilled, cancelled. Las coordenadas de los campos son píxeles desde la esquina superior izquierda de la página, y las páginas empiezan en 0.

Paginación: signnow_get_folder admite limit (hasta 100) y offset y devuelve total_documents. Los grupos de documentos y las plantillas de grupo admiten limit (hasta 50) y offset; las invitaciones free form admiten page y per_page (hasta 100).

Errores comunes: una clave API incorrecta, borrada o ausente responde 400 con invalid_token y código 1537; signNow no usa 401 aquí. 403 significa que el usuario de la clave no puede ver o hacer eso. 404 Unable to find a route significa un id desconocido o mal formado. 400 con una lista errors significa datos no válidos, por ejemplo un rol desconocido, un from que no es el email de tu cuenta o una invitación por roles para un documento sin campos. Ante un 429 la IA espera y vuelve a intentarlo. Las cuentas en el servidor EU de signNow o las cuentas de evaluación antiguas (api-eval.signnow.com) usan otro host de API: en ese caso cambia la URL base del conector.

El conector no firma documentos por sí mismo, no sube archivos desde tu ordenador (solo desde una URL pública) y no usa OAuth ni el password grant.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de signNow.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué documentos de mi carpeta Documents siguen esperando la firma de otros? Muéstrame quién no ha firmado todavía."
• "Crea un documento desde nuestra plantilla de NDA, rellena el nombre de la empresa Acme GmbH y envíalo a [email protected] como Signer 1. Enséñamelo todo antes de enviarlo."
• "Descarga el PDF firmado del contrato de alquiler con el historial de firmas al final."
• "Muéstrame el historial del contrato que enviamos a [email protected]: ¿cuándo lo abrió y cuándo lo firmó?"
• "Envía un recordatorio al firmante que aún no ha firmado el contrato de servicios."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot