mcp-unico

Name: mcp-unico
Author: codespar

ローカル

github.com/codesparセキュリティ2754 週間前に更新

リポジトリ

mcp-unico について

mcp-unico はブラジルの本人確認サービス Unico 向けの MCP サーバーで、CPF/CNPJ 検証、書類 OCR、顔認証、ライブネス検知、PEP・制裁リスト・裁判記録のスクリーニングを提供します。README によると既定のエンドポイントが名前解決できないため非推奨とされており、現時点では実サービスに接続できません。

主な機能

01CPF と CNPJ の検証
02書類の OCR と真正性チェック
03顔照合とライブネス検知
04PEP、制裁リスト、裁判記録のスクリーニング
05Unico Score による不正リスク評価
06検証プロセスの状態照会と Webhook 管理

活用シーン

01ブラジル市場のマーケットプレイス出品者登録での本人確認（非推奨、参考用）
02KYC 規制対象フローでのスクリーニングツールの設計
03ブラジルの本人確認製品を MCP ツールに分割する際の参考

MCP 対応

本人確認に関する 18 種類のツールを MCP クライアントに公開する MCP サーバーです。OAuth 2.0 クライアントクレデンシャルで Unico の API に認証し、UNICO_BASE_URL と UNICO_AUTH_URL で接続先を変更できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "codespar-mcp-unico": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-unico"
      ],
      "env": {
        "UNICO_CLIENT_ID": "<UNICO_CLIENT_ID>",
        "UNICO_CLIENT_SECRET": "<UNICO_CLIENT_SECRET>",
        "UNICO_ENV": "<UNICO_ENV>",
        "UNICO_BASE_URL": "<UNICO_BASE_URL>",
        "UNICO_AUTH_URL": "<UNICO_AUTH_URL>"
      }
    }
  }
}

起動コマンドnpx -y @codespar/mcp-unico

設定が必要な環境変数

UNICO_CLIENT_IDUnico OAuth client_id

UNICO_CLIENT_SECRETシークレットUnico OAuth client_secret

UNICO_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.

UNICO_BASE_URLOptional override for the IDCloud/IDPay/IDCheck API base URL. Defaults to https://api.unico.co.

UNICO_AUTH_URLシークレットOptional override for the OAuth token endpoint base URL. Defaults to https://auth.unico.co.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@codespar/mcp-unico0.2.0-alpha.4stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

@codespar/mcp-unico

非推奨：稼働中のエンドポイントはありません。 2026-09-27 に、2 つの公開 DNS リゾルバー（8.8.8.8 と 1.1.1.1）を使って確認したところ、api.unico.co（API）と auth.unico.co（トークン）は DNS で解決できません。Unico の開発者向けドキュメントでは、API に api.id.unico.app / api.id.uat.unico.app、OAuth に identity.acesso.io / identityhomolog.acesso.io が記載されています。このサーバーのパスと認証はこれらを前提に実装されておらず、確認も行われていません。このサーバーのどのツールもサービスに接続できません。このパッケージは npm で非推奨となっており、参照用としてのみこのリポジトリに残されています。利用可能なエンドポイントをお持ちの場合は、UNICO_BASE_URL と UNICO_AUTH_URL を使ってサーバーの接続先を指定してください。パッケージを再び利用可能にするには、プロバイダーが公開しているベース URL を添えて mcp-dev-latam に issue を作成してください。

Unico 向け MCP サーバーです。Unico はブラジルを代表する本人確認サービスです。CPF/CNPJ の検証、書類 OCR、顔生体認証、生体検知、PEP／監視リスト／裁判記録のスクリーニングに対応しています。

CodeSpar の identity カテゴリーにおける最初のエントリーです。出品者を登録するコマースエージェント（マーケットプレイス）、高額取引を行うエージェント、KYC 規制対象のワークフローを運用するエージェントには本人確認が必要です。Unico はブラジルの標準サービスです。ブラジルを優先しつつグローバルにも対応するには、@codespar/mcp-onfido と組み合わせてください。

製品

Unico は、個別に契約する 3 つの製品を提供しています。このサーバーは 3 製品すべてのツールを公開します。エージェントは、契約で有効になっている製品のツールのみを呼び出してください（無効な製品は 403 を返します）。

製品	機能
IDCloud	Receita Federal による CPF/CNPJ の検証、書類 OCR、真正性確認
IDPay	ログインおよび支払い認証のための顔照合＋生体検知
IDCheck	PEP、制裁監視リスト、ブラジルの裁判記録

ツール（18）

ツール	目的
`validate_cpf`	IDCloud：ブラジルの CPF を Receita Federal で検証します。
`validate_cnpj`	IDCloud：ブラジルの CNPJ を Receita Federal で検証します。
`extract_document`	IDCloud：ブラジルの身分証明書画像から OCR を行い、構造化フィールドを抽出します。
`verify_document_authenticity`	IDCloud：書類画像の改ざん／偽造を検出します。
`face_match`	IDPay：ライブセルフィーと書類写真を生体認証で 1 対 1 に照合します。
`liveness_check`	IDPay：パッシブ生体検知を行います。
`check_pep`	IDCheck：重要な公的地位にある人物（PEP）のスクリーニングを行います。
`check_watchlists`	IDCheck：グローバルな制裁／ネガティブメディアのスクリーニングを行います。
`court_records_search`	IDCheck：ブラジルの司法記録を検索します。
`get_process_status`	IDCheck：Unico Web/Mobile SDK または API で以前に作成した検証プロセスのステータスを確認します。
`batch_get_process_status`	IDCheck：複数のステータスを一括照会します。
`upload_process_document`	IDCheck：実行中の検証プロセスに撮影画像をアップロードします。
`get_extracted_data`	IDCheck：完了したプロセスの構造化 OCR 結果（氏名、書類番号、発行者などの型付きフィールド）を取得します。
`get_unico_score`	IDCheck：Unico Score。Unico が算出するブラジルの本人確認詐欺リスクスコア（0～1000。数値が高いほどリスクは低い）です。
`connect_portability_check`	Connect：テナント間のポータビリティを確認します。
`register_webhook`	Webhooks：Unico のプロセスイベント（process.created、process.finished、proc...）を受信するコールバック URL を登録します。
`list_webhooks`	Webhooks：このテナントに登録されているすべての Webhook サブスクリプションを一覧表示します。
`delete_webhook`	Webhooks：Webhook サブスクリプションを削除します。

インストール

npm install @codespar/mcp-unico@alpha

環境

UNICO_CLIENT_ID="..."       # OAuth client_id
UNICO_CLIENT_SECRET="..."   # OAuth client_secret
UNICO_ENV="sandbox"         # Optional. 'sandbox' | 'production'. Default: sandbox
UNICO_BASE_URL="..."        # Optional. Default: https://api.unico.co
UNICO_AUTH_URL="..."        # Optional. Default: https://auth.unico.co

認証

OAuth 2.0 クライアントクレデンシャル。サーバーは client_id:client_secret を Basic 認証として Unico のトークンエンドポイントに送信し、有効期限の60秒前までベアラートークンをメモリ内にキャッシュします。Unico のドキュメントではサーバー側での連携のみが求められているため、これらの認証情報をブラウザーやモバイルクライアントに決して公開しないでください。

実行

# stdio (default)
npx @codespar/mcp-unico

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-unico

ステータス

0.1.0-alpha.1 としてリリースされています。Unico の REST コントラクトは devcenter.unico.io ポータルにあり、加盟店アカウントを持つ場合のみアクセスできます。ツール名と引数の形式は安定していますが、実際の認証情報を使って検証した後に、正確なエンドポイントパスが変更される可能性があります。アカウントが別のホストで提供されている場合は、UNICO_BASE_URL / UNICO_AUTH_URL を上書きしてください。実際のペイロードを確認した方からの PR を歓迎します。

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: codespar
言語: node
バージョン: 0.2.0-alpha.4
トランスポート: stdio
掲載日: 2026年9月27日
最終更新: 4 週間前
公式 Registry: io.github.codespar/mcp-unico

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

mcp-unico

mcp-unico について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@codespar/mcp-unico

製品

ツール（18）

インストール

環境

認証

実行

ステータス

エンタープライズ

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？