Identik Firma Digital
Firma digital argentina (Ley 25.506) con certificados de certificador licenciado.
我該用這個嗎
品質與安全性
發現項目(6)
- LOW在 reenviar_invitacion 中
- LOW在 descargar_documento_firmado 中
- LOW在 descargar_constancia 中
- LOW在 validar_pdf 中
- LOW在 estado_cuenta 中
- LOW在 crear_documento_desde_plantilla 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"firma": {
"url": "https://firma.identik.me/api/mcp"
}
}
}遠端端點
https://firma.identik.me/api/mcpstreamable-http它能做什麼
工具清單
工具(11)
⚪listar_plantillas(pagina)
Lista las plantillas del equipo con sus `id` y firmantes. Las plantillas se arman en la interfaz web; desde acá se usan para generar documentos.
輸入結構描述
{
"type": "object",
"properties": {
"pagina": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Página (por defecto 1)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪listar_documentos(pagina)
Lista los documentos del equipo con su estado (DRAFT, PENDING, COMPLETED, REJECTED).
輸入結構描述
{
"type": "object",
"properties": {
"pagina": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Página (por defecto 1)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪obtener_documento(documento_id)
Devuelve un documento por su `id` numérico: estado, `meta` (`requireBiometricId`, `requireWhatsappOtp`, idioma), firmantes (con `signingStatus`, `signingUrl` y la identidad esperada para la biometría: `idDocumentNumber`, `firstName`, `lastName`), campos y `envelopeId`.
輸入結構描述
{
"type": "object",
"properties": {
"documento_id": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "El `id` numérico del documento."
}
},
"required": [
"documento_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪crear_documento_desde_plantilla(plantilla_id, titulo, firmantes, asunto, mensaje, ...)
Genera un documento de firma digital a partir de una plantilla. Flujo: listar_plantillas → esta herramienta → enviar_documento. Devuelve el `documentId` y el `signingUrl` de cada firmante. IMPORTANTE: el documento queda en borrador (no consume crédito) hasta que lo envíes con enviar_documento.
輸入結構描述
{
"type": "object",
"properties": {
"plantilla_id": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "El `id` de la plantilla."
},
"titulo": {
"type": "string",
"description": "Título del documento (si no, hereda el de la plantilla)."
},
"firmantes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "El `id` del firmante DE LA PLANTILLA (viene de listar_plantillas). Opcional: si la plantilla tiene un solo firmante se resuelve automáticamente, y si tiene varios se empareja por el orden de este array."
},
"email": {
"type": "string",
"format": "email",
"description": "Email real del firmante para este documento."
},
"nombre": {
"type": "string",
"description": "Nombre completo del firmante."
},
"telefono": {
"type": "string",
"pattern": "^\\+[1-9]\\d{7,14}$",
"description": "Teléfono en formato internacional (por ej. \"+5491123456789\") para mandarle el link de firma por WhatsApp además del email. Requiere que la cuenta tenga saldo de WhatsApp (ver estado_cuenta) y que el documento lo tenga activado; si falta algo se ignora y el firmante recibe el email."
},
"cuil": {
"type": "string",
"description": "CUIL del firmante (por ej. \"20-33111349-3\"). OBLIGATORIO en esta plataforma: firma con certificado digital."
}
},
"required": [
"email",
"cuil"
],
"additionalProperties": false
},
"minItems": 1,
"description": "Los firmantes de esta instancia."
},
"asunto": {
"type": "string",
"description": "Asunto del email de invitación."
},
"mensaje": {
"type": "string",
"description": "Mensaje del email de invitación."
},
"avisar_por_whatsapp": {
"type": "boolean",
"description": "true = a cada firmante que tenga `telefono` cargado se le manda el link de firma por WhatsApp, ADEMÁS del email. Consume 1 crédito de WhatsApp por mensaje enviado (ver estado_cuenta). Sin saldo o sin teléfono no se manda nada y el email sale igual."
}
},
"required": [
"plantilla_id",
"firmantes"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪enviar_documento(documento_id, enviar_email)
Pone el documento en firma. ACÁ se consume el crédito del documento; sin este paso queda en borrador. Por defecto manda el email de invitación a cada firmante. Con `enviar_email: false` NO manda ningún email: el documento igual queda en firma y vos distribuís los `signingUrl` por el canal que quieras (WhatsApp, tu propio mail, un chat). Los links los conseguís con `obtener_documento`.
輸入結構描述
{
"type": "object",
"properties": {
"documento_id": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "El `id` numérico del documento."
},
"enviar_email": {
"type": "boolean",
"description": "false = no mandar ningún email de invitación. Por defecto true."
}
},
"required": [
"documento_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪reenviar_invitacion(documento_id, firmantes)
Reenvía el email de firma a firmantes que todavía no firmaron.
輸入結構描述
{
"type": "object",
"properties": {
"documento_id": {
"type": "integer",
"exclusiveMinimum": 0
},
"firmantes": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 1,
"description": "Los `recipientId` a los que reenviar (de obtener_documento)."
}
},
"required": [
"documento_id",
"firmantes"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪descargar_documento_firmado(documento_id)
Devuelve una URL firmada de descarga del PDF firmado. En firma digital la constancia NO va dentro del PDF: bajala aparte con descargar_constancia. Pasado el plazo de resguardo responde 410.
輸入結構描述
{
"type": "object",
"properties": {
"documento_id": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"documento_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪descargar_constancia(documento_id)
Devuelve una URL temporal (1 hora, sin token) para bajar la constancia de firma como PDF: firmantes, fechas, IP, dispositivo, sellos de tiempo y hash SHA-256 del PDF firmado. En firma digital la constancia NO va dentro del PDF firmado: archivala junto con el documento. Sólo documentos COMPLETED.
輸入結構描述
{
"type": "object",
"properties": {
"documento_id": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"documento_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪traza_auditoria(documento_id, pagina)
Devuelve la traza de auditoría completa del documento en JSON (creación, envío, apertura, firmas, con fecha/IP/dispositivo). Resuelve el envelopeId automáticamente a partir del id numérico.
輸入結構描述
{
"type": "object",
"properties": {
"documento_id": {
"type": "integer",
"exclusiveMinimum": 0
},
"pagina": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"documento_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪validar_pdf(pdf_base64)
Verifica criptográficamente las firmas de un PDF (de Identik o firma digital argentina): integridad, cadena, sello de tiempo RFC-3161, y si es un documento de PRUEBA. Equivalente autenticado del validador público /validar.
輸入結構描述
{
"type": "object",
"properties": {
"pdf_base64": {
"type": "string",
"maxLength": 21495808,
"description": "El PDF completo, en base64 (máx. 15 MB)."
}
},
"required": [
"pdf_base64"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪estado_cuenta
Saldos de la cuenta: créditos de documentos y, si la plataforma los usa, verificación de identidad biométrica, WhatsApp y SMS.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}社群
證據