Identik Firma Electrónica

Identik MCP — AI エージェント向けアルゼンチンの電子署名とデジタル署名

ES · アルゼンチン（法律第25,506号）で法的効力を持つ文書に署名するための、Identik のリモート MCP サーバーです。AI エージェントから、テンプレートを使った文書の作成、署名依頼の送信、進捗状況の確認、署名済み PDF とその証明書のダウンロード、署名の暗号学的検証ができます。

EN · Identik のリモート MCP サーバーです。Identik はアルゼンチンの電子署名プラットフォームです（法律第25,506号）。AI エージェントでテンプレートから文書を作成し、署名を依頼して、進捗状況を確認し、監査証明書付きの署名済み PDF をダウンロードし、署名を暗号学的に検証できます。

開発者向けドキュメント / 開発者ハブ · 電子署名 · デジタル署名 · ガイド / ガイド

エージェントは文書のワークフローを準備し、管理します。署名者本人がプラットフォーム上で署名を承認します。MCP はこの同意に代わるものではなく、署名者の PIN や OTP を要求することもありません。

エージェントは文書のワークフローを準備し、管理します。署名者本人がプラットフォーム上で署名を承認します。MCP はこの同意に代わるものではなく、署名者の PIN や OTP を要求することもありません。

このリポジトリには、Identik がホストする MCP サーバーへの接続に必要なドキュメントとマニフェストが含まれています。製品のソースコードは含まれていません（Identik は商用のホスト型サービスです）。

このリポジトリには、Identik がホストする MCP サーバーへの接続に必要なドキュメントとマニフェストが含まれています。製品のソースコードは含まれていません（Identik は商用のホスト型サービスです）。

---

2つのプラットフォーム

Identik は、署名レベルごとに1つずつ、2つの MCP サーバーを提供します。ツールは同じで、異なるのは署名結果の法的効力です。

Identik は、署名レベルごとに1つずつ、2つの MCP サーバーを提供します。ツールセットは同じで、異なるのは署名結果の法的効力です。

	電子署名	デジタル署名
MCP レジストリ	me.identik/electronica	me.identik/firma
本番環境	https://electronica.identik.me/api/mcp	https://firma.identik.me/api/mcp
サンドボックス（評価用）	https://sandbox-electronica.identik.me/api/mcp	https://sandbox-firma.identik.me/api/mcp
法的根拠	Ley 25.506、第5条	Ley 25.506、第2条、第7条、第8条
署名者による署名方法	メール経由のリンク + 証跡（追跡可能性、暗号学的シール、RFC-3161 タイムスタンプを備えた証明書）	認可認証機関の独自証明書：CUIL + PIN + OTP
法的効力	完全な証跡を伴う電子署名	作成者と完全性に関する法的推定
任意の生体認証による本人確認（DNI + ライブネス検証）	はい	該当なし（本人確認は証明書によって行われます）

サンドボックスは、本番環境に触れることなく統合を開発・評価するための、独自のアカウント、データ、クレジット、データベースを持つ独立した環境です。サンドボックスで発行される文書は、設計上、検証可能な形で無効です。証明書には「PRUEBA — FIRMA NO VÁLIDA」の透かしが入り、シールには本番環境用とは異なるテスト証明書が使用されます。また、公開バリデーターはこれをテスト文書として認識し、拒否します（validar_pdf は testEnvironment: true と ok: false を返します）。

サンドボックスは、本番環境に触れることなく統合を構築・評価するための、独自のアカウント、データ、クレジット、データベースを持つ独立した環境です。サンドボックスで発行される文書は、設計上、検証可能な形で無効です。監査証明書には「PRUEBA — FIRMA NO VÁLIDA」の透かしが入り、シールには本番環境用とは異なるテスト証明書が使用されます。また、公開バリデーターはこれをテスト文書として認識し、拒否します（validar_pdf は testEnvironment: true と ok: false を返します）。

---

トランスポートと認証 / トランスポートと認証

• トランスポート / Transport: ストリーマブル HTTP、ステートレスです。POST のみ対応します（GET と DELETE は 405 を返します）。 / POST only (GET and DELETE return 405).
• 認証 / Authentication: HTTP ヘッダー Authorization: Bearer api_...
• 直接接続するサーバー： チームの API トークンです。 / Direct servers: team API token.
• 公開ディスカバリー： initialize と tools/list に認証情報は不要です。アカウントとドキュメントに関する操作には、有効なトークンが必要です。 / Public discovery: initialize and tools/list do not require credentials. Account and document operations require a valid token.

OpenAI 用の OAuth コネクターも connect.identik.me で利用でき、エンドポイントは https://connect.identik.me/mcp です。独自の認可フローと許可済みクライアントのリストを使用します。このガイドに記載された直接接続用エンドポイントの代わりにはなりません。OpenAI のディレクトリで利用できるかどうかは、OpenAI の審査プロセスによって決まります。

OpenAI OAuth connector is also available at connect.identik.me, using https://connect.identik.me/mcp. It has a separate authorization flow and client allowlist; use the direct endpoints in this guide for API-token integrations. Availability in OpenAI's directory depends on OpenAI's review process.

Claude 用には、claude-connect.identik.me に専用の OAuth コネクターがあり、エンドポイントは https://claude-connect.identik.me/mcp です。mcp-remote や静的ヘッダーを使わずに、Claude（Web、Desktop、Cowork）のカスタムコネクターとして追加できます。または、スキル付きの Claude Code プラグイン（Identik-me/identik-claude-plugin）をインストールできます。コマンドは claude plugin marketplace add Identik-me/identik-claude-plugin、続いて claude plugin install identik@identik です。1 つの接続で Firma Digital、Firma Electrónica、またはその両方を利用できます。利用者はチャットではなく、Identik の同意ページでチームのトークンを入力します。Anthropic のディレクトリで利用できるかどうかは、Anthropic の審査プロセスによって決まります。

For Claude there is a dedicated OAuth connector at claude-connect.identik.me, endpoint https://claude-connect.identik.me/mcp: add it as a custom connector in Claude (web, Desktop and Cowork) with no mcp-remote or static header, or install the Claude Code plugin with its skill (Identik-me/identik-claude-plugin): claude plugin marketplace add Identik-me/identik-claude-plugin, then claude plugin install identik@identik. One connection covers Firma Digital, Firma Electrónica or both; the person enters their team tokens on Identik's consent page, never in the chat. Availability in Anthropic's directory depends on Anthropic's review process.

トークンの取得方法 / How to get a token

Identik の API トークンが必要です。 [email protected] に申請するか、アカウントの Configuración → API Tokens から生成してください。

An Identik API token is required. Request one at [email protected], or generate it in your account under 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 を参照してください。 / See examples/smoke-test.sh.

---

ツール / ツール

11 個のツールをスペイン語の名前で提供します（プラットフォームはアルゼンチン市場を対象としています）。特記がある場合を除き、両方のプラットフォームで同一です。

11 個のツールをスペイン語の名前で提供します（プラットフォームはアルゼンチン市場を対象としています）。特記がある場合を除き、両方のプラットフォームで同一です。

ツール / ツール	機能 / 機能
listar_plantillas	チームのテンプレートを id と署名者とともに一覧表示します。テンプレートはウェブインターフェースで作成し、ここから文書の生成に使用します。
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	アカウントで利用可能な文書クレジット数と合計クレジット数を確認します。

一般的なワークフロー / 一般的なワークフロー:

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

電子署名のみ / 電子署名のみ

crear_documento_desde_plantilla は requiere_biometria: true を受け付けます。各署名者は署名の前に、生体認証による本人確認（身分証明書＋ライブネス検証）に合格する必要があります。確認に合格するごとに、認証クレジットを 1 消費します。確認がその値に対して行われるよう、各署名者の dni_numero と組み合わせることをおすすめします。

crear_documento_desde_plantilla は requiere_biometria: true を受け付けます。各署名者は署名の前に、生体認証による本人確認（身分証明書＋ライブネス検証）に合格する必要があります。確認に合格するごとに、認証クレジットを 1 消費します。確認がその値に対して行われるよう、各署名者の dni_numero と組み合わせることをおすすめします。

デジタル署名のみ / デジタル署名のみ

各署名者は cuil で識別されます。この値は、各自のデジタル署名証明書と一致している必要があります。

各署名者は cuil で識別されます。この値は、各自のデジタル署名証明書と一致している必要があります。

---

クライアントごとの設定 / クライアントごとの設定

すべての例で、api_... を自分のトークンに置き換えてください。デジタル署名を使用する場合は electronica.identik.me を firma.identik.me に置き換えます（評価用には sandbox-* ホストに置き換えてください）。

すべての例で、api_... を自分のトークンに置き換えてください。デジタル署名を使用する場合は electronica.identik.me を firma.identik.me に置き換えます（評価用には sandbox-* ホストに置き換えてください）。

クライアント / クライアント	ネイティブの静的ヘッダー / ネイティブの静的ヘッダー	設定場所 / 設定場所
Claude Code	はい / はい	claude mcp add、.mcp.json
Cursor	はい / はい	~/.cursor/mcp.json
VS Code / Copilot	はい / はい	.vscode/mcp.json
Codex CLI	はい / はい	~/.codex/config.toml
OpenAI Agents SDK	はい / はい	コード / コード
OpenAI Responses API	はい / はい	コード / コード
Gemini CLI	はい / はい	拡張機能 / 拡張機能
Claude Desktop	いいえ — mcp-remote 経由 / 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、エージェントモード）

ワークスペース内の .vscode/mcp.json、またはユーザープロファイルの mcp.json（コマンドパレット → MCP: Open User Configuration）を使用します。トップレベルのキーは mcpServers ではなく servers なので注意してください。inputs ブロックを使うと、トークンをファイルに記述せずに済みます。

ワークスペース内の .vscode/mcp.json、またはユーザープロファイルの mcp.json（コマンドパレット → MCP: Open User Configuration）を使用します。トップレベルのキーは mcpServers ではなく servers です。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 は初回接続時にトークンの入力を求め、安全に保存するため、リポジトリに秘密情報が残りません。

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 は実際にメールを送信し、クレジットを消費します。

この方法についての補足が 2 点あります。

• トークンは authorization ではなく headers に設定します。このフィールドは OAuth アクセストークン用ですが、このサーバーでは使用しません。
• 他のクライアントとは異なり、この場合は OpenAI がユーザーのマシンからではなく、独自のインフラストラクチャからサーバーに接続します。

Gemini CLI

このリポジトリは Gemini CLI の拡張機能として直接インストールできます。

gemini extensions install Identik-me/identik-mcp

この拡張機能は両方のプラットフォーム（identik-electronica と identik-firma）を登録し、インストール時にトークンの入力を求め、OS のキーチェーンに保存します。使用するプラットフォームのトークンだけを入力し、もう一方は空欄にしてください。

この拡張機能は両方のプラットフォーム（identik-electronica と identik-firma）を登録し、インストール時にトークンの入力を求めて、OS のキーチェーンに保存します。使用するプラットフォームのトークンだけを入力し、もう一方は空欄にしてください。

Gemini CLI がインストール時にトークンの入力を求めるのは、settings.json で experimental.extensionConfig が有効になっている場合だけです。入力を求められない場合は、gemini extensions config identik-mcp または環境変数で設定してください。

Gemini CLI がインストール時にトークンの入力を求めるのは、settings.json で experimental.extensionConfig が有効になっている場合だけです。入力を求められない場合は、gemini extensions config identik-mcp または環境変数で設定してください。

環境変数を使って渡すこともできます。

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

gemini-extension.json と GEMINI.md を参照してください。後者には、enviar_documento の実行前に人間の確認を求めるルールを含め、拡張機能がエージェントのコンテキストに読み込む使用方法のガイドが記載されています。

gemini-extension.json と GEMINI.md を参照してください。後者は、enviar_documento の実行前に人間の確認を求めるルールを含む、拡張機能がエージェントのコンテキストに読み込む使用方法のガイドです。

Claude Desktop

Claude Desktopの設定ファイルはstdioサーバーのみを受け付けます。また、カスタムコネクタのダイアログではOAuth対応のURLが求められ、静的ヘッダーを指定できません。そのため、サーバーにはmcp-remoteブリッジ経由で接続します。

ブリッジを使わない方法：https://claude-connect.identik.me/mcpをカスタムコネクタとして追加します（OAuthについてはトランスポートと認証を参照）。以降は、トークンを直接使うエンドポイントについて説明します。

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のインストールが必要です。

コロンの後にスペースを入れず、Authorization:${IDENTIK_AUTH}の形式で指定してください。mcp-remoteは最初の:で引数を分割し、一部のClaude Desktopランタイムはスペースを含む引数を分割します。実際のスペースは環境変数内に入ります。

Claude DesktopのCodeタブ（埋め込みのClaude Code）は~/.claude.jsonと.mcp.jsonを読み込むため、上記のネイティブなtype: "http" + headers形式が機能します。制限があるのはチャット画面のみです。

---

ディスカバリー / Discovery

各インスタンスは認証なしで、独自のメタデータを公開します。

リソース / Resource	URL
MCPマニフェスト / MCP manifest	https://electronica.identik.me/.well-known/mcp.json
LLM向けガイド / LLM guide	https://electronica.identik.me/llms.txt
インタラクティブAPIドキュメント / Interactive API docs	https://electronica.identik.me/api/docs
OpenAPI仕様 / OpenAPI spec	https://electronica.identik.me/api/v1/openapi.json
Postmanコレクション / Postman collection	https://electronica.identik.me/api/docs/postman.json
公開PDFバリデーター / Public PDF validator	https://electronica.identik.me/validar

firma.identik.meおよびsandbox-*ホストでも、同じパスを利用できます。/api/docsの**「Agentes de IA (servidor MCP)」**セクションでは、REST APIとあわせてMCPサーバーについて説明しています。

公式 MCP レジストリ

両方のサーバーは、DNS によって identik.me の所有が確認された me.identik 名前空間で、公式 MCP レジストリに公開されています。

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

公開済みのマニフェストは servers/ にあります。

---

運用上の注意

• enviar_documento は実際の影響を伴います。 署名者にメールを送信し、文書クレジットを消費します。エージェントは、これを呼び出す前に人間の確認を求める必要があります。開発中はサンドボックスを使用してください。
• テンプレートは Web UI で作成します。 MCP は既存のテンプレートを利用しますが、フィールドレイアウトの作成や編集は行いません。
• クレジット。 estado_cuenta は利用可能なクレジットを報告します。生体認証には別のクレジットプールが使用されます。
• 保管期間。 descargar_documento_firmado は、文書の保管期間を過ぎると 410 を返します。

---

サポート

• トークン、料金、アカウント： [email protected]
• Web： https://identik.me
• これらのマニフェストに関する問題： このリポジトリのイシュー

ライセンス

このリポジトリのマニフェストとサンプルは MIT ライセンスで公開されています。Identik のサービス自体は、独自の利用規約を持つ商用ホステッド製品です。