mcp-konduto — MCP-сервер для Claude Code: антифрод Konduto
MCP-сервер, через который агент отправляет заказы в Konduto на проверку, читает вердикт и ведёт списки блокировок. Нужен, когда антифрод-логика живёт в чате с агентом.
claude mcp add --env KONDUTO_API_KEY=<KONDUTO_API_KEY> --env KONDUTO_BASE_URL=<KONDUTO_BASE_URL> --transport stdio konduto -- npx -y @codespar/mcp-kondutoЧто делает mcp-konduto
Сервер закрывает 18 инструментов Konduto: отправка заказа на анализ, получение текущего состояния проверки, уведомление о финальном статусе заказа, сообщение о чарджбэке и три набора списков — blocklist, allowlist и reviewlist с добавлением, проверкой, правкой срока и удалением.
Авторизация — HTTP Basic, ключ идёт как логин с пустым паролем. Сервер сам кодирует его в base64, поэтому в KONDUTO_API_KEY передавайте сырое значение. Понадобится ключ Konduto, без него сервер к API не подключится. База по умолчанию — https://api.konduto.com/v1, переопределяется через KONDUTO_BASE_URL.
Для оценки поведения заказа нужен visitor id: его выдаёт браузерный JS SDK Konduto, встроенный на страницу оформления. Обратная связь по чарджбэкам идёт не отдельным эндпоинтом, а через update_order_status со статусом fraud — это и есть канал обучения модели. Пакет выпущен как 0.1.0-alpha.1: работа с заказами и списками проверена по документации, часть методов собрана по общему REST-шаблону.
Какие задачи решает
- отправить заказ в Konduto на скоринг прямо из агента
- узнать текущий вердикт по конкретному заказу
- сообщить в Konduto финальный статус заказа после доставки или отмены
- заблокировать e-mail, IP или пару BIN+last4 из подтверждённого мошенничества
- добавить доверенное значение в allowlist, чтобы не уходить в ручную проверку
Примеры запросов агенту
- Отправь заказ
order-1042на анализ в Konduto и покажи вердикт - Проверь, есть ли
[email protected]в blocklist Konduto - Переведи заказ
order-1042в статусfraud, чарджбэк подтверждён
Как установить mcp-konduto
Командой платформы
claude mcp add --env KONDUTO_API_KEY=<KONDUTO_API_KEY> --env KONDUTO_BASE_URL=<KONDUTO_BASE_URL> --transport stdio konduto -- npx -y @codespar/mcp-kondutoВместо <…> подставьте свои значения
Командой платформы
codex mcp add konduto --env KONDUTO_API_KEY=<KONDUTO_API_KEY> --env KONDUTO_BASE_URL=<KONDUTO_BASE_URL> -- npx -y @codespar/mcp-kondutoВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"konduto": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-konduto"
],
"env": {
"KONDUTO_API_KEY": "<KONDUTO_API_KEY>",
"KONDUTO_BASE_URL": "<KONDUTO_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"konduto": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-konduto"
],
"env": {
"KONDUTO_API_KEY": "<KONDUTO_API_KEY>",
"KONDUTO_BASE_URL": "<KONDUTO_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KONDUTO_API_KEY=<KONDUTO_API_KEY> -e KONDUTO_BASE_URL=<KONDUTO_BASE_URL> konduto npx -y @codespar/mcp-kondutoВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-konduto
Как установить mcp-konduto в Claude Code?
Одна команда: claude mcp add mcp-konduto -e KONDUTO_API_KEY=<KONDUTO_API_KEY> -- npx -y @codespar/mcp-konduto. Второй вариант с явным транспортом и базовым URL: `claude mcp add --env KONDUTO_API_KEY=<KONDUTO_API_KEY> --env KONDUTO_BASE_URL=<KONDUTO_BASE_URL> --transport stdio konduto -- npx -y @codespar/mcp-konduto`.
Что делает mcp-konduto?
Даёт агенту доступ к API антифрода Konduto: отправка заказа на анализ, чтение вердикта, финальный статус, отчёт о чарджбэке и работа с blocklist, allowlist и reviewlist.
Что нужно, чтобы сервер заработал?
Ключ Konduto в KONDUTO_API_KEY и visitor id от браузерного JS SDK на странице оформления заказа, если вы хотите учитывать поведенческий сигнал.
