privacyops

PrivacyOps

Seaynic Labs が開発しました。 このようなツールをご自身のシステム向けに構築したい場合は、こちらをご覧ください。

PrivacyOps を使うと、AI アシスタントが信用情報レポートに関する異議申し立てを追跡し、異議申し立ての手紙を作成できます。すべての記録は、ご自身のコンピューター上のファイルに保存されます。未解決の申し立てごとに法定の回答期限を算出し、事実の収集からフォローアップまで、申し立ての手順を案内するスキルも付属しています。

法的助言ではありません。 PrivacyOps は、追跡と文書作成を支援するツールです。お客様の個別事情や、お住まいの州の法律について把握しているわけではありません。手紙のテンプレートは弁護士による審査を受けていません。 法律に関する質問は、弁護士または消費者保護機関にご相談ください。

セキュリティカード
ネットワーク	なし。PrivacyOps は外部へのネットワーク接続を行わず、テレメトリーもありません。--transport http の場合に限り、--host を変更しない限り 127.0.0.1 でリスナーを起動します。
ファイル	設定ファイル（存在する場合は ~/.config/privacyops/config.toml）を読み込みます。データフォルダー（~/.local/share/privacyops）内の記録ファイルと手紙のテキストファイルを読み書きします。これらのファイルは所有者のみがアクセスできます。承認の判断ごとに 1 行を ~/.local/state/privacyops/approvals.jsonl に追記します（ID のみ）。
シークレット	PrivacyOps はパスワードや API キーを保存せず、それらを受け取るツールもありません。社会保障番号を尋ねることもありません。
読み取り専用ツール	5 個：disputes_list、disputes_get、disputes_deadlines、letters_templates、privacyops_modules
このコンピューター上での書き込み	disputes_create、disputes_update、letters_generate：ローカルファイルのみを対象とし、承認は不要です。異議申し立てを変更するたびに、その内容が履歴に記録されます。
承認が必要	disputes_delete：アプリで削除のたびに承認するか、設定で事前承認します。AI がユーザーに代わって承認することはできません。
起動時のコスト	約 5,900 トークン（9 個のツール、2 個のスキルプロンプト）
変更	ツールの説明はハッシュで固定されています（tool-manifest.lock.json）。説明が知らないうちに変更された場合、CI で失敗します。

これは、ツール、スキル、手順をひとつにまとめたバンドルです。ツールは、モジュールで構成された 1 つのサーバーです。使用するモジュールを有効にします。新しいモジュールは無効の状態で追加されるため、ユーザーが選択するまでは、更新によってアシスタントにできることが変わることはありません。

モジュール	機能	状態
disputes	消費者信用情報機関（Equifax、Experian、TransUnion）および情報提供会社（各機関に情報を報告する企業）への異議申し立てを追跡します。状況、送付日、回答期限、変更履歴を記録します	0.2
letters	固定の 2 種類のテンプレートから異議申し立ての手紙を作成し、コンピューター上にテキストファイルとして保存します	0.1

今後の予定であり、まだ開発されていないもの：データブローカーのオプトアウト機能と信用情報の凍結ツールです。これらはアイデアであり、提供を確約するものではありません。

対象ユーザー： 異議申し立てを自分で記録し、明確な手紙を作成したい消費者です。PrivacyOps は弁護士、信用修復業者、他者の個人情報を扱う人を対象としていません。

スキル

スキルは、アシスタントが作業の前に読む短いガイドです。PrivacyOps には、1 つのソースから 2 つの形式で提供されるスキルが 2 つ付属しています。Agent Skills を読み込むアプリ（Claude Code など）向けの skills/ フォルダーと、それ以外のすべての MCP アプリ向けの MCP プロンプトです。

スキル	内容	作成者
getting-started	セットアップ、データフォルダー、設定、--doctor、エラーの読み方	Seaynic Labs、MIT
dispute-walkthrough	事実の収集、機関または企業への申し立て方法の選択、書留郵便、期限、フォローアップ、支援を求めるタイミング	Seaynic Labs、MIT

PrivacyOps にサードパーティ製のスキルは付属していません。CREDITS.md をご覧ください。

コンピューターに保存される内容

• 異議申し立ての記録は、データフォルダー内の1つのJSONファイルに保存されます。デフォルト：~/.local/share/privacyops/privacyops.json。別のフォルダーを選ぶには、PRIVACYOPS_DATA_DIRを設定してください。
• 書簡は、そのフォルダー内のletters/にMarkdownテキストファイルとして保存されます。
• 削除に関する承認の判断は、~/.local/state/privacyops/approvals.jsonlに追記されます。保存されるのはIDと判断のみです。
• Seaynic Labsやその他のサービスに情報が送信されることはありません。PrivacyOpsは外部へのネットワーク接続を一切行いません。
• ファイルは本人だけが読み取れる権限（モード0600）で作成されますが、暗号化はされません。アカウントにアクセスできる人なら誰でも読み取れます。管理していない共有フォルダーや同期フォルダーには保存しないでください。
• AI アシスタントは、チャットに入力した内容を確認でき、アシスタントを運営する会社も同様に確認できます。PrivacyOpsではそれを変更できません。

PrivacyOpsが社会保障番号を尋ねることはありません。 信用情報機関から識別番号を求められた場合は、印刷した書簡に手書きで記入してください。

インストール

PrivacyOpsにはPython 3.11以降が必要です。uvを使えば、事前に何もインストールする必要はありません。

uvx privacyops-mcp --version
uvx privacyops-mcp --doctor          # checks your data folder and records, prints fixes

選択したときだけ更新したい場合は、バージョンを正確に指定してください：uvx privacyops-mcp==0.2.2。

または、pipを使う場合：

pip install privacyops-mcp

Claude Codeプラグインとしてインストールする場合（seayniclabs/pluginsマーケットプレイスにPrivacyOpsが掲載されていれば、サーバーとスキルを一度にインストールできます）：

/plugin marketplace add seayniclabs/plugins
/plugin install privacyops@seayniclabs

pip uninstall privacyops-mcpでアンインストールすると、プログラムのみが削除されます。記録や書簡はデータフォルダーに残ります。 削除したい場合は、そのフォルダーを手動で削除してください。

設定

PrivacyOpsは設定なしで起動します。デフォルト設定は安全です。

変数	モジュール	内容
PRIVACYOPS_DATA_DIR	all	記録と書簡を保存するフォルダー。デフォルトは~/.local/share/privacyops
PRIVACYOPS_DISPUTES_ALLOW_DELETE	disputes	デフォルトはfalseで、削除するたびに承認が必要です。trueにすると、アシスタントが確認なしで異議申し立ての記録を削除できます。
PRIVACYOPS_APPROVAL_LOG	all	承認ログのパス。デフォルトは~/.local/state/privacyops/approvals.jsonl
PRIVACYOPS_<MODULE>_ENABLED	any	falseにするとモジュールが無効になります。例：PRIVACYOPS_LETTERS_ENABLED=false

設定ファイル（任意）。 PrivacyOpsは~/.config/privacyops/config.toml、またはPRIVACYOPS_CONFIGで指定したファイルも読み込みます。環境変数はファイルの設定より優先されます。

data_dir = "/Users/you/Documents/privacyops"

[disputes]
allow_delete = false

[letters]
enabled = true

MCP クライアントに追加する

ほとんどのクライアントで、同じ形式のJSONを使用します。MCP サーバーの設定場所に記述してください。

{
  "mcpServers": {
    "privacyops": {
      "command": "uvx",
      "args": ["privacyops-mcp"],
      "env": {
        "PRIVACYOPS_DATA_DIR": "/Users/you/Documents/privacyops"
      }
    }
  }
}

クライアント	設定の場所
Claude Desktop	claude_desktop_config.json（Settings → Developer → Edit Config）
Claude Code	claude mcp add privacyops -- uvx privacyops-mcp、またはプロジェクトの.mcp.json
Cursor	~/.cursor/mcp.json、またはプロジェクト内の.cursor/mcp.json
VS Code	.vscode/mcp.json。"mcpServers"の代わりに"servers"を使用します
Sonique、Hermes、OpenClaw、その他	stdio MCP サーバーを起動できるクライアントであれば利用できます。コマンドはuvx、引数は["privacyops-mcp"]とし、環境変数も設定してください

HTTP経由で接続する場合。 プロセスを起動する代わりにURLへ接続するクライアント向け：

privacyops-mcp --transport http --port 8765

ストリーム可能なHTTPをhttp://127.0.0.1:8765/mcpで提供し、デフォルトでは自分のコンピューター上でのみ待ち受けます。ほかの場所に公開する前に、認証を設定してください。

試してみる

PrivacyOpsの設定後、以下のいずれかをアシスタントに入力してください。

1. 「期日どおりに支払ったのに遅延扱いになっている件について、Experianへの異議申し立てを開始し、書簡を作成してください。まだ何も送らないでください。」
2. 「期限を過ぎている異議申し立てはどれですか？ 次に何をすればよいですか？」
3. 「信用情報レポートの項目に異議を申し立てる方法を、順を追って説明してください。」
4. 「異議申し立ての記録の保存場所と、ファイルの内容を教えてください。」
5. 「カード発行会社に関する異議申し立てを削除してください。ただし、最初にプレビューを表示してください。」

ツール

ツール	返される内容
privacyops_modules	有効なモジュール、それぞれのツールの機能、データの保存場所、スキル、免責事項を返します。最初に呼び出してください。
disputes_list	ステータスまたは当事者の種類で絞り込んだ異議申し立ての概要を返します。offset を使ってページ分けできます。
disputes_get	詳細、期限、作成済みの書簡、履歴を含む、1件の異議申し立てを返します。
disputes_deadlines	未解決の異議申し立てについて、法定回答期限、残り日数、期限超過フラグ、次のアクション、把握できない事実を返します。
disputes_create	異議申し立ての追跡を開始します。
disputes_update	ステータスを変更し、送付日を設定するか、メモを追加します。すべての変更は履歴に記録されます。
disputes_delete	異議申し立ての記録を削除します。まずプレビューし、承認してから削除します。書簡ファイルは削除されません。
letters_templates	テンプレート、連絡先情報を確認済みの機関、免責事項を返します。
letters_generate	書簡をテキストファイルに作成します。IDを指定すると、異議申し立てに添付されます。

各ツールは、公開済みのスキーマに従った構造化データを返します。エラーは privacyops.<module>.<code>: <message> Fix: <hint> の形式で表示されます。

回答期限

disputes_deadlines は、記録した送付日を起点に、法律で定められた期間を数えます。

• 消費者信用情報機関： 機関は、異議申し立てを受領してから30日以内に再調査する必要があります（15 U.S.C. 1681i(a)(1)(A)）。30日間のうちに関連情報を送付した場合に限り、最大15日延長できます。ただし、その期間内に項目が不正確だと判明した場合、または確認できない場合は延長できません（1681i(a)(1)(B)–(C)）。出典：https://www.law.cornell.edu/uscode/text/15/1681i
• 情報提供者（項目を報告した会社）： 直接申し立てられた異議は、15 U.S.C. 1681s-2(a)(8)(E)(iii) に基づき、1681i(a)(1) に定められた期間が終了する前に調査して回答する必要があります。機関が転送した異議申し立てには、1681s-2(b)(2) が適用されます。出典：https://www.law.cornell.edu/uscode/text/15/1681s-2

このツールは、送付日から期間を数えます。法律では、相手方が異議申し立てを受領した日から数えるため、実際の期限は同じ日か、それより後になります。ツールは、書簡の到着日、追加情報を送付したかどうか、情報提供者への異議申し立てがどの経路をたどったかを把握できないため、推測せず、各行にその旨を記載します。期間は、2026-10-27 に公式の法令本文と照合済みです。

書簡テンプレートと出典

両方のテンプレートは固定テキストです。モデルによる生成はありません。各引用は、2026-10-27 に公式の法令本文と照合済みです。

テンプレート	用途	引用（15 U.S.C.）	出典
cra_dispute	消費者信用情報機関に項目の再調査を求める	1681i(a)(1)(A), (a)(5)(A), (a)(6)(A), (a)(7)	https://www.law.cornell.edu/uscode/text/15/1681i
furnisher_dispute	項目を報告した会社に直接異議を申し立てる	1681s-2(a)(8), (a)(8)(D), (a)(8)(E)	https://www.law.cornell.edu/uscode/text/15/1681s-2

連絡先情報は、2026-10-27 に各機関の公式サイトで確認できたもののみ掲載しています。

機関	書簡に記載する郵送先住所	オンラインでの異議申し立て	確認日
Equifax	公式ページに掲載なし：手書きで記入してください	https://www.equifax.com/personal/credit-report-services/credit-dispute/	2026-10-27
Experian	Experian, Dispute by Mail, P.O. Box 4500, Allen, TX 75013	https://www.experian.com/disputes/main.html（サインインが必要）	2026-10-27
TransUnion	未確認（確認時に公式ページでエラーが発生）：手書きで記入してください	未確認：手書きで記入してください	未確認

書簡を郵送する前に、住所を各機関の公式ウェブサイトで確認してください。機関は住所を変更することがあります。

安全性

• PrivacyOps は外部へのネットワーク通信を行わず、どこにもデータを送信しません。
• 異議申し立ての記録を削除する際は、MCP クライアントの承認プロンプトを通じて、まずユーザーに確認します。アシスタントがユーザーに代わって承認することはできません。一部のクライアントでは承認プロンプトを表示できません。その場合は、PRIVACYOPS_DISPUTES_ALLOW_DELETE=true を設定しない限り、削除は拒否されます。
• すべての削除判断（確認、承認、却下、拒否）は、異議申し立て ID とともに承認ログに追記されます。ログに氏名、項目のテキスト、理由、メモ、レターのテキストが記録されることはありません。
• 書き込みによって他の記録が削除されることはありません。保存に失敗しても以前のファイルは変更されず、読み取れないファイルが上書きされることもありません。
• 免責事項は、サーバーの指示、privacyops_modules、すべてのスキル、および各レターのフッターに表示されます。

セットアップを確認する

uvx privacyops-mcp --doctor

Doctor は、データフォルダー、記録ファイル、レターフォルダー、承認ログを読み取ります。各項目について、実行すべき手順とともに ok または FIX を出力し、修正が必要な場合は終了コード 1 で終了します。ネットワーク通信は行わず、ファイルも変更しません。

開発

uv venv -p 3.11 && uv pip install -e '.[dev]'
.venv/bin/pytest
python3 scripts/check_skills.py
.venv/bin/python scripts/tool_lock.py --check
.venv/bin/python scripts/security_card.py --check

テストでは一時的なデータフォルダーを使用し、ネットワーク通信は行いません。scripts/tool_lock.py（--check なし）は、ツール、プロンプト、または指示に意図的な変更を加えた後にロックを再生成します。同じ変更に変更履歴の行を追加してください。

セキュリティ

脆弱性は GitHub から非公開で報告してください（Security タブの「Report a vulnerability」）。SECURITY.md をご覧ください。

ライセンス

MIT。Seaynic Labs が公開しています。

---

Seaynic Labs が開発しました。 私たちは、ローカル優先で、変更ごとに人が承認する、このようなツールを企業独自のシステム向けに開発しています。カスタムインテグレーションを見る。