three.ws Provenance — MCP-сервер для Claude Code: как настроить
Фиксирует действия ИИ-агентов в неизменяемом журнале с подписью кошельком EVM. Нужен для аудита чужих агентов и доказательства авторства операций.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_TOKEN=<THREE_WS_TOKEN> --env THREE_WS_SIGNER_KEY=<THREE_WS_SIGNER_KEY> --transport stdio provenance-mcp -- npx -y @three-ws/provenance-mcpЧто делает three.ws Provenance
Сервер связывает ИИ-ассистента с реестром three.ws для фиксации событий. Каждое действие заносится в неизменяемый журнал, откуда записи нельзя удалить или отредактировать. При наличии ключа EVM сервер формирует каноническую структуру объекта, считает хеш SHA-256 и подписывает его по стандарту ERC-191. Это позволяет доказать авторство шага математически, а не просто верить агенту на слово.
В набор входят три инструмента. Инструмент append_agent_action отправляет новую запись в журнал, причём повторный вызов создаёт новое событие, а не перезаписывает старое. Чтение организовано через list_agent_actions с курсорной пагинацией и query_action для отдельного ID. Оба инструмента чтения автоматически запускают ecrecover и проверяют соответствие адреса подписанта.
Для работы потребуется Node.js версии не ниже 20 и сетевое подключение к https://three.ws. Без токена THREE_WS_TOKEN ни одна операция не выполнится: реестр изолирует данные по владельцу учётной записи.
Какие задачи решает
- зафиксировать выполненное агентом действие с криптографической подписью
- проверить подлинность истории стороннего или форкнутого ассистента
- отследить цепочку событий агента с постраничной пагинацией
- восстановить публичный адрес подписанта через
ecrecoverдля аудита
Примеры запросов агенту
- Проверь через
query_action, кто подписал действие 10482 у агента6a7d0f2c-1b3e-4a55-9c88-2d41b0f7e913. - Выведи список последних 20 записей для агента
6a7d0f2c-1b3e-4a55-9c88-2d41b0f7e913черезlist_agent_actions. - Зафиксируй действие типа
launchдля агента6a7d0f2c-1b3e-4a55-9c88-2d41b0f7e913с помощьюappend_agent_action.
Как установить three.ws Provenance
Командой платформы
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_TOKEN=<THREE_WS_TOKEN> --env THREE_WS_SIGNER_KEY=<THREE_WS_SIGNER_KEY> --transport stdio provenance-mcp -- npx -y @three-ws/provenance-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add provenance-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_TOKEN=<THREE_WS_TOKEN> --env THREE_WS_SIGNER_KEY=<THREE_WS_SIGNER_KEY> -- npx -y @three-ws/provenance-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"provenance-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/provenance-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
"THREE_WS_TOKEN": "<THREE_WS_TOKEN>",
"THREE_WS_SIGNER_KEY": "<THREE_WS_SIGNER_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"provenance-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/provenance-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
"THREE_WS_TOKEN": "<THREE_WS_TOKEN>",
"THREE_WS_SIGNER_KEY": "<THREE_WS_SIGNER_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -e THREE_WS_TOKEN=<THREE_WS_TOKEN> -e THREE_WS_SIGNER_KEY=<THREE_WS_SIGNER_KEY> provenance-mcp npx -y @three-ws/provenance-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о three.ws Provenance
Как установить three.ws Provenance в Claude Code?
Выполните команду claude mcp add provenance-mcp -e THREE_WS_TOKEN=<THREE_WS_TOKEN> -e THREE_WS_SIGNER_KEY=<THREE_WS_SIGNER_KEY> -- npx -y @three-ws/provenance-mcp, подставив свои значения переменных.
Что делает MCP-сервер three.ws Provenance?
Он предоставляет инструменты для добавления записей в защищённый журнал three.ws и проверки цифровых подписей действий агентов через ERC-191.
Какие требования нужны для запуска сервера?
Требуется среда Node.js от версии 20, доступ к адресу https://three.ws и действующий токен THREE_WS_TOKEN. Для подписи действий также передаётся THREE_WS_SIGNER_KEY.
