mcp-onfido — MCP-сервер для Claude Code: что делает и как установить
Интегрирует проверку личности и KYC через Onfido в ИИ-ассистентов. Позволяет создавать анкеты, загружать документы и запускать скоринг прямо в чате.
claude mcp add --env ONFIDO_API_TOKEN=<ONFIDO_API_TOKEN> --env ONFIDO_REGION=<ONFIDO_REGION> --transport stdio onfido -- npx -y @codespar/mcp-onfidoЧто делает mcp-onfido
Сервер связывает ассистента с Onfido API v3.6 и даёт 20 инструментов для верификации клиентов в 195+ странах. Через команды агент регистрирует заявителей, передаёт сканы паспортов или удостоверений, отправляет селфи и запрашивает отчёты. Поддерживается запуск сценариев Onfido Studio и генерация токенов для клиентских SDK.
Файлы документов и фото передаются в кодировке base64, после чего инструмент сам собирает multipart/form-data. Сервер умеет работать через стандартный ввод-вывод или запускаться по HTTP на порту 3000. Доступны региональные эндпоинты для Европы, США и Канады через переменную ONFIDO_REGION.
Без секретного ключа ONFIDO_API_TOKEN вызовы API завершатся ошибкой. Учтите: прямая отправка селфи через вызовы API бывает заблокирована в некоторых аккаунтах Onfido. В таком случае надёжнее запрашивать токен для веб- или мобильного SDK.
Какие задачи решает
- автоматизировать KYC-верификацию пользователей через Onfido
- загружать сканы документов и селфи в формате base64
- проверять статус проверок и скачивать детальные отчёты
- генерировать временные токены для мобильного и веб-SDK
- запускать процессы Onfido Studio из сценариев агента
Примеры запросов агенту
- Создай заявителя в Onfido для Джона Доу с почтой [email protected]
- Загрузи паспорт из
passport.jpgдля заявителяapp_123и запусти проверку документов - Выпусти SDK-токен для пользователя
app_123, чтобы встроить веб-форму проверки
Как установить mcp-onfido
Командой платформы
claude mcp add --env ONFIDO_API_TOKEN=<ONFIDO_API_TOKEN> --env ONFIDO_REGION=<ONFIDO_REGION> --transport stdio onfido -- npx -y @codespar/mcp-onfidoВместо <…> подставьте свои значения
Командой платформы
codex mcp add onfido --env ONFIDO_API_TOKEN=<ONFIDO_API_TOKEN> --env ONFIDO_REGION=<ONFIDO_REGION> -- npx -y @codespar/mcp-onfidoВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"onfido": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-onfido"
],
"env": {
"ONFIDO_API_TOKEN": "<ONFIDO_API_TOKEN>",
"ONFIDO_REGION": "<ONFIDO_REGION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"onfido": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-onfido"
],
"env": {
"ONFIDO_API_TOKEN": "<ONFIDO_API_TOKEN>",
"ONFIDO_REGION": "<ONFIDO_REGION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ONFIDO_API_TOKEN=<ONFIDO_API_TOKEN> -e ONFIDO_REGION=<ONFIDO_REGION> onfido npx -y @codespar/mcp-onfidoВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-onfido
Как установить mcp-onfido в Claude Code?
Выполните команду claude mcp add mcp-onfido -e ONFIDO_API_TOKEN=<ONFIDO_API_TOKEN> -- npx -y @codespar/mcp-onfido.
Что делает mcp-onfido?
Он предоставляет 20 инструментов для полного цикла KYC: создание анкеты, загрузка удостоверений, сопоставление лиц и получение отчётов.
Какие регионы Onfido поддерживает сервер?
Кроме стандартного хоста доступны площадки в ЕС, США и Канаде через параметр ONFIDO_REGION со значениями eu, us или ca.
