Identik Firma Electrónica

Identik MCP — 阿根廷电子签名和数字签名，适用于 AI Agent

ES · Identik 的远程 MCP 服务，可让 AI Agent 在阿根廷签署具有法律效力的文件（第 25.506 号法律）：根据模板创建文件、发送文件供人签署、跟踪状态、下载带有签署证明的已签署 PDF，并以密码学方式验证签名。

EN · Identik 的远程 MCP 服务。Identik 是一个阿根廷电子签名平台（第 25.506 号法律）。AI Agent 可以根据模板创建文件、发送文件供人签署、跟踪状态、下载带有审计证明的已签署 PDF，并以密码学方式验证签名。

开发者文档 / 开发者中心 · 电子签名 · 数字签名 · 指南 / 使用指南

Agent 负责准备和管理文件工作流。签署人须在平台上授权签名；MCP 不会替代这一同意，也不会索要签署人的 PIN 或 OTP。

Agent 准备和管理文件工作流。签署人须在平台上授权签名；MCP 不会替代这一同意，也不会索要签署人的 PIN 或 OTP。

此仓库包含连接到 Identik 托管的 MCP 服务所需的文档和清单。不包含产品源代码（Identik 是一项托管的商业服务）。

此仓库包含连接到 Identik 托管的 MCP 服务所需的文档和清单。不包含产品源代码（Identik 是一项托管的商业服务）。

---

两个平台

Identik 提供两个 MCP 服务，每个签名级别对应一个。工具集相同；不同之处在于最终签名的法律效力。

	电子签名	数字签名
MCP 注册表	me.identik/electronica	me.identik/firma
生产环境	https://electronica.identik.me/api/mcp	https://firma.identik.me/api/mcp
Sandbox（评估）	https://sandbox-electronica.identik.me/api/mcp	https://sandbox-firma.identik.me/api/mcp
法律依据	第 25.506 号法律第 5 条	第 25.506 号法律第 2、7 和 8 条
签署人如何签名	通过电子邮件链接 + 证据（带有可追溯性的证明、加密印章、RFC-3161 时间戳）	使用持牌认证机构颁发的自有证书：CUIL + PIN + OTP
法律效力	附有完整证据的电子签名	法律推定签名者身份及文件完整性
可选生物识别验证（DNI + 活体检测）	是	不适用（身份由证书提供）

Sandbox 是彼此独立的环境，各自拥有账户、数据、额度和数据库，可用于开发和评估集成，而不会影响生产环境。它们签发的文件无效，这是有意设计的，且可验证：证明上会标记「PRUEBA — FIRMA NO VÁLIDA」，加盖印章时使用的测试证书与生产证书不同，公共验证器会识别并拒绝将文件作为测试文件（validar_pdf 返回 testEnvironment: true 和 ok: false）。

---

传输与身份验证 / 传输与身份验证

• 传输： Streamable HTTP，无状态。仅支持 POST（GET 和 DELETE 返回 405）。/ 仅支持 POST（GET 和 DELETE 返回 405）。
• 身份验证： HTTP 标头 Authorization: Bearer api_...
• 直连服务： 团队 API 令牌。/ 直连服务： 团队 API 令牌。
• 公开发现： initialize 和 tools/list 无需凭据。账户和文档操作需要有效令牌。/ 公开发现： initialize 和 tools/list 无需凭据。账户和文档操作需要有效令牌。

此外，OpenAI 还有一个 OAuth 连接器，位于 connect.identik.me，端点为 https://connect.identik.me/mcp。它有独立的授权流程和允许使用的客户端列表；如需通过 API 令牌集成，请使用本指南中的直连端点。它能否出现在 OpenAI 目录中取决于 OpenAI 的审核流程。

Claude 还有专用的 OAuth 连接器，位于 claude-connect.identik.me，端点为 https://claude-connect.identik.me/mcp：可在 Claude（网页、Desktop 和 Cowork）中将其添加为自定义连接器，无需 mcp-remote 或静态标头；也可安装带有技能的 Claude Code 插件（Identik-me/identik-claude-plugin）：运行 claude plugin marketplace add Identik-me/identik-claude-plugin，然后运行 claude plugin install identik@identik。一个连接可支持 Firma Digital、Firma Electrónica，或两者；用户在 Identik 的授权页面输入团队令牌，绝不会在聊天中输入。它能否出现在 Anthropic 目录中取决于 Anthropic 的审核流程。

如何获取令牌 / 如何获取令牌

需要 Identik API 令牌。 请发送邮件至 [email protected] 申请，或在账户的 Configuración → API Tokens 中生成。

需要 Identik API 令牌。 请发送邮件至 [email protected] 申请，或在账户的 Configuración → API Tokens 中生成。

没有令牌时，私有操作会返回 401。工具目录是公开的：

$ curl -sS -X POST https://electronica.identik.me/api/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# HTTP 200: result.tools contiene las 11 herramientas / contains all 11 tools.

参见 examples/smoke-test.sh。/ 参见 examples/smoke-test.sh。

---

工具 / Tools

共 11 个工具，名称使用西班牙语（平台面向阿根廷市场）。两种平台上的工具完全相同，以下注明的除外。

Eleven tools, named in Spanish (the platform targets the Argentine market). Identical across both platforms except where noted.

工具 / Tool	功能 / What it does
listar_plantillas	列出团队的模板及其 id 和签署人。模板在 Web 界面中创建；在此处使用模板生成文档。
listar_documentos	列出团队的文档及其状态（DRAFT、PENDING、COMPLETED、REJECTED）。
obtener_documento	根据数字 id 返回文档：状态、签署人（含 signingStatus 和 signingUrl）、字段和 envelopeId。
crear_documento_desde_plantilla	根据模板生成文档。返回 documentId 以及每位签署人的 signingUrl。文档会保留为草稿，发送前不会消耗额度。
enviar_documento	发送邀请邮件，并将文档设为待签署状态。此时会消耗额度。
reenviar_invitacion	向尚未签署的签署人重新发送签署邮件。
descargar_documento_firmado	返回带签名的 PDF 下载 URL（含签署证明）。超过保留期限后会返回 410。
descargar_constancia	获取文档的签署证明，包含证据和记录的事件。
traza_auditoria	以 JSON 格式返回文档的完整审计轨迹：创建、发送、打开和签署，以及日期、IP 和设备信息。
validar_pdf	以加密方式验证 PDF 的签名：完整性、证书链、RFC-3161 时间戳，以及是否为测试文档。
estado_cuenta	账户可用和总计的文档额度。

典型流程 / Typical flow：

listar_plantillas  →  crear_documento_desde_plantilla  →  enviar_documento
                                                            ↓
                        obtener_documento / traza_auditoria (seguimiento)
                                                            ↓
                                            descargar_documento_firmado

仅适用于电子签名 / Electronic signature only

crear_documento_desde_plantilla 接受 requiere_biometria: true — 每位签署人必须通过生物识别验证（身份证件 + 活体检测）才能签署。每次验证通过后会消耗 1 个验证额度。建议为每位签署人同时设置 dni_numero，以便将验证结果与该值进行比对。

crear_documento_desde_plantilla accepts requiere_biometria: true — each signer must pass a biometric identity check (ID document + liveness) before signing. Consumes 1 verification credit per passed check. Best combined with each signer's dni_numero, so the check is validated against that value.

仅适用于数字签名 / Digital signature only

每位签署人都通过 cuil 进行身份识别，该值必须与其数字签名证书相符。

Each signer is identified by cuil, which must match their digital-signature certificate.

---

按客户端配置 / Client configuration

在所有示例中，将 api_... 替换为你的令牌；如果要使用数字签名，则将 electronica.identik.me 替换为 firma.identik.me（或替换为 sandbox-* 主机进行评估）。

In every example, replace api_... with your token, and electronica.identik.me with firma.identik.me for digital signature (or with the sandbox-* host to evaluate).

客户端 / Client	是否原生支持静态标头？ / Native static header?	配置位置 / Where
Claude Code	是 / Yes	claude mcp add、.mcp.json
Cursor	是 / Yes	~/.cursor/mcp.json
VS Code / Copilot	是 / Yes	.vscode/mcp.json
Codex CLI	是 / Yes	~/.codex/config.toml
OpenAI Agents SDK	是 / Yes	代码 / code
OpenAI Responses API	是 / Yes	代码 / code
Gemini CLI	是 / Yes	扩展 / extension
Claude Desktop	否 — 通过 mcp-remote / via mcp-remote	claude_desktop_config.json

Claude Code

claude mcp add identik --transport http https://electronica.identik.me/api/mcp \
  --header "Authorization: Bearer api_..."

--header 可以重复使用。在 .mcp.json（可纳入项目版本控制）中的等效配置：

{
  "mcpServers": {
    "identik": {
      "type": "http",
      "url": "https://electronica.identik.me/api/mcp",
      "headers": {
        "Authorization": "Bearer ${IDENTIK_TOKEN}"
      }
    }
  }
}

只要存在 url，就必须设置 type：包含 url 但未设置 type 的条目属于配置错误，服务器会被跳过。Claude Code 会展开 url 和 headers 中的 ${VAR} 和 ${VAR:-default}，因此无需将令牌提交到版本控制中。

只要存在 url，就必须设置 type：包含 url 但未设置 type 的条目属于配置错误，服务器会被跳过。Claude Code 会展开 url 和 headers 中的 ${VAR} 和 ${VAR:-default}，因此无需将令牌提交到版本控制中。

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目级）：

{
  "mcpServers": {
    "identik": {
      "url": "https://electronica.identik.me/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:IDENTIK_TOKEN}"
      }
    }
  }
}

Cursor 会根据 url 的存在推断这是远程服务，因此无需设置 type。如果收到 401，某些版本无法解析 headers 中的 ${env:...}；此时请将令牌直接写入 ~/.cursor/mcp.json（全局配置，不要写入纳入版本控制的 .cursor/mcp.json）。

Cursor 会根据 url 的存在推断这是远程服务，因此无需设置 type。如果收到 401，某些版本无法解析 headers 中的 ${env:...}；此时请将令牌直接写入 ~/.cursor/mcp.json（全局配置，不要写入纳入版本控制的 .cursor/mcp.json）。

VS Code（GitHub Copilot，Agent 模式）

工作区中的 .vscode/mcp.json，或用户配置文件中的 mcp.json（命令面板 → MCP: Open User Configuration）。注意：顶层键是 servers，不是 mcpServers。inputs 块可避免将令牌写入文件：

工作区中的 .vscode/mcp.json，或用户配置文件中的 mcp.json（命令面板 → MCP: Open User Configuration）。注意：顶层键是 servers，不是 mcpServers。inputs 块可避免将令牌写入文件：

{
  "inputs": [
    {
      "id": "identik-token",
      "type": "promptString",
      "description": "Token de API de Identik (sin el prefijo 'Bearer')",
      "password": true
    }
  ],
  "servers": {
    "identik": {
      "type": "http",
      "url": "https://electronica.identik.me/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:identik-token}"
      }
    }
  }
}

VS Code 会在首次连接时提示输入令牌，并安全地保存令牌，因此不会有机密信息进入 Git 仓库。

VS Code 会在首次连接时提示输入令牌，并安全地保存令牌，因此不会有机密信息进入 Git 仓库。

使用 VS Code 的 Agent Host 时，使用 ${input:...} 的服务器不会被转发。若要使用可移植配置，请使用工作区 .mcp.json 或 ~/.copilot/mcp-config.json（架构不同：键为 mcpServers，并包含 tools 字段）。

使用 VS Code 的 Agent Host 时，使用 ${input:...} 的服务器不会被转发。若要使用可移植配置，请使用工作区 .mcp.json 或 ~/.copilot/mcp-config.json（架构不同：键为 mcpServers，并包含 tools 字段）。

Codex CLI

在 ~/.codex/config.toml 中配置，并将令牌保存在文件之外（Codex 会自行添加 Bearer 前缀）：

在 ~/.codex/config.toml 中配置，并将令牌保存在文件之外（Codex 会自行添加 Bearer 前缀）：

[mcp_servers.identik]
url = "https://electronica.identik.me/api/mcp"
bearer_token_env_var = "IDENTIK_TOKEN"

可通过以下方式生成：

可通过以下方式生成：

codex mcp add identik --url https://electronica.identik.me/api/mcp \
  --bearer-token-env-var IDENTIK_TOKEN

显式设置标头的等效配置：

显式设置标头的等效配置：

[mcp_servers.identik]
url = "https://electronica.identik.me/api/mcp"
http_headers = { Authorization = "Bearer api_..." }
tool_timeout_sec = 120

codex mcp add 没有用于设置任意标头的选项：如果需要 http_headers，请手动编辑 config.toml。

codex mcp add 没有用于设置任意标头的选项：如果需要 http_headers，请手动编辑 config.toml。

OpenAI Agents SDK（Python）

import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main() -> None:
    async with MCPServerStreamableHttp(
        name="identik",
        params={
            "url": "https://electronica.identik.me/api/mcp",
            "headers": {"Authorization": f"Bearer {os.environ['IDENTIK_TOKEN']}"},
        },
    ) as identik:
        agent = Agent(
            name="Asistente de firmas",
            instructions=(
                "Ayudás a preparar y enviar documentos a firmar con Identik. "
                "Confirmá siempre con la persona antes de llamar a enviar_documento, "
                "porque ese paso consume un crédito y envía emails reales."
            ),
            mcp_servers=[identik],
        )
        result = await Runner.run(agent, "¿Qué plantillas tengo disponibles?")
        print(result.final_output)

asyncio.run(main())

OpenAI Responses API（托管的 MCP 工具）

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "tools": [{
      "type": "mcp",
      "server_label": "identik",
      "server_url": "https://electronica.identik.me/api/mcp",
      "headers": { "Authorization": "Bearer api_..." },
      "require_approval": "always"
    }],
    "input": "Listá mis plantillas de Identik."
  }'

推荐将 require_approval 设为 "always"：enviar_documento 会发送真实邮件并消耗额度。

将 require_approval 保持为 "always"：enviar_documento 会发送真实邮件并消耗额度。

这条路径还有两个注意事项：

• 令牌应放在 headers 中，而不是 authorization：该字段用于 OAuth 访问令牌，而此服务不使用 OAuth。 / 令牌应放在 headers 中，而不是 authorization — 该字段用于 OAuth 访问令牌，而此服务不使用 OAuth。
• 与其他客户端不同，OpenAI 会从自己的基础设施连接到该服务，而不是从你的机器连接。 / 与其他客户端不同，此处 OpenAI 会从自己的基础设施连接到该服务，而不是从你的机器连接。

Gemini CLI

此仓库可直接作为 Gemini CLI 扩展安装：

gemini extensions install Identik-me/identik-mcp

该扩展会注册两个平台（identik-electronica 和 identik-firma），并在安装时询问令牌，然后将其保存在操作系统密钥链中。只填写你使用的平台对应的令牌，另一个留空。

该扩展会注册两个平台（identik-electronica 和 identik-firma），并在安装时提示输入令牌，然后将令牌存储在操作系统密钥链中。只填写你使用的平台对应的令牌，另一个留空。

只有在 settings.json 中启用 experimental.extensionConfig 后，Gemini CLI 才会在安装时询问令牌；如果它没有询问，请使用 gemini extensions config identik-mcp 设置令牌，或通过环境变量设置。

只有在 settings.json 中启用 experimental.extensionConfig 后，Gemini CLI 才会在安装时提示输入令牌；如果它没有询问，请使用 gemini extensions config identik-mcp 设置令牌，或通过环境变量设置。

你也可以通过环境变量提供令牌：

export IDENTIK_ELECTRONICA_TOKEN="api_..."
export IDENTIK_FIRMA_TOKEN="api_..."

请参阅 gemini-extension.json 和 GEMINI.md（扩展会将其中的使用指南加载到 Agent 的上下文中，其中包括调用 enviar_documento 前先请求确认的规则）。

请参阅 gemini-extension.json 和 GEMINI.md — 扩展会将其中的使用指南加载到 Agent 的上下文中，包括调用 enviar_documento 前先向用户确认的规则。

Claude Desktop

Claude Desktop 的配置文件仅支持 stdio 服务，而其自定义连接器对话框要求提供带 OAuth 的 URL（不接受静态标头）。因此，服务器通过 mcp-remote 桥接。

无需桥接的替代方案：将 https://claude-connect.identik.me/mcp 添加为自定义连接器（OAuth，参见传输与身份验证）。本节其余内容介绍直接使用令牌的端点。

Bridge-free alternative: add https://claude-connect.identik.me/mcp as a custom connector (OAuth, see Transport and authentication). The rest of this section covers the direct token endpoints.

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "identik": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://electronica.identik.me/api/mcp",
        "--transport", "http-only",
        "--header", "Authorization:${IDENTIK_AUTH}"
      ],
      "env": {
        "IDENTIK_AUTH": "Bearer api_..."
      }
    }
  }
}

--transport http-only 可阻止 mcp-remote 先尝试 SSE，而此服务器不提供 SSE。需要安装 Node.js。

--transport http-only stops mcp-remote from probing SSE first, which this server does not expose. Requires Node.js.

注意，格式为 Authorization:${IDENTIK_AUTH}，冒号后没有空格：mcp-remote 会在第一个 : 处分割参数，而且某些 Claude Desktop 运行时会拆分包含空格的参数。实际的空格会放在环境变量中传递。

Note the Authorization:${IDENTIK_AUTH} form with no space after the colon: mcp-remote splits on the first :, and some Claude Desktop runtimes split arguments containing spaces. The real space travels inside the env var.

Claude Desktop 的 Code 标签页（内嵌的 Claude Code）会读取 ~/.claude.json 和 .mcp.json，因此上文的原生 type: "http" + headers 格式在那里可用。此限制仅适用于聊天界面。

Claude Desktop's Code tab (embedded Claude Code) does read ~/.claude.json and .mcp.json, so the native type: "http" + headers form above works there. The limitation applies only to the chat surface.

---

发现

每个实例都会公开自己的 metadata，无需身份验证：

Each instance serves its own metadata, unauthenticated:

资源	URL
MCP 清单	https://electronica.identik.me/.well-known/mcp.json
大模型指南	https://electronica.identik.me/llms.txt
交互式 API 文档	https://electronica.identik.me/api/docs
OpenAPI 规范	https://electronica.identik.me/api/v1/openapi.json
Postman 集合	https://electronica.identik.me/api/docs/postman.json
公开的 PDF 验证器	https://electronica.identik.me/validar

sandbox-* 主机和 firma.identik.me 上的路径相同。/api/docs 的**“Agentes de IA (servidor MCP)”**部分将 MCP 服务与 REST API 一并介绍。

Same paths on firma.identik.me and on the sandbox-* hosts. The "Agentes de IA (servidor MCP)" section of /api/docs documents the MCP server alongside the REST API.

官方 MCP 注册表 / 官方 MCP 注册表

两个服务都已发布在官方 MCP 注册表中，位于 me.identik 命名空间下，并通过 identik.me 的 DNS 验证：

两个服务都已发布在官方 MCP 注册表中，位于 me.identik 命名空间下，并通过 identik.me 的 DNS 验证：

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=me.identik"

已发布的清单位于 servers/。/ 已发布的清单位于 servers/。

---

运行说明 / 运行说明

• enviar_documento 会产生实际影响。 它会向签署人发送邮件，并消耗一份文档额度。Agent 在调用前应征求人工确认。开发时请使用沙盒。/ enviar_documento 会产生实际影响。 它会向签署人发送邮件，并消耗一份文档额度。Agent 在调用前应征求人工确认。开发时请使用沙盒。
• 模板需在网页界面中创建。 MCP 层会使用现有模板，不会创建或编辑字段布局。/ 模板需在网页界面中创建。 MCP 层会使用现有模板，不会创建或编辑字段布局。
• 额度。 estado_cuenta 会报告可用额度。生物识别验证使用单独的额度池。/ 额度。 estado_cuenta 会报告可用额度。生物识别验证使用单独的额度池。
• 保留期限。 超过文档保留期限后，descargar_documento_firmado 会返回 410。/ 保留期限。 超过文档保留期限后，descargar_documento_firmado 会返回 410。

---

支持 / 支持

• 令牌、定价、账户 / 令牌、定价、账户： [email protected]
• 网站： https://identik.me
• 关于这些清单的问题 / 关于这些清单的问题：此仓库的问题

许可证 / 许可证

此仓库中的清单和示例基于 MIT 许可证发布。Identik 服务本身是托管式商业产品，适用其自身条款。

此仓库中的清单和示例基于 MIT 许可证发布。Identik 服务本身是托管式商业产品，适用其自身条款。