Armadoc

armadoc

Armadoc のエンドツーエンド暗号化ドキュメント共有に対応する armadoc CLI とローカルの stdio MCP サーバーです。ターミナルからドキュメントを送信・閲覧したり、エージェントに代わりに操作させたりできます。秘密鍵と平文がマシンの外に出ることはありません。

インストール

npm install -g armadoc

Node 24 以降が必要です。または、グローバルインストールせずに、各コマンドの先頭に npx を付けて実行できます。

ペアリング

armadoc login

ブラウザーでこのマシンを Armadoc アカウントとペアリングし、アカウント用の鍵を登録します。この鍵で開けるのは、ペアリング後にあなた宛てに送信されたものだけです。それ以前に送信されたものは、送信前に閲覧していた場所で引き続き開けます。

armadoc status でペアリングの状態を確認できます。

送信と閲覧

armadoc send report.pdf notes.txt --to [email protected] --to-name "Dustin Burrows"
armadoc ls
armadoc read https://armadoc.link/v/<linkId>

send は、このマシン上のファイルを暗号化し、ログイン時に指定した名前で、1 人の宛先に送信します。宛先がまだ Armadoc の鍵を持っていない場合は、代わりに招待メールが送信され、ファイルはアップロードされません。相手が招待を承諾した後、同じ send を再実行すると送信が完了します。--expires 7d で、プランの範囲内でリンクを開ける日数を設定できます。

ls または list では、双方向のうち現在も有効なものが表示されます。--inbound または --outbound を指定すると、表示対象を絞り込めます。read にはメール内のリンク、またはその ID を指定します。ファイルは ~/Downloads/armadoc/<linkId> または --dir で指定した場所に保存されます。既存のファイルが上書きされることはありません。

list、read、send では、スクリプトで解析できる出力を得るために --json を指定できます。プランの上限などを理由に処理が拒否された場合は、標準エラー出力にメッセージを出力し、終了コード 1 を返します。

エージェントから利用する

Claude Code：

claude mcp add --scope user armadoc -- armadoc mcp

Codex：

codex mcp add armadoc -- armadoc mcp

その他のホストでは、stdio 経由でサーバーを armadoc mcp として実行します。読み込むには、ホストを再起動するか再接続してください。

リクエストには、コマンドと MCP サーバーのどちらが実行したかが記録されます。また、MCP サーバーからのリクエストには、MCP ホストが自身について報告する名前とバージョンが含まれるため、Armadoc はクライアントの利用状況を把握できます。

サーバーは、MCP ホストと同じコンピューター上で実行する必要があります。armadoc login では同じマシン上のブラウザーが必要なため、クラウドホスト型エージェントでは動作しません。仮にそこでペアリングできたとしても、秘密鍵と閲覧したドキュメントがプロバイダーのマシン上に保存され、セッション終了後も残る可能性があります。

ツール

ツール	内容
list_documents	あなた宛てに送信されたドキュメントと、あなたが送信したドキュメントを一覧表示します
read_document	ドキュメントのファイルをディスクに復号します。既定の保存先は ~/Downloads/armadoc/<linkId> です
send_document	ローカルファイルを暗号化して送信するか、まだ鍵を持っていない宛先に招待を送信します

read_document が返すのはファイルのパスであり、内容ではありません。エージェントがファイルを開いた場合にのみ、ドキュメントの内容がエージェントのコンテキストに入ります。

アンインストール

armadoc logout
npm uninstall -g armadoc

armadoc logout は、~/.config/armadoc にある秘密鍵と認証情報を削除します。設定で削除するまで、エージェントは引き続きアカウントに紐付けられます。また、エージェントが閲覧したドキュメントは ~/Downloads/armadoc に残ります。