balmas-mcp

balmas-mcp

AI エージェントはあらゆるものを読み取ります。このゲートウェイは、代わりに匿名化したコピーを渡します。

なぜ必要なのか

AI エージェントがファイルにアクセスできるようになり、読みすぎるようになっています。イスラエルのプライバシー保護当局は、AI エージェントに関するガイダンスで率直に指摘しています。メールを分類するエージェントは、2 年間の業務のために15年分のやり取りを分析し、その過程で健康状態や財務状況を推測し、学んだ情報を漏らす可能性があります。当局の推奨事項は、厳格な権限の最小化です。読み取り専用にし、専用フォルダーを使い、必要最小限のデータに限定します。

balmas-mcp は、その助言をコードに落とし込み、さらに一歩進めます。エージェントが読み取るファイルだけでなく、ファイルの中身も最小限にします。

仕組み

1. フォルダーを許可リストに登録します。 エージェントはそれ以外にアクセスできません。ルールの順守に頼るのではなく、実際の realpath チェックで制限します。
2. 読み取りのたびに、ローカルで匿名化します。 名前、ID 番号、電話番号、メールアドレス、会社名、金額は、内容を返す前に一貫したトークン（PERSON_001、ID_001）に置き換えられます。シークレットも対象です。 API キー（OpenAI、Anthropic、GitHub、AWS、Stripe、Slack など）、JWT、秘密鍵ブロック、password: の値、.env の認証情報は、あらゆる階層で SECRET_001 に置き換えられ、restore_text で書き戻されることはありません。同じ人物はどのファイルでも PERSON_001 となるため、エージェントの推論に一貫性が保たれます。検出はこのプロセス内で実行されます。決定論的なパターン、辞書、チェックサムを使用します（イスラエルの ID も対象です）。ヘブライ語と英語に対応しています。
3. 回答は元の値に戻ります。 restore_text が、エージェントの最終出力に含まれるトークンを元の値に戻します。処理はローカルで行われます。

設計上、読み取り専用です。サーバーは書き込みツールを一切公開しません。

クイックスタート

1. balmasai.com/signup で無料アカウントを作成します（月10件まで無料）。
2. balmasai.com/app/team で API キー（bk_...）を作成します。
3. MCP クライアントの設定に追加します（Claude Desktop の例を示します。Cursor なども同様です）。

{
  "mcpServers": {
    "balmas": {
      "command": "npx",
      "args": ["-y", "balmas-mcp", "/Users/me/Documents/work", "--level", "strict"],
      "env": { "BALMAS_API_KEY": "bk_..." }
    }
  }
}

オプション： 許可するフォルダーを位置引数で指定します（必須、1つ以上） · --level standard|strict|maximum（デフォルトは strict）。

ツール

ツール	エージェントが取得する情報
list_files	許可されたフォルダー内の名前、サイズ、種類。内容は取得しません
read_clean_file	ローカルで匿名化されたファイルのテキスト
restore_text	出力内の値を元に戻します（セッションのトークンのみ）

対応する入力：txt csv md docx xlsx pptx pdf（テキストレイヤー）。

プライバシーモデル

	デバイスの外に送信されるか
ファイルの内容	一切ありません
ファイル名／パス	一切ありません
置換マップ	一切ありません
使用量の集計値（ファイルの種類と項目数）	はい。送信されるのはこれだけです

ファイルの読み取り1回につき、アカウントの月間利用枠から1件分を消費します（無料10件／PRO 200件／TEAM 1,000件）。処理はすべて、このローカルプロセス内で行われます。

正直な制限事項

• エージェントがファイルをこのゲートウェイ経由で読み取る場合にのみ有効です。生のファイルシステムアクセスと併用せず、代わりにゲートウェイへのアクセスを許可してください。
• 検出は決定論的です。非常に優れていますが、すべてを見通せるわけではありません。重要な場面では出力を確認してください。
• スキャンした PDF（テキストレイヤーなし）には、balmasai.com/clean の OCR フローが必要です。

---

BALMAS AI が開発。機密データはここで止まります。 ドキュメント：balmasai.com/mcp