# mcp-rinne

MCP-сервер подключает ИИ-агента к Rinne для работы с мерчантами, картами, PIX, балансами и транзакциями.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/rinne
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-rinne

## Что делает

mcp-rinne оборачивает REST API Rinne и даёт агенту инструменты для управления мерчантами, аффилиациями и пользователями. Через него можно создавать карточные и PIX-транзакции, проводить возвраты, получать чеки, работать с балансом, выплатами, комиссиями и вебхуками. В списке 62 инструмента.

Для запуска в Claude Code нужны `RINNE_API_KEY` и пакет `@codespar/mcp-rinne`; команда установки использует `npx`. Доступны песочница через `RINNE_SANDBOX`, а также параметры `RINNE_EMAIL`, `RINNE_PASSWORD` и `RINNE_COMPANY_ID`. Сырые данные карты и CVV API не принимает: для платежа нужны зашифрованные токены из браузерного `rinne-js`, поэтому без этого шага карточная операция отклоняется.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `RINNE_API_KEY`, `RINNE_SANDBOX`, `RINNE_EMAIL`, `RINNE_PASSWORD`, `RINNE_COMPANY_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env RINNE_API_KEY=<RINNE_API_KEY> --env RINNE_SANDBOX=<RINNE_SANDBOX> --env RINNE_EMAIL=<RINNE_EMAIL> --env RINNE_PASSWORD=<RINNE_PASSWORD> --env RINNE_COMPANY_ID=<RINNE_COMPANY_ID> --transport stdio rinne -- npx -y @codespar/mcp-rinne
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add rinne --env RINNE_API_KEY=<RINNE_API_KEY> --env RINNE_SANDBOX=<RINNE_SANDBOX> --env RINNE_EMAIL=<RINNE_EMAIL> --env RINNE_PASSWORD=<RINNE_PASSWORD> --env RINNE_COMPANY_ID=<RINNE_COMPANY_ID> -- npx -y @codespar/mcp-rinne
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rinne": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-rinne"
            ],
            "env": {
                "RINNE_API_KEY": "<RINNE_API_KEY>",
                "RINNE_SANDBOX": "<RINNE_SANDBOX>",
                "RINNE_EMAIL": "<RINNE_EMAIL>",
                "RINNE_PASSWORD": "<RINNE_PASSWORD>",
                "RINNE_COMPANY_ID": "<RINNE_COMPANY_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "rinne": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-rinne"
            ],
            "env": {
                "RINNE_API_KEY": "<RINNE_API_KEY>",
                "RINNE_SANDBOX": "<RINNE_SANDBOX>",
                "RINNE_EMAIL": "<RINNE_EMAIL>",
                "RINNE_PASSWORD": "<RINNE_PASSWORD>",
                "RINNE_COMPANY_ID": "<RINNE_COMPANY_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e RINNE_API_KEY=<RINNE_API_KEY> -e RINNE_SANDBOX=<RINNE_SANDBOX> -e RINNE_EMAIL=<RINNE_EMAIL> -e RINNE_PASSWORD=<RINNE_PASSWORD> -e RINNE_COMPANY_ID=<RINNE_COMPANY_ID> rinne npx -y @codespar/mcp-rinne
```
Вместо <…> подставьте свои значения

## Когда брать
- создать и обновить мерчанта
- провести оплату картой или через PIX
- оформить полный или частичный возврат
- получить баланс, выписку и чек
- настроить комиссии и выплаты

## Примеры запросов агенту
- Создай мерчанта и его аффилиацию с платёжным провайдером.
- Покажи последние транзакции мерчанта и статус каждой оплаты.
- Проверь баланс, выписку и доступные способы выплаты.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md