# mcp-unico

Подключает к агенту инструменты Unico: проверка CPF/CNPJ, OCR документов, биометрия лица, скрининг PEP и судебных записей. Официальный эндпоинт больше не отвечает, поэтому сервер работает только с вашим адресом API.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/identity/unico
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-unico

## Что делает

Пакет выпущен как `@codespar/mcp-unico` и содержит инструменты для трёх продуктов Unico: IDCloud (проверка CPF и CNPJ, извлечение полей из документов, детект подделок), IDPay (сравнение селфи с фото из документа и проверка живости) и IDCheck (PEP, санкционные списки, поиск по судам Бразилии, Unico Score). Плюс вебхуки и опрос статуса процессов, созданных через SDK или API. Вызов утилиты, которая не входит в ваш договор, вернёт 403.

Главное — сервер мёртв по умолчанию. На момент проверки `api.unico.co` и `auth.unico.co` не резолвились в DNS, а актуальные адреса у провайдера другие. Пакет помечен deprecated на npm, код оставлен для справки. Без своих значений `UNICO_BASE_URL` и `UNICO_AUTH_URL` ни один инструмент никуда не достучится.

Авторизация — OAuth 2.0 Client Credentials: нужны `UNICO_CLIENT_ID` и `UNICO_CLIENT_SECRET`, токен кэшируется в памяти. Только серверная интеграция, ключи нельзя отдавать в браузер или мобильное приложение. Запускается через `npx`, по умолчанию stdio, есть режим HTTP через `MCP_HTTP=true` и `MCP_PORT`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `UNICO_CLIENT_ID`, `UNICO_CLIENT_SECRET`, `UNICO_ENV`, `UNICO_BASE_URL`, `UNICO_AUTH_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env UNICO_CLIENT_ID=<UNICO_CLIENT_ID> --env UNICO_CLIENT_SECRET=<UNICO_CLIENT_SECRET> --env UNICO_ENV=<UNICO_ENV> --env UNICO_BASE_URL=<UNICO_BASE_URL> --env UNICO_AUTH_URL=<UNICO_AUTH_URL> --transport stdio unico -- npx -y @codespar/mcp-unico
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add unico --env UNICO_CLIENT_ID=<UNICO_CLIENT_ID> --env UNICO_CLIENT_SECRET=<UNICO_CLIENT_SECRET> --env UNICO_ENV=<UNICO_ENV> --env UNICO_BASE_URL=<UNICO_BASE_URL> --env UNICO_AUTH_URL=<UNICO_AUTH_URL> -- npx -y @codespar/mcp-unico
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "unico": {
            "type": "stdio",
            "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e UNICO_CLIENT_ID=<UNICO_CLIENT_ID> -e UNICO_CLIENT_SECRET=<UNICO_CLIENT_SECRET> -e UNICO_ENV=<UNICO_ENV> -e UNICO_BASE_URL=<UNICO_BASE_URL> -e UNICO_AUTH_URL=<UNICO_AUTH_URL> unico npx -y @codespar/mcp-unico
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить CPF или CNPJ по базе Receita Federal
- вытащить структурированные поля из фото бразильского документа
- сверить селфи с фотографией в документе
- прогнать клиента по PEP и санкционным спискам
- подписаться на события проверки через вебхук

## Примеры запросов агенту
- Проверь CPF из заявки и покажи, что вернула Receita Federal
- Сделай OCR документа из `docs/rg.jpg` и выгрузи поля в JSON
- Сравни `selfie.jpg` с фото в паспорте и проверь liveness

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109
- [Robin: AI-Powered Dark Web OSINT](https://affpapa.org/nevibecode/mcp/robin-ai-powered-dark-web-osint.md) — MCP-сервер · ★ 7658
- [jshookmcp](https://affpapa.org/nevibecode/mcp/jshookmcp.md) — MCP-сервер · ★ 2061
- [OpenOSINT](https://affpapa.org/nevibecode/mcp/openosint.md) — MCP-сервер · ★ 1802

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md