# mcp-stripe-acp

Подключает Stripe к агенту: чекаут по протоколу ACP, платёжные ссылки, счета, подписки и каталог товаров. Нужен, если агент должен проводить покупки или собирать корзину.

- 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/stripe-acp
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-stripe-acp

## Что делает

Сервер даёт агенту 24 инструмента. Часть из них закрывает операции протокола ACP: `create_checkout`, `get_checkout`, `update_checkout`, `complete_checkout` и `cancel_checkout`. Остальное — обычный Stripe API: клиенты, товары, цены, счета, подписки, купоны, возвраты, споры и баланс счёта.

Чекаут идёт в несколько шагов. Агент создаёт сессию с товарами и данными покупателя, продавец возвращает цены и варианты доставки, потом агент обновляет адрес и выбирает доставку. Когда сессия доходит до состояния «ready_for_payment», агент отправляет платёжный токен и завершает покупку.

Для работы нужен секретный ключ Stripe в `STRIPE_API_KEY`; для разработки в README советуют тестовый `sk_test_...`. Инструменты ACP дополнительно требуют `STRIPE_ACP_BASE` с адресом вашего ACP-эндпоинта, без него эти вызовы не пойдут. Запуск через `npx`, конфигурация прописывается в `claude_desktop_config.json`, `.cursor/mcp.json` или `.vscode/mcp.json`.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add mcp-stripe-acp -e STRIPE_API_KEY=<STRIPE_API_KEY> -- npx -y @codespar/mcp-stripe-acp
```
Вместо <…> подставьте свои значения

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- создать ACP-сессию чекаута с товарами и данными покупателя
- довести сессию до оплаты: выбрать доставку и отправить платёжный токен
- выставить счёт клиенту и финализировать его к оплате
- завести подписку на повторяющуюся цену или отменить её
- посмотреть споры и возвраты по платежам

## Примеры запросов агенту
- Создай ACP-сессию чекаута для двух товаров и покажи варианты доставки
- Обнови чекаут: выбери стандартную доставку и подставь адрес из профиля клиента
- Создай черновик счёта для этого клиента и добавь строку за консультацию

## Похожие
- [mcp-stripe](https://affpapa.org/nevibecode/skills/mcp-stripe.md) — скилл · 745 установок
- [stripe-payments](https://affpapa.org/nevibecode/skills/jezweb-stripe-payments.md) — скилл · 1100 установок
- [stripe](https://affpapa.org/nevibecode/plugins/stripe-stripe.md) — плагин · ★ 7604
- [stripe-directory](https://affpapa.org/nevibecode/skills/stripe-stripe-directory.md) — скилл · 4200 установок
- [stripe-pay](https://affpapa.org/nevibecode/skills/stripe-pay.md) — скилл · 576 установок
- [extension-stripe](https://affpapa.org/nevibecode/skills/extension-stripe.md) — скилл · 28200 установок

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

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