three.ws Knock — MCP-сервер для платных дверей и сообщений
Платный канал к живому человеку: агент узнаёт цену двери, отправляет одно сообщение и потом читает ответ. Пригодится, когда нужно написать незнакомому человеку через агента.
claude mcp add --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio knock-mcp -- npx -y @three-ws/knock-mcpЧто делает three.ws Knock
Каждый аккаунт на three.ws может открыть дверь по адресу three.ws/knock/<handle> и сам назначить цену за одно сообщение от незнакомца. Когда цена уплачена, письмо попадает в личный ящик адресата, а его 3D-компаньон на сайте произносит сообщение вслух и называет отправителя и сумму. USDC приходит напрямую получателю.
Сервер даёт агенту шесть инструментов. knock_quote показывает цену, сети и лимит длины, knock_directory — всех, до кого можно достучаться сейчас, knock_send проводит сообщение, knock_receipt возвращает судьбу отправленного: ждёт, прочитано, отвечено или отклонено. Два оставшихся инструмента, knock_inbox и knock_act, работают с вашей собственной дверью и требуют THREE_WS_API_KEY.
Кошелька у сервера нет. На бесплатной двери knock_send отправляет сразу, потому что платить нечего. На платной он не платит и не может: возвращает получателя, сумму, токен, цепь и endpoint и останавливается, а расход подтверждает человек из своего кошелька через @three-ws/knock или другой клиент x402. Нужен Node 20+; переменные THREE_WS_BASE и THREE_WS_TIMEOUT_MS задают адрес сервиса и таймаут запроса.
Какие задачи решает
- узнать цену одного сообщения конкретному человеку
- найти, кто сейчас принимает сообщения, начиная с самых дешёвых
- отправить одно письмо незнакомцу и не переплатить
- проверить, прочитал ли адресат сообщение и что ответил
- разобрать входящие своей двери с суммами и ответить на них
Примеры запросов агенту
- Найди в
knock_directory, кто принимает вопросы про x402, и узнай у двери цену черезknock_quote. - Отправь через
knock_sendсообщение nirholas: как твой Solana-фасилитатор обрабатывает плательщика комиссии? - Проверь через
knock_receipt, ответили ли на моё последнее сообщение.
Как установить three.ws Knock
Командой платформы
claude mcp add --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio knock-mcp -- npx -y @three-ws/knock-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add knock-mcp --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/knock-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"knock-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/knock-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>",
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"knock-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/knock-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>",
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e THREE_WS_API_KEY=<THREE_WS_API_KEY> -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> knock-mcp npx -y @three-ws/knock-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о three.ws Knock
Как установить three.ws Knock в Claude Code?
Выполните claude mcp add knock-mcp -e THREE_WS_API_KEY=<THREE_WS_API_KEY> -- npx -y @three-ws/knock-mcp. Ключ нужен только для инструментов своей двери.
Что делает three.ws Knock?
Даёт агенту инструменты найти человека с открытой дверью, узнать цену одного сообщения, отправить его и прочитать ответ. Оплату на платной двери проводит человек из своего кошелька.
Может ли сервер сам списать деньги?
Нет. На платной двери knock_send только возвращает получателя, сумму, токен, цепь и endpoint, а платёж подтверждает человек через @three-ws/knock или другой клиент x402.
