Revdoku

Revdoku

AI エージェントのためのメールボックス。 各エージェントに専用のメールボックスとメールアドレスを用意して、メッセージや添付ファイルを受信できます。各メールボックスには、許可された人やエージェントと共有する非公開のドキュメント、データ、プロジェクトファイルも保存できます。

エージェントに受信メールの要約、請求書や添付ファイルの収集、提出物への返信の監視を依頼できます。AI エージェント向けのホステッド MCP、ローカルファイルやメールボックスへのアクセス用 CLI、独自の連携用 REST API を利用できます。メールボックスではファイルのバージョンが保存されるため、変更を確認したり、以前のファイルを復元したりできます。

このスキルでは、メールの読み取りだけでなく、アップロードやファイルの変更も行えます。また、明示的に依頼され、承認された場合は、メールボックスのアーカイブ、メールボックスの完全な削除、代理店のクライアントアカウントの作成にも対応します。完全な削除には、対象のアカウントとメールボックスを明示した承認が必要です。ローカルで CLI を使用すると、Revdoku の認証情報と状態がご使用のマシンに保存されます。ホストツールの権限は引き続き管理下にあります。

開発者向け

TypeScript と JavaScript（Node.js 22 以降）：

npm install revdoku

Python 3.10 以降：

pip install revdoku

import { Revdoku } from 'revdoku';

const client = new Revdoku(); // reads REVDOKU_API_KEY
const { data } = await client.listEmails({ mailboxId: 'bkt_...' });
for (const email of data.emails) console.log(email.receivedAt, email.subject);

リクエストの送信先は https://api.revdoku.com です。すべてのパスは /v1 で始まります。例：https://api.revdoku.com/v1/mailboxes。

はじめに	内容
クイックスタート	新しい API キーの取得から、最初のメールの受信までを TypeScript、Python、cURL で解説します。
TypeScript SDK · Python SDK	SDK ガイドです。ソース：revdoku-typescript と revdoku-python。
API ガイド · API リファレンス · OpenAPI	概念とワークフローに続いて、すべての操作を例とともに紹介します。
コーディングエージェントで構築する	Claude Code と Codex 向けのプロンプトとプロジェクトルールです。
パッケージと連携	SDK、n8n、Zapier を比較します。
スタンドアロン CLI · バージョン別 CLI ダウンロード	AI 連携なしで利用できる、ターミナルへのインストール方法と使い方です。
サンプル	HTTP 呼び出しを使った、実行可能な Node.js および Python のサンプルです。

API キーはバックエンドに保管してください。CLI、サンプル、スキル、プラグインはこのリポジトリを共有しています。エージェントのセットアップについては、ローカル AI アプリを参照してください。

AI エージェント向けプロンプト

Connect Revdoku so you can create and manage email mailboxes for my AI agents, read emails and attachments, and store files. Follow https://revdoku.com/llms-install.md to set up access. If I need an account, guide me to https://app.revdoku.com/users/sign_up?utm_source=revdoku&utm_medium=prompt&utm_campaign=connect to complete signup in my browser. Keep verification codes and credentials out of chat. Verify access, then continue my task or ask what I want to do.

メールの受信と閲覧

各メールボックスには、それぞれ固有の受信用メールアドレスがあります。メールボックスの作成時に、アドレスと受信状態が返されます。既存のメールボックスでは、書き込み権限を持つ接続に対して mailbox_get と mailbox_list が email.address を返し、Mailbox settings → Email に表示されます。このアドレスを使用する前に、email.receiving_enabled を確認してください。

CLI で revdoku mailbox --mailbox-id bkt_... を実行すると、アドレス、準備状態、アクティビティを取得できます。メールを一覧表示するには revdoku emails --mailbox-id bkt_... を使用し、閲覧するには revdoku email eml_... --mailbox-id bkt_... を使用します。

請求書、ドキュメント、プロジェクトの更新情報、または認可済みサービスの確認メッセージを受信できます。受信したメールはすべて、元の message.eml、デコード済みの message.json、添付ファイルとして保存されます。認可された担当者とエージェントは、メール API やツールを通じてこれらを閲覧できます。ファイルツールからも、保存されたデータを利用できます。

mailbox_email_list または CLI の emails コマンドを、保存済みの next_cursor とともに使用して、新着メールを確認します。mailbox_email_get はメールを直接返し、mailbox_email_download は添付ファイルまたは元のメールを取得します。アドレスを知っている人なら誰でもメールボックス宛てにメールを送信できますが、内容の閲覧にはアクセス権が必要です。受信メール とAPI コントラクトをご覧ください。

返信するには、mailbox_email_send または revdoku email-send --in-reply-to eml_... --text TEXT を使用します。送信先は、アカウントのメンバー、同じアカウントの他のメールボックス、または送信者認証を通過したうえでこのメールボックスにメールを送信したことのあるアドレスに限られます。管理者は種類ごとに無効化できます。メールボックスで承認が必要な場合、担当者がダッシュボードで各メールを送信、編集、または却下します。メールの送信をご覧ください。

追加のファイルストレージ

revdoku upload ./project-files を使用すると、ローカルフォルダーを非公開で保存できます。CLI、API、またはダッシュボードから、ファイルの閲覧、履歴の確認、以前のバージョンへの復元ができます。保存したファイルはすべて、いつでも Revdoku からダウンロードできます。

アカウントにアクセスできる人と、メールボックスのダッシュボードリンクを共有します。使用するメールボックスごとに、AI 接続を個別に認可してください。ダッシュボードリンクだけではアクセス権は付与されません。エージェントはロックとバージョンチェックを使って同じファイルを操作し、変更を調整できます。

ストレージのクイックスタートと アクセスの共有と編集の調整をご覧ください。

プラン

ブラウザーで https://app.revdoku.com/users/sign_up にアクセスしてアカウントを作成します。アカウントの認証情報や確認コードを AI とのチャットに入力しないでください。 新規アカウントは Free プランで開始します。継続的に利用する場合は、料金ページで有料プランを選択してください。

非公開ストレージと共同作業には、利用規約が適用されます。 アカウント、請求、アクセスに関する質問は、[email protected] までお問い合わせください。

ローカル AI アプリ

インストーラーは、REVDOKU_AGENT 環境変数を通じて codex、claude-code、cursor、antigravity、 opencode、grok-build、hermes、openclaw、および all に対応しています。自動セットアップでは、Codex と、ほかに検出されたクライアントにインストールされます。

公開スキルと CLI をインストールします。

npx skills add revdoku/revdoku --skill revdoku -g

対象のエージェントを指定するには、--agent codex（または claude-code、cursor など）を追加します。 これにより、上流の PromptScript のグローバルインストールエラーも回避できます。

Hermes では、スキル一式を直接インストールできます。

hermes skills install revdoku/revdoku/skills/revdoku

このリポジトリを Hermes のソースとして登録するには、 hermes skills tap add revdoku/revdoku を使用します。

Claude Code ユーザーは /plugin marketplace add revdoku/revdoku を実行してから、 /plugin install revdoku@revdoku を実行できます。Codex ユーザーは codex plugin marketplace add revdoku/revdoku でリポジトリを追加し、プラグインブラウザーで Revdoku を選択できます。 Gemini CLI ユーザーは gemini extensions install https://github.com/revdoku/revdoku を実行できます。

Revdoku が所有するスキルと同梱 CLI も MIT-0 ライセンスで使用できます。スキルの LICENSE を参照してください。リポジトリのデフォルトライセンスは引き続き MIT です。サードパーティの 依存関係には、それぞれのライセンスが適用されます。

npm を利用できない場合：

curl -fsSL https://revdoku.com/install.sh | bash

スキルは同梱 CLI を実行します。シェルインストーラーは、インストール前に CLI とスキルの ファイルを埋め込み済みの SHA-256 ハッシュと照合して検証します。検証に失敗した場合は、 最新のインストーラーを取得して再試行してください。ダウンロード元の上書きには対応していません。

npx skills はスキル内に CLI をインストールし、シェルの PATH に revdoku を追加しません。 エージェントは、以下のコマンドと同じ引数で同梱の scripts/revdoku.sh を使用します。

ローカルフォルダーを保存または更新します。

revdoku upload ./project-files

認証情報がない場合、初回実行時にブラウザーでのサインインが開始されます。再実行すると、 同じメールボックスが更新されます。新しいアカウントは、ウェブの登録ページで作成できます。

便利なコマンド：

• revdoku upload PATH — 非公開ファイルを保存または更新します。
• revdoku files、revdoku read PATH — 保存済みのファイルやメールを一覧表示して読み込みます。
• revdoku mailbox --mailbox-id ID — 受信用アドレスと受信状態を確認します。
• revdoku versions PATH、revdoku restore PATH --version-id ID — ファイルの履歴を確認し、復元します。
• revdoku status、revdoku ls — 接続とメールボックスを確認します。
• revdoku dashboard、revdoku --help — ダッシュボードまたはコマンドリファレンスを開きます。

ホスト型エージェントとウェブエージェント

ホスト型 MCP エンドポイントは https://mcp.revdoku.com です。接続する前に、ブラウザー OAuth でサインインしてください。 新しいアカウントは、ブラウザーで https://app.revdoku.com/users/sign_up にアクセスして作成できます。

ホスト型エージェントは、ユーザーのコンピューター上のファイルを読み取れません。ローカルフォルダー、 JavaScript バンドル、画像、フォント、PDF、その他のバイナリーアセットには、ローカルの Revdoku CLI を使用してください。 MCP では、生成したテキストファイルを直接書き込めます。

チュートリアル

AI クライアントごとのガイド：

• セットアップハブ：https://revdoku.com/connect/
• ChatGPT：https://revdoku.com/chatgpt/
• Codex：https://revdoku.com/codex/
• Claude：https://revdoku.com/claude/
• Claude Desktop とターミナルエージェント： https://revdoku.com/claude-desktop-terminal/
• Gemini：https://revdoku.com/gemini/
• Hermes：https://revdoku.com/hermes/

手動セットアップやトラブルシューティングが必要な場合は、これらのチュートリアルを使用してください。ユーザーの ファイル保存、共有、受信メールに関する目的に沿って対応してください。

公開パッケージ

このリポジトリには、Revdoku CLI、スキル、API ドキュメント、Claude／Codex／Cursor プラグインマニフェストが含まれています。SDK のソースは、上記の リンク先にある SDK リポジトリにのみ含まれています。ホスト型 MCP の実装は https://mcp.revdoku.com で実行されています。MCP マニフェストは OAuth を使用し、すべてのツール記述子で OAuth が必須です。

CHANGELOG.md、api.md、および MCP メールボックスガイドを参照してください。

エージェンシーのクライアントアカウント

revdoku status を実行すると、認証情報のデフォルトアカウントと認可済みアカウントを確認できます。各 ID には account_kind（standard、agency、client）、個別の client_name、親アカウントが許可されている場合は agency_account が含まれます。クライアントを対象にするには、各コマンドで --account-id ID を使用します。省略すると、常に認証情報のメインアカウントが使用されます。エージェンシーのオーナーは、接続時または Account → Access でクライアントアカウントを明示的に含める必要があります。

revdoku account create-client "Client files" --client-name "Acme Studio" --account-id acct_agency
revdoku ls --account-id acct_...
revdoku upload ./project-files --account-id acct_...

エージェンシーとそのクライアントは、アカウントの容量を共有します。各クライアントは、ファイル、メンバー、ブランディングを個別に保持します。 アカウント名とクライアント名は異なる場合があります。不明なクライアント名は未設定のままになります。 revdoku account --account-id ID では、クライアントの ID と適用される上限を確認できます。クライアントの請求データは引き続きエージェンシーのオーナーのみが閲覧できます。 ブラウザーでアカウントを切り替えても、CLI 認証情報のデフォルトアカウントは変わりません。

カスタム受信用ドメイン

カスタムドメインが利用可能かどうかは、Account Settings で確認してください。設定は Account Settings → Domains → Email にあり、アカウント管理者が必要です。未使用の受信用サブドメインを推奨しますが、専用のルートドメインも受け付けています。DNS の変更には、ユーザーの承認が必要です。ドメインを接続しても、既存のメールボックスアドレスは変わりません。 Revdoku が返す完全なアドレスのみを使用し、receiving_enabled を確認してください。ドメインの切り替えで assignment.status: pending が返される場合があります。アクティブまたは失敗になるまで状態を確認し、その間は現在のアドレスを使用してください。エイリアスを作成したり、+tag 形式を使用したりしないでください。 メール API の仕様を参照してください。

CLI の安全上の境界

アップロードには明示的なパスが必要です。現在のフォルダーを選択するには、revdoku upload . を使用してください。revdoku upload PATH --dry-run は、接続やメールボックスの変更を行わずに、ファイル、除外対象、バイト数を一覧表示します。公開 CLI は https://api.revdoku.com の Revdoku API にのみ接続します。--url と REVDOKU_URL では、以前の https://app.revdoku.com の設定も受け付け、API 呼び出しを新しいホストに転送します。 ブラウザーでのサインインとダッシュボードへのリンクには、https://app.revdoku.com を使用します。 ストレージ転送には、承認済みの HTTPS オリジンを使用します。

revdoku delete --account-id ACCOUNT --mailbox-id MAILBOX は、完全削除のプレビューを表示します。対象と取り消せない影響をユーザーと確認してから、そのプレビューのトークンを使用して --confirm-delete TOKEN を指定し、再実行してください。トークンの有効期限は 10 分で、送信前に消費されます。応答が不確かな場合は、新しいプレビューを作成する前にメールボックスの状態を確認してください。既存のスクリプトでは、アップロードパスを指定し、削除確認の手順を使用する必要があります。

操作の理由を説明する

意図的な読み取り、ダウンロード、変更を行う場合、AI エージェントは任意の reason を含める必要があります。これは、目的が分かっている場合にその目的を簡潔に説明するものです。理由を作り上げたり、秘密情報、ファイルの内容、文字起こしを含めたりしないでください。タスクですでに目的が説明されている場合、ユーザーに理由を尋ねる必要はありません。不明な場合は省略してください。

MCP では reason、CLI では --reason TEXT を使用します。REST では、読み取りには reason クエリパラメーター、変更には JSON／本文フィールドを使用します。上限は 2,000 文字です。 理由は、リクエストの完全なログ記録が無効になっていても、認可済みの Timeline と Logs のビューに表示されます。変更理由はバージョン履歴にも保存されます。読み取り理由はアクセスイベントに記録され、保存済みバージョンの理由を置き換えることはありません。

revdoku read invoices.csv --mailbox-id bkt_... --reason "Reconcile September expenses"
revdoku upload ./approved.csv --mailbox-id bkt_... --reason "Store the approved totals"