mcp-clearsale — MCP-сервер для Claude Code: как установить
Подключает агента к бразильскому антифрод-сервису ClearSale для скоринга заказов и проверки покупателей. Пригодится магазинам, принимающим платежи в Бразилии.
claude mcp add --env CLEARSALE_API_KEY=<CLEARSALE_API_KEY> --env CLEARSALE_BASE_URL=<CLEARSALE_BASE_URL> --transport stdio clearsale -- npx -y @codespar/mcp-clearsaleЧто делает mcp-clearsale
Сервер даёт агенту 18 инструментов для борьбы с мошенничеством в электронной коммерции. Через них модель отправляет данные корзины на скоринг, запрашивает числовой риск-балл от 0 до 100 и передаёт подтверждённые чарджбэки. Также доступны проверка адресов по базе Correios, валидация документов CPF или CNPJ через Receita Federal и запуск сессий цифрового отпечатка устройства.
Для работы требуется Bearer-токен в переменной CLEARSALE_API_KEY. При необходимости тестовый адрес задаётся через CLEARSALE_BASE_URL. Без коммерческого договора протестировать интеграцию не выйдет: открытой публичной песочницы у провайдера нет. По умолчанию сервер запускается через stdio, но поддерживает режим HTTP при установке переменных MCP_HTTP=true и MCP_PORT=3000.
Какие задачи решает
- проверить заказ на признаки мошенничества перед отправкой
- валидировать бразильский CPF или CNPJ через базы регулятора
- передать данные о чарджбэке для дообучения модели рисков
- запросить проверку покупателя через одноразовый пароль по SMS или почте
Примеры запросов агенту
- Проверь заказ 9481 через ClearSale и покажи итоговый скоринг риска
- Сверь адрес доставки с базой Correios и проверь статус CPF покупателя
- Отправь в ClearSale статус отмены для заказа 1042
Как установить mcp-clearsale
Командой платформы
claude mcp add --env CLEARSALE_API_KEY=<CLEARSALE_API_KEY> --env CLEARSALE_BASE_URL=<CLEARSALE_BASE_URL> --transport stdio clearsale -- npx -y @codespar/mcp-clearsaleВместо <…> подставьте свои значения
Командой платформы
codex mcp add clearsale --env CLEARSALE_API_KEY=<CLEARSALE_API_KEY> --env CLEARSALE_BASE_URL=<CLEARSALE_BASE_URL> -- npx -y @codespar/mcp-clearsaleВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"clearsale": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-clearsale"
],
"env": {
"CLEARSALE_API_KEY": "<CLEARSALE_API_KEY>",
"CLEARSALE_BASE_URL": "<CLEARSALE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"clearsale": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-clearsale"
],
"env": {
"CLEARSALE_API_KEY": "<CLEARSALE_API_KEY>",
"CLEARSALE_BASE_URL": "<CLEARSALE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CLEARSALE_API_KEY=<CLEARSALE_API_KEY> -e CLEARSALE_BASE_URL=<CLEARSALE_BASE_URL> clearsale npx -y @codespar/mcp-clearsaleВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-clearsale
Как установить mcp-clearsale в Claude Code?
Выполните команду claude mcp add mcp-clearsale -e CLEARSALE_API_KEY=<CLEARSALE_API_KEY> -- npx -y @codespar/mcp-clearsale. Если нужно настроить тестовый стенд, передайте URL: `claude mcp add --env CLEARSALE_API_KEY=<CLEARSALE_API_KEY> --env CLEARSALE_BASE_URL=<CLEARSALE_BASE_URL> --transport stdio clearsale -- npx -y @codespar/mcp-clearsale`.
Что делает mcp-clearsale?
Сервер связывает агента с API ClearSale для оценки мошеннических рисков при транзакциях в Бразилии. Он умеет анализировать заказы, валидировать идентификаторы клиентов и сохранять статус возвратов.
Есть ли у ClearSale публичная песочница для тестов?
Публичного тестового контура нет. Ссылку на staging и рабочий ключ выдают только после заключения договора, после чего адрес указывают в CLEARSALE_BASE_URL.
