x402 Wallet — MCP-сервер для Claude Code: функции и установка
Сервер помогает ИИ-агенту находить платные сервисы x402, проверять цену и оплачивать вызов в USDC с ключа Solana. Для платежей задайте ключ кошелька и лимит расходов.
claude mcp add --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env MAX_PAY_USD=<MAX_PAY_USD> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> --env THREE_WS_BASE=<THREE_WS_BASE> --transport stdio x402-mcp -- npx -y @three-ws/x402-mcpЧто делает x402 Wallet
x402 Wallet даёт агенту инструменты для поиска сервисов в каталоге x402, проверки требований к оплате и вызова платного endpoint. Есть отдельные инструменты для прогноза погоды, поиска исследований и книг, новостей, транспорта и мест. Баланс кошелька и отчёт о платежах тоже доступны через инструменты сервера.
Для оплаты нужен SOLANA_SECRET_KEY; поиск и проверка endpoint работают без него. Платежи проходят только для Solana с exact-схемой, а сервер сначала проверяет цену и блокирует сумму выше MAX_PAY_USD (по умолчанию $1). При включённом REQUIRE_CONFIRM вызов требует confirm: true. Это важно: платёж подписывается вашим ключом.
В Claude Code сервер запускается через npx -y @three-ws/x402-mcp. Можно также настроить SOLANA_RPC_URL, лимит платежа и требование подтверждения; доступна установка в Codex, Cursor и другие перечисленные редакторы.
Какие задачи решает
- найти платные HTTP- и MCP-сервисы x402
- проверить стоимость endpoint до оплаты
- вызвать сервис и оплатить запрос в USDC
- посмотреть баланс кошелька и историю расходов
Примеры запросов агенту
- Найди сервисы x402 для поиска научных статей.
- Проверь цену этого endpoint, не оплачивая вызов.
- Оплати вызов сервиса прогноза погоды и покажи результат.
Как установить x402 Wallet
Командой платформы
claude mcp add --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env MAX_PAY_USD=<MAX_PAY_USD> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> --env THREE_WS_BASE=<THREE_WS_BASE> --transport stdio x402-mcp -- npx -y @three-ws/x402-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add x402-mcp --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env MAX_PAY_USD=<MAX_PAY_USD> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> --env THREE_WS_BASE=<THREE_WS_BASE> -- npx -y @three-ws/x402-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"MAX_PAY_USD": "<MAX_PAY_USD>",
"REQUIRE_CONFIRM": "<REQUIRE_CONFIRM>",
"THREE_WS_BASE": "<THREE_WS_BASE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"x402-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"MAX_PAY_USD": "<MAX_PAY_USD>",
"REQUIRE_CONFIRM": "<REQUIRE_CONFIRM>",
"THREE_WS_BASE": "<THREE_WS_BASE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e MAX_PAY_USD=<MAX_PAY_USD> -e REQUIRE_CONFIRM=<REQUIRE_CONFIRM> -e THREE_WS_BASE=<THREE_WS_BASE> x402-mcp npx -y @three-ws/x402-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о x402 Wallet
Как установить x402 Wallet в Claude Code?
Выполните claude mcp add x402-mcp -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/x402-mcp. Для дополнительных параметров используйте отдельный способ установки с SOLANA_RPC_URL, MAX_PAY_USD, REQUIRE_CONFIRM и THREE_WS_BASE.
Что делает x402 Wallet?
Он позволяет агенту искать платные сервисы x402, заранее читать условия оплаты и вызывать endpoint с оплатой в USDC. Также сервер предоставляет инструменты для конкретных сервисов и отчёт о расходах.
Нужен ли ключ Solana для поиска сервисов?
Нет, find_services и inspect_endpoint работают без ключа. Для оплаты через pay_and_call нужен SOLANA_SECRET_KEY, если не используется режим с session_token.
