# MCP · blockwallets прямо в ваших ИИ-инструментах

> Удалённый MCP-сервер blockwallets: ищите в документации по интеграции, создавайте тестовые счета, проверяйте заказы и баланс из Claude, ChatGPT, Cursor и Codex. Ни один инструмент не может вывести деньги.

Пусть Claude, ChatGPT, Cursor и Codex читают документацию, создают тестовые счета и проверяют заказы за вас. Он умеет только принимать платежи и читать данные. Вывести деньги он не может.

## Два адреса

- `https://blockwallets.io/mcp` (Нужен вход): Вход через OAuth или MCP-токен (Bearer) из кабинета. Все инструменты.
- `https://blockwallets.io/mcp/public` (Без входа): Только публичные инструменты: документация, сети, цены, разбор подписи, чек-лист интеграции.

## Коротко: интеграция, отладка и учёт — прямо в ИИ.

- Пока вы пишете интеграцию, ИИ сам читает нашу документацию и правила подписи — без копирования и вставки.
- С тестовым токеном ИИ создаёт тестовый счёт, вы симулируете оплату, а он проверяет статус от начала до конца.
- В повседневной работе спросите «сколько мы получили вчера?» или «оплачен ли order_1042?» и получите ответ.

## Скопируйте фрагмент в свой инструмент.

Токены создаются в кабинете, в разделе «Разработчикам › ИИ-инструменты (MCP)»; токен показывается один раз. Начните с тестового токена.

### Claude Code

С токеном; или уберите --header и выполните /mcp в Claude Code, чтобы войти через OAuth.

```bash
claude mcp add --transport http blockwallets https://blockwallets.io/mcp \
  --header "Authorization: Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

### Claude Code · только инструменты документации (без входа)

```bash
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
```

### Cursor · ~/.cursor/mcp.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "url": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Windsurf · ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "serverUrl": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Codex · ~/.codex/config.toml

Положите токен в переменную окружения BLOCKWALLETS_MCP_TOKEN; нужна свежая версия Codex с поддержкой MCP по HTTP.

```toml
[mcp_servers.blockwallets]
url = "https://blockwallets.io/mcp"
bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"
```

## Claude и ChatGPT: просто войдите.

### Claude (веб / десктоп)

1. Настройки → Коннекторы → Добавить свой коннектор
2. Назовите его blockwallets и укажите URL https://blockwallets.io/mcp
3. Нажмите «Подключить» и войдите в кабинет blockwallets на открывшейся странице
4. На странице согласия выберите тестовый или боевой режим и разрешение на создание счетов, затем нажмите «Разрешить»

### ChatGPT

1. Настройки → Приложения и коннекторы → Дополнительно, включите режим разработчика
2. Создайте коннектор с URL https://blockwallets.io/mcp и аутентификацией OAuth
3. Войдите в кабинет blockwallets
4. Выберите режим и права на странице согласия и нажмите «Разрешить»

Не хотите входить? Укажите https://blockwallets.io/mcp/public — будут доступны только публичные инструменты документации.

## 11 инструментов, ни один не выводит деньги.

| Инструмент | Что делает | Право |
|---|---|---|
| `search_docs` | Ищет в документации по интеграции; возвращает подходящие разделы и ссылки | публичный |
| `get_doc` | Читает раздел документации в Markdown | публичный |
| `list_networks` | Монеты и сети, подтверждения, минимальные суммы | публичный |
| `get_pricing` | Комиссии и шкала по обороту | публичный |
| `explain_signature` | Пошагово показывает расчёт подписи (никогда не принимает API key) | публичный |
| `integration_checklist` | Шаги интеграции и чек-лист приёмки под ваш стек | публичный |
| `create_payment` | Создаёт счёт и возвращает страницу оплаты (идемпотентно по order_id) | payments:create |
| `create_payment_link` | Создаёт платёжную ссылку и QR-код | payments:create |
| `get_payment` | Читает счёт по order_id или uuid | read |
| `list_payments` | Список счетов по статусу и дате | read |
| `get_balance` | Читает боевой баланс (только чтение, без вывода) | read |

## Только принимает. Никогда не отправляет.

- **Ни один инструмент не выводит деньги**: Вывода, выплат, возвратов, смены адресов вывода, URL колбэков и ключей в MCP нет, как и прав на это. Это можете сделать только вы в кабинете.
- **Начните с тестового режима**: Тестовые учётные данные создают счета только в тестовых сетях и видят только тестовые данные. Никаких реальных денег.
- **Боевой режим — только чтение**: Боевые учётные данные видят реальные заказы и балансы. Давайте только чтение, если не нужно создавать счета. Для аккаунтов с двухфакторной защитой боевые учётные данные требуют код, и мы каждый раз пишем вам на почту.
- **Отзыв в любой момент**: Токены и OAuth-разрешения — в одном списке в кабинете. Отзовите запись, и её токены сразу перестанут работать.
- **Только хэши**: Токены и коды хранятся как sha256; токен показывается один раз. Каждый вызов продавца попадает в журнал аудита, а для каждой учётной записи действует лимит 60 запросов в минуту.

## Вопросы

### Что такое MCP?

Model Context Protocol — открытый стандарт, по которому ИИ-инструменты вызывают внешние сервисы. После подключения Claude, ChatGPT, Cursor и другие могут напрямую вызывать инструменты blockwallets.

### Может ли ИИ с его помощью забрать мои деньги?

Нет. Инструментов для вывода, выплат, возвратов или смены адресов и ключей нет, и прав на такие действия не существует.

### Чем тестовый режим отличается от боевого?

Тестовый режим работает в публичных тестовых сетях с тестовыми счетами и данными; боевой — это ваш реальный аккаунт. Сначала отладьте сценарий в тестовом режиме.

### Поддерживает ли Cursor вход через OAuth?

Пока используйте в Cursor токен из кабинета. OAuth работает с клиентами, использующими перенаправление на https или loopback, например Claude, ChatGPT и Claude Code.

### Как отозвать доступ?

Найдите токен или разрешение в кабинете, в разделе «Разработчикам › ИИ-инструменты (MCP)», и отзовите его; это действует сразу.

OAuth metadata: https://blockwallets.io/.well-known/oauth-protected-resource · https://blockwallets.io/.well-known/oauth-authorization-server