Qué es el MCP

El MCP —Model Context Protocol— es un estándar abierto que permite a un asistente de IA usar servicios externos. Sin él, el asistente solo sabe conversar: puede redactarle el texto de un contrato, pero no puede enviarlo para firmar. Con él, pasa a tener herramientas.

AssinaJá ofrece un servidor MCP oficial. Una vez conectado, puede pedir al asistente, en lenguaje corriente, que prepare un documento a partir de una de sus plantillas, que le diga quién no ha firmado todavía o que le traiga el PDF firmado.

Qué cambia en la práctica

El trabajo de firma tiene mucho de repetitivo: tomar una plantilla, rellenar los mismos campos con datos que están en otro sitio, elegir a los firmantes, enviar y después ir comprobando quién falta. Ese es el hueco que cierra el MCP.

Trabaja donde ya está. Si está preparando una propuesta en una conversación con el asistente, el documento sale de esa misma conversación. No hay que exportar, cambiar de pestaña ni volver a subir el archivo.

El asistente lee sus plantillas. Consulta las plantillas reales de su organización —con los firmantes y los campos que tienen definidos— en lugar de inventarse un formato.

Sirve para preguntar, no solo para hacer. “¿Qué documentos llevan más de una semana esperando firma?” es una pregunta que el asistente responde consultando la lista real.

Es el mismo motor. Las herramientas MCP llaman a los mismos servicios de la API pública: no hay una segunda implementación con reglas distintas. Lo que está prohibido en la aplicación sigue prohibido aquí.

Dos formas de conectar

Forma	Para quién
OAuth	Asistentes web: Claude.ai, ChatGPT, Copilot, Grok
Cabecera X-Api-Key	Herramientas locales y automatizaciones: Claude Code, Cursor, CI

Los asistentes web no permiten definir cabeceras propias, por eso usan OAuth. Son las conexiones que se describen en Conectar Claude.ai y Conectar ChatGPT.

La dirección del servidor es la misma en ambos casos:

https://app.assinaja.pt/mcp

Herramientas locales, mediante la cabecera

Para Claude Code, por ejemplo, la conexión es un único comando, con la clave de API viajando en la cabecera:

claude mcp add --transport http assinaja https://app.assinaja.pt/mcp \
  --header "X-Api-Key: ajk_live_..."

El modelo de seguridad

Esta es la parte que distingue la integración, y conviene entenderla antes de conectar nada.

El asistente nunca accede a su cuenta

Incluso con OAuth, lo que se emite no es un acceso a su cuenta de usuario. Es un acceso vinculado a una clave de API concreta. La propia página de autorización lo dice:

Este asistente de IA solicita acceso a su organización. El acceso se realiza mediante una clave de API: el asistente solo podrá hacer lo que esa clave permita y nunca accede a su cuenta.

Si la clave solo puede consultar documentos, eso es lo que puede hacer el asistente: no hay ningún camino por el que llegue al resto.

El asistente solo ve lo que la clave permite

El filtrado es anterior a la decisión del asistente. Cuando pregunta al servidor qué herramientas existen, la respuesta ya viene recortada según los permisos de la clave: una herramienta fuera de su alcance no aparece en la lista; no es solo que se rechace al llamarla.

En la práctica, un asistente conectado con una clave sin Documentos: publicar ni siquiera sabe que publicar es posible.

Autorizar y revocar un asistente

Con OAuth, el asistente abre la página de autorización de AssinaJá —Conectar {asistente} con AssinaJá— y la autorización tiene dos pasos:

1. Paso 1 de 2 — elija la clave de API que quiere usar. La lista solo muestra claves activas, dentro de su validez, de organizaciones de las que usted es Propietario. Si no hay ninguna, la página dice:

   No tiene ninguna clave de API activa.

   Cree una en el backoffice, en Configuración → Claves de API, y vuelva a intentar la conexión.

2. Paso 2 de 2 — confirme los permisos que va a conceder. Muestra lo que la clave permite. Un permiso sin nombre propio en esta página aparece con su código técnico; por ejemplo, analytics:read o documents:signurls. Autorizar acceso concluye:

   Al confirmar, queda registrado que ha autorizado a {asistente} a usar esta clave. Puede retirar el acceso en cualquier momento suspendiendo o eliminando la clave en Configuración → Claves de API.

La autorización no se recuerda: cada conexión nueva pasa por los dos pasos y se registra por separado.

La revocación se hace desde la clave, no desde el asistente: en Configuración → Desarrolladores → Claves de API, Suspender —“Mientras esté suspendida, la clave no autentica hasta que se vuelva a activar.”— o Eliminar, que es definitivo. El efecto es inmediato; consulte Retirar el acceso es inmediato.

El consentimiento queda registrado

Autorizar no es un clic que se pierde. Queda grabado quién autorizó, qué clave, qué asistente, qué permisos, cuándo y desde qué dirección. Puede ver ese registro en Configuración → Desarrolladores → Claves de API, en la sección Autorizada para asistentes de IA:

Registro de consentimientos (evidencia). Para cortar el acceso de un asistente, suspenda o elimine la clave.

Retirar el acceso es inmediato

La clave se revalida en cada petición. Suspender, dejar caducar o eliminar la clave retira el acceso del asistente en el acto: no hay que esperar a que termine una sesión.

Sirve como respuesta al caso más incómodo: si desconfía de una conexión, suspenda la clave y vea qué deja de funcionar. Suspender es reversible.

Reglas que el servidor impone al asistente

El servidor envía instrucciones de seguridad que el asistente recibe antes de actuar: los códigos de firmante pertenecen a la plantilla y nunca pueden inventarse; publicar envía correos electrónicos al instante y no se puede deshacer, por eso exige confirmación explícita en la conversación; y una creación fallida nunca se repite a ciegas, porque una segunda llamada crea un segundo documento y una segunda tanda de correos.

Límite de uso

60 peticiones por minuto por credencial, para todas las herramientas, incluidas las que solo consultan. Es el mismo contador que el de las rutas de creación de documentos de la API pública: un sistema que use la misma clave con la cabecera X-Api-Key, en la API y en el MCP, comparte esas 60. Las demás rutas de la API pública tienen un límite propio, de 300 peticiones por minuto, que no se aplica al MCP.

Qué puede hacer el asistente

Las herramientas disponibles dependen de los permisos marcados en la clave. Los nombres de la derecha son los que ve en el asistente.

Permiso de la clave	El asistente pasa a poder
Plantillas: consultar	List templates · Get template details
Documentos: consultar	List documents · Get document details · Get document overview · Download document file
Documentos: enlaces de firma	Get signing links
Documentos: crear	Create document · Create document from template · Create document from Word template · Create upload link · Get upload link status
Documentos: publicar	Publish draft and notify signers
Documentos: archivar/eliminar	Archive document · Delete document
Organización: consultar	Get organization · Get subscriptions and plan features
Analítica: consultar	Analytics overview · Usage metrics · Metric over time · Metric breakdown · Signing funnel · Adoption and seats · Metric catalog

El asistente puede pedir la firma simultánea, y que se ignore

Al crear un documento, un asistente puede pedir que todos los firmantes reciban la invitación a la vez. Solo se respeta si la organización lo permite en Configuración → Organización → Políticas → Firmas.

Si no lo permite, la petición no da error: el documento sale secuencial igualmente, y es la respuesta la que trae el valor efectivo. Por eso las herramientas indican al asistente que lea ese valor antes de decirle quién recibe el correo electrónico y cuándo: si le asegura “todos lo han recibido ya” sin haberlo leído, puede estar equivocado. Consulte Configurar las políticas de la organización.

Publicar es el permiso que hay que pensarse dos veces

Publish draft and notify signers envía correos electrónicos y es irreversible. Crear y publicar son permisos separados a propósito: una clave con crear pero sin publicar deja que el asistente lo prepare todo y obliga a que una persona pulse el botón. La combinación recomendada para la primera conexión está en Crear una clave de API.

Archivos que están en su ordenador

El asistente no puede ir a buscar archivos a su disco. Cuando necesita uno, crea un enlace de entrega: usted lo abre, sube el archivo y el asistente continúa. Consulte Entregar un archivo a un asistente.

Los límites

La analítica está desactivada por defecto. Que un asistente pueda leer las cifras de la organización es una decisión aparte, en Configuración → Organización → Políticas → Automatización, en la sección Acceso de la IA a la analítica:

Si los asistentes conectados por MCP pueden consultar las cifras de esta organización. Está desactivado de forma predeterminada. Nunca da acceso a documentos, contenidos ni claves: solo a métricas agregadas, y cada consulta queda registrada en la auditoría.

Hacen falta las dos cosas

La política activa la lectura para la organización; el permiso Analítica: consultar la activa para una clave concreta. Si falta cualquiera de las dos, las siete herramientas ni siquiera aparecen en la lista que ve el asistente: no fallan al llamarlas, quedan invisibles.

Es deliberado: un asistente no puede pedir lo que no sabe que existe.

Un asistente puede equivocarse. Leer los documentos correctos y resumirlos mal es un fallo posible, y el MCP no lo resuelve. Para lo que importa, compruébelo en la aplicación antes de enviar.

Lo que haga queda a su nombre. Los documentos se crean en su organización y consumen sus cuotas.

Véase también

• Conectar Claude.ai con AssinaJá
• Conectar ChatGPT con AssinaJá
• Crear una clave de API
• Configurar las políticas de la organización — el ajuste que hace que los documentos creados por IA empiecen como borrador