mcp-unico — MCP-сервер для Claude Code: проверка личности Unico
Подключает к агенту инструменты Unico: проверка CPF/CNPJ, OCR документов, биометрия лица, скрининг PEP и судебных записей. Официальный эндпоинт больше не отвечает, поэтому сервер работает только с вашим адресом API.
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Что делает 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.
Какие задачи решает
- проверить CPF или CNPJ по базе Receita Federal
- вытащить структурированные поля из фото бразильского документа
- сверить селфи с фотографией в документе
- прогнать клиента по PEP и санкционным спискам
- подписаться на события проверки через вебхук
Примеры запросов агенту
- Проверь CPF из заявки и покажи, что вернула Receita Federal
- Сделай OCR документа из
docs/rg.jpgи выгрузи поля в JSON - Сравни
selfie.jpgс фото в паспорте и проверь liveness
Как установить mcp-unico
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-unico
Как установить mcp-unico в Claude Code?
Введите claude mcp add mcp-unico -e UNICO_CLIENT_ID=<UNICO_CLIENT_ID> -e UNICO_CLIENT_SECRET=<UNICO_CLIENT_SECRET> -- npx -y @codespar/mcp-unico. Полная форма с адресами API: `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`.
Что делает mcp-unico?
Даёт агенту инструменты Unico для верификации личности: CPF/CNPJ, OCR документов, биометрия, проверка живости, PEP и санкционные списки, судебные записи, вебхуки.
Почему сервер не отвечает?
Адреса api.unico.co и auth.unico.co не резолвятся, пакет deprecated. Если у вас есть рабочий эндпоинт, задайте его через UNICO_BASE_URL и UNICO_AUTH_URL.
