Onchain Agent Wallets — MCP-сервер для Claude Code: как настроить
MCP-сервер выделяет ИИ-агенту лимит расходов в сети Solana без передачи приватного ключа от основного счёта. Помогает безопасно оплачивать вызовы x402 и переводы.
claude mcp add --env OWNER_SECRET_KEY=<OWNER_SECRET_KEY> --env OAW_NETWORK=<OAW_NETWORK> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env OAW_STATE_DIR=<OAW_STATE_DIR> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> --transport stdio onchain-agent-wallets -- npx -y @three-ws/onchain-agent-walletsЧто делает Onchain Agent Wallets
Сервер разворачивает хранилище токенов, которым владеет пользователь, и оформляет для агента делегирование через стандартную программу SPL Token. Агент получает собственную ключевую пару только с небольшим запасом SOL для комиссий, а расходовать токены может строго в пределах заданного потолка. Если ключ агента скомпрометирован, потери ограничены остатком лимита, а отзыв прав выполняется одной транзакцией.
Перед отправкой транзакции инструмент проверяет локальные правила: лимит на одну операцию, суточный лимит, списки разрешённых адресов получателей и хостов для протокола x402. Любые действия по отзыву, созданию кошельков и выводу средств подписываются владельцем хранилища.
Без собственного RPC-узла Solana публичный эндпоинт быстро упирается в лимиты по запросам. Владельцу не обязательно сохранять свой закрытый ключ в переменную OWNER_SECRET_KEY — неподписанные транзакции можно подтверждать вручную через Phantom или другой внешний кошелёк.
Какие задачи решает
- ограничить бюджет ИИ-агента в токенах Solana через ончейн-делегирование
- защитить основной кошелёк от утечки ключей при работе автономных скриптов
- оплачивать платные вызовы API по протоколу x402
- установить локальные суточные лимиты и списки разрешённых получателей
- отозвать права агента на расходование средств и вернуть баланс одной командой
Примеры запросов агенту
- Создай кошелёк агента researcher с лимитом 100 USDC и суточным потолком 20 через инструмент
create_agent_wallet. - Проверь текущий остаток лимита и историю трат агента с помощью
agent_wallet_status. - Оплати доступ к API через вызов
pay_x402для хостаapi.example.com.
Как установить Onchain Agent Wallets
Командой платформы
claude mcp add --env OWNER_SECRET_KEY=<OWNER_SECRET_KEY> --env OAW_NETWORK=<OAW_NETWORK> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env OAW_STATE_DIR=<OAW_STATE_DIR> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> --transport stdio onchain-agent-wallets -- npx -y @three-ws/onchain-agent-walletsВместо <…> подставьте свои значения
Командой платформы
codex mcp add onchain-agent-wallets --env OWNER_SECRET_KEY=<OWNER_SECRET_KEY> --env OAW_NETWORK=<OAW_NETWORK> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env OAW_STATE_DIR=<OAW_STATE_DIR> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> -- npx -y @three-ws/onchain-agent-walletsВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"onchain-agent-wallets": {
"command": "npx",
"args": [
"-y",
"@three-ws/onchain-agent-wallets"
],
"env": {
"OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>",
"OAW_NETWORK": "<OAW_NETWORK>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"OAW_STATE_DIR": "<OAW_STATE_DIR>",
"REQUIRE_CONFIRM": "<REQUIRE_CONFIRM>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"onchain-agent-wallets": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/onchain-agent-wallets"
],
"env": {
"OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>",
"OAW_NETWORK": "<OAW_NETWORK>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"OAW_STATE_DIR": "<OAW_STATE_DIR>",
"REQUIRE_CONFIRM": "<REQUIRE_CONFIRM>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OWNER_SECRET_KEY=<OWNER_SECRET_KEY> -e OAW_NETWORK=<OAW_NETWORK> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e OAW_STATE_DIR=<OAW_STATE_DIR> -e REQUIRE_CONFIRM=<REQUIRE_CONFIRM> onchain-agent-wallets npx -y @three-ws/onchain-agent-walletsВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Onchain Agent Wallets
Как установить Onchain Agent Wallets в Claude Code?
Выполните команду claude mcp add onchain-agent-wallets -e OWNER_SECRET_KEY=<OWNER_SECRET_KEY> -- npx -y @three-ws/onchain-agent-wallets.
Что делает Onchain Agent Wallets?
Сервер выделяет агенту ограниченный лимит на расходы токенов SPL в Solana. Деньги остаются на вашем счёте, а агент не имеет доступа к вашему основному приватному ключу.
Обязательно ли указывать закрытый ключ владельца в настройках?
Переменная OWNER_SECRET_KEY необязательна. Если её не задавать, сервер генерирует неподписанные транзакции, которые можно вручную подписать во внешнем кошельке вроде Phantom.
