mcp-sift — MCP-сервер для Claude Code: антифрод Sift
MCP-сервер, который подключает агента к Sift: события, ML-скоры и решения по мошенничеству прямо из чата.
claude mcp add --env SIFT_API_KEY=<SIFT_API_KEY> --env SIFT_ACCOUNT_ID=<SIFT_ACCOUNT_ID> --env SIFT_BASE_URL=<SIFT_BASE_URL> --transport stdio sift -- npx -y @codespar/mcp-siftЧто делает mcp-sift
Сервер даёт агенту 20 инструментов вокруг трёх API Sift. Через Events API уходят сигналы о регистрациях, логинах, заказах и чарджбэках — каждый как событие с префиксом $. Score API отдаёт последний ML-скор пользователя дробным числом от 0 до 1 по типам злоупотреблений: payment_abuse, account_abuse, content_abuse, promotion_abuse. Decisions API v3 превращает скоры в готовые решения вроде block_user_payment_abuse или approve_order_payment_abuse.
Есть отдельные обёртки под частые события: send_login, send_logout, send_chargeback, send_content_status, link_session_to_user и send_custom_event для своих типов. Скор можно пересчитать принудительно (rescore_user), а для ручного разбора — пометить пользователя меткой или снять её. Решения применяются к пользователю, заказу, сессии и элементу контента, статус запуска workflow читается отдельно.
Для работы нужны SIFT_API_KEY и SIFT_ACCOUNT_ID — второй обязателен для всех вызовов Decisions API v3. SIFT_BASE_URL необязателен и по умолчанию указывает на https://api.sift.com. Ключ передаётся сырым: для Events API сервер сам подставляет $api_key в тело запроса, для Score и Decisions — кодирует его в HTTP Basic с пустым паролем. Пакет вышел как 0.1.0-alpha.1, пути эндпоинтов сверены с официальным Ruby SDK Sift.
Какие задачи решает
- отправить сигнал о регистрации или логине в Sift
- получить ML-скор пользователя по типу злоупотребления
- применить решение workflow к заказу или сессии
- пометить пользователя как мошенника при ручном разборе
- отправить событие о подтверждённом чарджбэке
Примеры запросов агенту
- Отправь в Sift событие
$loginдля пользователя из последнего теста - Покажи текущий скор по
payment_abuseдля этого пользователя - Примени к заказу решение
block_user_payment_abuse
Как установить mcp-sift
Командой платформы
claude mcp add --env SIFT_API_KEY=<SIFT_API_KEY> --env SIFT_ACCOUNT_ID=<SIFT_ACCOUNT_ID> --env SIFT_BASE_URL=<SIFT_BASE_URL> --transport stdio sift -- npx -y @codespar/mcp-siftВместо <…> подставьте свои значения
Командой платформы
codex mcp add sift --env SIFT_API_KEY=<SIFT_API_KEY> --env SIFT_ACCOUNT_ID=<SIFT_ACCOUNT_ID> --env SIFT_BASE_URL=<SIFT_BASE_URL> -- npx -y @codespar/mcp-siftВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"sift": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-sift"
],
"env": {
"SIFT_API_KEY": "<SIFT_API_KEY>",
"SIFT_ACCOUNT_ID": "<SIFT_ACCOUNT_ID>",
"SIFT_BASE_URL": "<SIFT_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"sift": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-sift"
],
"env": {
"SIFT_API_KEY": "<SIFT_API_KEY>",
"SIFT_ACCOUNT_ID": "<SIFT_ACCOUNT_ID>",
"SIFT_BASE_URL": "<SIFT_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SIFT_API_KEY=<SIFT_API_KEY> -e SIFT_ACCOUNT_ID=<SIFT_ACCOUNT_ID> -e SIFT_BASE_URL=<SIFT_BASE_URL> sift npx -y @codespar/mcp-siftВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-sift
Как установить mcp-sift в Claude Code?
Выполните claude mcp add mcp-sift -e SIFT_API_KEY=<SIFT_API_KEY> -e SIFT_ACCOUNT_ID=<SIFT_ACCOUNT_ID> -- npx -y @codespar/mcp-sift. Второй способ — с флагом --transport stdio и переменной SIFT_BASE_URL: `claude mcp add --env SIFT_API_KEY=<SIFT_API_KEY> --env SIFT_ACCOUNT_ID=<SIFT_ACCOUNT_ID> --env SIFT_BASE_URL=<SIFT_BASE_URL> --transport stdio sift -- npx -y @codespar/mcp-sift`.
Что делает mcp-sift?
Связывает агента с антифрод-платформой Sift: отправляет события, забирает скоры и применяет решения workflow. Всего в сервере 20 инструментов.
Что нужно для работы mcp-sift?
Ключ SIFT_API_KEY и идентификатор аккаунта SIFT_ACCOUNT_ID — без второго не пройдут вызовы Decisions API v3. Адрес SIFT_BASE_URL можно не задавать, тогда используется https://api.sift.com.
