Grip MCP

Предоставьте Claude (или любому другому агенту, совместимому с MCP) некастодиальный кошелек USDC в сети Base — с обязательным подтверждением каждого платежа человеком.

Что это такое

@grip-foundation/grip-mcp — это сервер Model Context Protocol, который предоставляет четыре инструмента любому клиенту с поддержкой MCP (Claude Desktop, Claude Code, Continue и т. д.):

Агент никогда не переводит деньги без вашего участия. Процесс выглядит так: агент подготавливает платеж → вы подтверждаете его в чате → агент завершает транзакцию. Программного автоматического подтверждения не существует.

Related MCP server: clawpay-mcp

Установка

Вариант 1 — через npx (после первой публикации)

В файле ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
 "mcpServers": {
 "grip": {
 "command": "npx",
 "args": ["-y", "@grip-foundation/grip-mcp"]
 }
 }
}

Вариант 2 — локальное клонирование

git clone https://github.com/grip-foundation/grip-mcp.git
cd grip-mcp
pnpm install
pnpm run build

Затем укажите Claude Desktop путь к собранному файлу:

{
 "mcpServers": {
 "grip": {
 "command": "node",
 "args": ["/absolute/path/to/grip-mcp/dist/server/index.js"]
 }
 }
}

После редактирования конфигурации перезапустите Claude Desktop.

Первый запуск

При первом запуске сервер генерирует совершенно новый закрытый ключ EOA и сохраняет его в ~/.grip-mcp/agent-key (режим 0600). Этот ключ управляет смарт-аккаунтом.

В Claude спросите:

Show me my Grip wallet

Claude вызовет grip_wallet и ответит, указав адрес вашего смарт-аккаунта, баланс и лимиты. Чтобы пополнить кошелек, отправьте USDC в сети Base на этот адрес.

Совершение платежа

После пополнения счета попросите Claude о чем-то вроде:

Send 5 USDC to 0xba14744FfD57FA7d03b20D4c8BeDAaC301E865d1

Claude сделает следующее:

1. Вызовет grip_create_payment для подготовки платежа вне сети.

2. Покажет вам детали (сумма, получатель, примечание) и попросит подтверждения.

3. Будет ждать вашего ответа.

4. Если вы скажете "approve" → вызовет grip_settle_payment(token, "approve") → выполнит транзакцию в сети Base.

5. Если вы скажете "no" → вызовет grip_settle_payment(token, "reject") → никаких действий в сети не будет.

Хэш транзакции и ссылка на Basescan будут возвращены после завершения платежа.

Конфигурация

Модель безопасности

• Некастодиальность. Grip Foundation не хранит ваши ключи, ваши USDC или какие-либо записи о ваших платежах. Все работает на вашем устройстве.

• Управляемый пеймастер, без регистрации. Комиссия за газ оплачивается в USDC через пеймастер Pimlico, маршрутизируемый через прокси-сервер Grip. Вам не нужна учетная запись Pimlico.

• Участие человека обеспечивается протоколом, а не моделью. grip_create_payment только подготавливает платеж. grip_settle_payment — это отдельный вызов инструмента. Большинство MCP-клиентов (включая Claude Desktop) запрашивают подтверждение человека перед выполнением вызовов инструментов — это второй уровень защиты.

• Лимиты принудительно устанавливаются на стороне сервера. Даже если модель попытается совершить платеж, превышающий ваш лимит на транзакцию или дневной лимит, сервер откажется его подготавливать.

Архитектура

Claude Desktop
 │ MCP (stdio)
 ▼
grip-mcp (this server)
 │ @grip-labs/sdk
 ▼
Grip-managed paymaster proxy → Pimlico bundler → Base mainnet
 ▲
 Coinbase Smart Wallet
 (your smart account)

Смарт-аккаунт — это Coinbase Smart Wallet (ERC-4337) в сети Base. Первый платеж с нового кошелька запускает однократную операцию UserOp для развертывания аккаунта и одобрения пеймастера для компенсации USDC; последующие UserOp оплачиваются в USDC.

Известные проблемы

Первый платеж может потребовать повторной попытки. В @grip-labs/sdk@0.4 начальная UserOp (развертывание + одобрение пеймастера) и фактическая UserOp перевода отправляются как две отдельные операции. Существует небольшое окно состояния гонки, когда внутренний метод viem getFactoryArgs() считывает устаревшие данные getCode из публичного RPC после того, как начальная операция была подтверждена в бандлере Pimlico — затем viem включает initCode во вторую UserOp, и бандлер отклоняет ее с ошибкой AA10 sender already constructed.

Если ваш первый платеж завершился с этой ошибкой, просто попросите агента повторить попытку. Повторная попытка будет успешной, так как состояние в сети к тому времени обновится. Последующие платежи с того же кошелька проходят без проблем — начальная настройка выполняется не более одного раза для каждого кошелька.

Исправление будет включено в @grip-labs/sdk@0.5, которое объединяет начальную настройку и первый перевод в одну спонсируемую UserOp с использованием executeBatch, что исключает состояние гонки по определению и экономит около 30% газа на первом платеже. grip-mcp получит это обновление в версии 0.1.1.

Лицензия

MIT

Разработчик

Grip Foundation · открытая инфраструктура идентификации и платежей для ИИ-агентов.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• grip_create_paymentA
• grip_list_paymentsA
• grip_settle_paymentA
• grip_walletA