writ

writ-mcp

Writ のゲートを MCP サーバーとして提供します。MCP 互換のエージェントに、操作の実行時点で制御を与えます。エージェントは重大な書き込みの前に 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

エージェントへの追加

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

書き込み前に確認するワークフロー

ツールの説明でエージェントにこのフローを案内していますが、要点は次のとおりです。

1. writ_check(sponsor_id, agent_id, verb, target, purpose) — 書き込みの前に呼び出します。
2. ALLOW → その書き込みに限定された 90 秒間有効な authToken が発行されます。
3. writ_verify_token(auth_token, verb, target, purpose) — 実行の直前に呼び出し、認可が実行内容と引き続き一致していることを確認します。
4. DENY → 続行しないでください。STEP_UP → 人間のスポンサーが（writ_grant またはダッシュボード経由で）承認した後、再度確認します。

ツール

ツール	対象	内容
writ_check	エージェント	判定と、目的に紐づいた 90 秒間有効なトークン
writ_verify_token	エージェント	操作実行時点でのトークン検証
writ_grant	スポンサー	STEP_UP を承認（一度限りの許可）
writ_revoke / writ_reinstate	スポンサー	プリンシパルのキルスイッチをオフ／オン
writ_receipts	エージェント	判定の監査証跡
writ_policy	エージェント	テナントの動詞ポリシー
writ_sandbox	誰でも	キー不要で使える、90 秒間有効な無料デモ用許可

キーなしで試すには、writ_sandbox → verb="demo_write" を指定して writ_check を呼び出します。

ソース

公開リポジトリ：withwrit/pywrit（mcp/ ディレクトリ）。ライセンス：MIT。

ディレクトリ掲載先：Smithery · Glama · MCP Registry io.github.withwrit/writ。