writ

本地服务

withwrit.com安全21 天前更新

代码仓库访问官网

关于 writ

writ 是面向需要在执行关键写操作前进行授权检查的 Agent 的 MCP 服务。它返回 ALLOW、DENY 或 STEP_UP 决策，验证短时有效且绑定写操作的令牌，并记录审计凭证。

主要功能

01写入前返回 ALLOW／DENY／STEP_UP
0290 秒有效且绑定写操作的授权令牌
03执行时验证令牌
04赞助者授权与主体撤销
05策略查询与决策凭证
06免密沙盒演示

适用场景

01限制 Agent 执行关键写操作
02要求赞助者批准 STEP_UP 决策
03执行前验证授权

MCP 相关

writ 向 MCP 客户端提供策略检查、令牌验证、赞助者控制和审计凭证等工具。它通过 stdio 运行；除沙盒演示外需要 Writ API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "avenuedadmin-writ": {
      "command": "uvx",
      "args": [
        "writ-mcp"
      ],
      "env": {
        "WRIT_API_KEY": "<WRIT_API_KEY>",
        "WRIT_SPONSOR_TOKEN": "<WRIT_SPONSOR_TOKEN>",
        "WRIT_BASE_URL": "<WRIT_BASE_URL>"
      }
    }
  }
}

启动命令uvx writ-mcp

需要配置的环境变量

WRIT_API_KEY密钥Writ API key (get one free at https://withwrit.com)

WRIT_SPONSOR_TOKEN密钥Writ sponsor token, only required for sponsor tools (grant, revoke, reinstate)

WRIT_BASE_URLOptional custom Writ API base URL (default: https://api.withwrit.com)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiwrit-mcp0.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填
verb	string	是
target	string	是
purpose	string	是
agent_id	string	是
sponsor_id	string	是

详细介绍

writ-mcp

Writ 的关卡，作为 MCP 服务运行。为任何兼容 MCP 的 Agent 提供操作时控制：Agent 在执行重要写入操作之前调用 Writ，获得 ALLOW、DENY 或 STEP_UP，每种结果都会生成一份审计凭证。

安装

pip install writ-mcp

需要 Python 3.9+。安装后会提供 writ-mcp 命令（stdio 传输）。

配置

export WRIT_API_KEY="writ_..."        # required; get one free: POST /v1/keys with an email
export WRIT_SPONSOR_TOKEN="..."       # only for sponsor tools (grant, revoke, reinstate)
# export WRIT_BASE_URL="..."          # default: https://api.withwrit.com

添加到你的 Agent

Claude Code：

claude mcp add writ --env WRIT_API_KEY="$WRIT_API_KEY" -- writ-mcp

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "writ": {
      "command": "writ-mcp",
      "env": { "WRIT_API_KEY": "writ_..." }
    }
  }
}

任何 MCP 客户端（通用 stdio 配置）：

{
  "command": "writ-mcp",
  "env": {
    "WRIT_API_KEY": "writ_...",
    "WRIT_SPONSOR_TOKEN": "writ_sp_..."
  }
}

Hermes（NousResearch/hermes-agent）目录条目 — 发布后，可从 optional-mcps 目录安装此软件包：

hermes mcp install writ

写入前检查流程

工具描述会引导 Agent 完成此流程，简而言之：

writ_check(sponsor_id, agent_id, verb, target, purpose) — 写入前调用。
ALLOW → 获得一个 90 秒有效、绑定到该次特定写入的 authToken。
writ_verify_token(auth_token, verb, target, purpose) — 执行前立即调用，以证明授权仍与当前操作相符。
DENY → 不要继续。STEP_UP → 由人工赞助者批准（通过 writ_grant 或控制面板），然后再次检查。

工具

工具	使用者	说明
`writ_check`	Agent	决策 + 有效期 90 秒、绑定用途的令牌
`writ_verify_token`	Agent	操作时验证令牌
`writ_grant`	赞助者	批准一次 STEP_UP（一次性授权）
`writ_revoke` / `writ_reinstate`	赞助者	为主体启用／关闭紧急开关
`writ_receipts`	Agent	决策审计记录
`writ_policy`	Agent	租户操作策略
`writ_sandbox`	任何人	免费的 90 秒演示授权，无需密钥