Recued

デモ | ドキュメント | マーケットプレイス

Recued

Recued は、自分で実行するサーバーです。AI とアカウントの間に位置します。 メール、カレンダー、ファイル、CRM の記録は、管理下にあるマシンに保存されたままです。

2 つの方法で利用できます。すでに利用している AI エージェントが、実行可能な操作を正確に記載したコントラクトを通じて MCP で接続します。または、Recued が自ら作業を実行します。チャットで依頼するか、レシピをスケジュールに従って、あるいは何かが起きたときに実行できます。どちらの場合も、すべての操作は 1 つのゲートを通ります。デフォルトでは、書き込みや削除を伴う操作は、あなたの承認を待ちます。

Recued は、あなたが利用している AI に取って代わるものではありません。Claude、ChatGPT、Codex、またはローカルモデルが引き続き思考を担います。Recued は、あなたが定めた条件のもとで、その思考をデータやアカウントにつなぐ場所です。あなたと AI の間で、Recued が担うのはその役割です。

このリポジトリには、セルフホスト可能なサーバーとウェブクライアントの完全な実装が含まれています。また、それらの構築に使われるワークスペースパッケージも含まれています。

ゲートウェイとしての Recued

• エージェントごとに 1 つの入口。 Claude、Codex、OpenClaw、または独自の AI エージェントごとにコントラクトを作成します。コントラクトには、そのエージェントが使用できるツールが記載されます。エージェントはコントラクトのキーを使って MCP 経由で接続します。
• すべての呼び出しに 1 つのゲート。 ゲートは最初にコントラクトを確認し、呼び出しが書き込みを伴う場合はあなたに確認します。呼び出しを記録してから実行します。未知の呼び出し元は拒否されます。スイッチ 1 つですべてを一時停止できます。
• リスクのある操作はあなたの承認制。 デフォルトでは、書き込み、送信、削除を伴う操作は、あなたの承認を待ちます。1 件、複数件、またはセッション全体を承認できます。
• キーは手元に保管。 アカウントのキーは、あなたのサーバーまたは選択したブローカーに保管されます。Recued のクラウドにキーが保存されることはありません。エージェントに渡されるのはコントラクトで許可されたツールであり、その背後にあるキーではありません。

Recued が独自にジョブを実行

• 質問する。 Recued には、ウェブアプリ、メール、Slack、Telegram から利用できる独自のチャットがあります。まず保存済みの記録から回答します。「Maya のメールアドレスは？」のような検索に AI は不要です。AI が必要な質問では、個人情報を置き換え、関連する事実を添えてからモデルに渡すため、モデルは処理を始める前に必要な情報を得られます。デモで Maya への質問を再生できます。
• 実行を任せる。 レシピとは、スケジュールに従って、または何かが起きたときに Recued が自動実行するジョブです。荷物、請求書、予約、注文、見込み客に関するメールをきっかけにできます。新しい記録もきっかけになります。判断が本当に必要な場合に限り、モデルを呼び出します。
• 同じゲート。 Recued 自身のジョブも、外部エージェントと同じゲートを通ります。デフォルトでは、書き込みや削除を伴うステップは、引き続きあなたの承認を待ちます。

Recued が該当しないもの

• コーディングエージェントではありません。
• 汎用チャットアプリではありません。チャットは、あなた自身の記録やアカウント向けです。
• SKILL.md ファイルを実行するランナーではありません。Recued では実行できません。
• 長い時間をかけて多数のステップを踏む、自由形式の質問向けには作られていません。

Recued とは

• 1台のサーバーに、1人の所有者。各 Recued サーバーはそれぞれ独立しています。1人、または1つの組織（会社、チーム、家族など）を代表します。
• あらゆるプロバイダーとあらゆる API に接続できます。コマンドラインツールにもアクセスできます。
• あらゆる AI エージェントが MCP 経由で接続できます。Codex、Claude、OpenClaw とその他の Claw 系、または独自のエージェントに対応します。
• メール、連絡先、CRM レコードのローカルコピーを保持するため、読み込みが高速です。
• AI が倉庫のデータを見る前に、個人を特定できる情報の置き換えを試みます。対象は、氏名、メールアドレス、組織名、電話番号、住所です。代わりに安全な仮名が使われます。これが PII エイリアスです。できる限り正確に処理し、安全に元に戻せます。仮名でも地域（市、州、国）は保持されます。また、同じ組織に属する人物や拠点が分かる情報も保持されるため、モデルはその情報をもとに推論できます。
• 保存データは、ディスク上にある間、暗号化されます。復旧には24語のリカバリーキーのみが必要です。
• 第三者が仲介することはありません。料金の一部を取る人も、データを転送する人もいません。
• ホスト型でもローカル型でも、あらゆる AI プロバイダーで動作します。デフォルトのスロットが2つあり、さらに無制限の追加プロバイダースロットを切り替えて利用できます。
• リスクのある操作はすべて承認制にできます。承認後にのみ実行されます。
• 無料で利用できます。機能に制限はありません。

インストール

コマンドを1つ実行するだけです。お使いのプラットフォーム向けの署名済みバイナリを取得します。これは Recued の提供元を確認できるよう、署名されたプログラムファイルです。リリースキーと照合して検証します。recued を PATH に配置するため、どこからでも実行できます。また、ログイン時に起動するよう設定します。

# Linux and macOS
curl -fsSL https://recued.com/install.sh | sh

# Windows — in PowerShell
irm https://recued.com/install.ps1 | iex

インストーラーはサーバーも起動します。そのため、インストールが完了すると、サーバーはすでに動作しています。ブラウザーをペアリングするには、recued pair を実行します。ペアリングコードと Web クライアントへのリンクが表示されます。リンクを開き、コードを入力してください。そのターミナルで recued が見つからない場合は、新しいターミナルを開いてください。

ログイン時に起動させたくない場合は、sh の直前に RECUED_AUTOSTART=0 を指定します。 curl -fsSL https://recued.com/install.sh | RECUED_AUTOSTART=0 sh。curl の前に指定すると、curl だけに適用されます。PowerShell では、まず $env:RECUED_AUTOSTART=0 を単独の行で実行します。その後、recued serve で自分で起動します。ペアリングコードが表示されます。インストール先、リリースチャンネル、その他の情報については、INSTALL.md をご覧ください。

ヘッドレス Linux マシンとは、画面やデスクトップ環境のないマシンです。この場合、起動時に実行するには root 権限、つまり管理者アカウントが必要です。sudo でインストーラーを実行し、ペアリングも sudo で行ってください。インストーラーに正確なコマンドが表示されます。その理由は次のとおりです。デスクトップのキーリングがない場合、キーのファイルをマシンに紐付けて封印する方法は1つしかありません。その方法では、root だけが読み取れるホストキーを読み込みます。Linux のデスクトップセッションではユーザーユニットがインストールされるため、root 権限は不要です。

パック

パックは JSON ファイルです。CLI、SaaS、REST API、MCP など、あらゆるリソースへの接続方法を定義します。各操作の権限を設定できます。デフォルトでは、書き込み、管理、破壊的な操作はすべて、手動での承認が必要です。すぐに使えるパックは https://recued.com/packs で無料で入手できます。組み込みエディターまたは JSON で独自のパックを作成できます。

SKILL.md とレシピ

スキルは、ある作業への取り組み方をモデルに伝えます。モデルは実行中に各手順を判断します。レシピは手順そのものです。JSON 形式で、実行前に内容が固定されます。サーバーがレシピを実行し、判断が本当に必要な箇所でのみモデルを呼び出します。

両者は競合するものではありません。Recued は MCP 経由でレシピを提供します。そのため、今朝確認する価値があるものを判断するスキルから、レシピに作業を引き継ぐことができます。問題は、作業のどの部分をどちらに任せるかだけです。

実例

毎週月曜日の朝に、Google Trendsから過去1週間で検索数が伸びている検索語を取得します。次に、それらに関連して販売できるものがあるかを判断します。

難しいのは最初のステップです。単なる検索ではありません。トレンド検索には、人名、チーム名、イベント名が含まれます。bmw championship payout、chapecoense vs são paulo、hurricanes weatherなどです。どれも商品ではありません。ゴルフトーナメントならグローブや距離計、嵐なら電池式ランタンです。一方、何も売る価値のない検索語もたくさんあります。それを判断するには、見極めが必要です。この仕事でモデルが担うのは、この部分だけです。以下は単純な計算です。各キーワードで何が売れているのかをカタログに問い合わせます。それらのクリックに入札する場合の費用を調べます。差し引いて、順位を付けます。

レシピとしては、36ステップあります。そのうちモデルを呼び出すのは2回です。1回目はトレンド検索語を商品キーワードに変換します。2回目は購入概要を書きます。その間の処理は、同じ入力に対して常に同じ答えを返します。この種の作業にコンテキストウィンドウ（モデルの作業用メモリ）は必要ありません。619KBのエクスポート、110件のカタログ取得、その結果として返される1,249件の商品行は、どれもコンテキストウィンドウに入りません。モデルの2回の呼び出しは、設計上、サイズが一定です。そのため、モデルが選ぶキーワードが32個でも58個でも、入力側は約3,000トークンに収まります。トークンとは、モデルが数えるテキストの小さな単位です。6MBのエクスポートと10,000件の商品を含むカタログを渡しても、この数値は変わりません。

同じ作業をスキルとして実装するのは、わざと弱く作って負けさせるような比較ではありません。最も強力な実装では、エージェントはエクスポートをまったく読みません。エージェントにシェルを渡せば、ファイルを直接ディスクに取得できます。同梱スクリプトで解析します。つまり、データはコンテキストウィンドウに入らず、受信コストもかかりません。しかし、こうなると、自然言語のラッパーを備えたプログラムです。独自のシークレットキー、リトライ、レート制限が必要です。ファイルを保存する場所も必要です。そして、誰もセッションを開かない火曜日にも実行できる仕組みが必要です。レシピとは、これらすべてをすでに備えたサーバー上で動く、そのプログラムです。

詳細な説明は**examples/**にあります。レシピ本体も掲載しています。比較対象となるスキルも、先入観なしで作成したものを掲載しています。ここで実際に動作するものと、モックを使っているものについて説明しています。また、プロンプトの一文が間違っていたときに何が起きたかも紹介しています。

Recuedで、暮らしやビジネスに活用できること

• 公開受付ページを通じて、予約、面談、大容量ファイルの送信、カスタム受付フォームを受け付けます。
• AIで商品に関する質問に回答します。回答は、インポートした知識とQ&Aに基づきます。
• Stripe経由で販売します。
• 公開したMCPツールを、サブスクリプションまたは従量課金で提供します。
• LLMゲートウェイを通じて提供する知識を、サブスクリプションまたは従量課金で提供します。
• 素早くプロトタイプを作成します。アイデアを動作するアプリに変えます。
• Recuedを好きなだけ拡張できます。独自のパックやレシピを作成するか、Recued Marketplaceから無料のものをインストールします。

具体例

Recuedでできることを紹介するため、実際のビジネスアプリをいくつか作りました。

• Ledger Book：会計、複式簿記、予算、記録。
• Fleet Money：依頼から精算まで、割り当てられた仕事と作業者への支払いを管理します。
• Queue Desk：番号札方式の順番待ちシステムです。来訪者は公開受付フォームでサービスの種類を選びます。番号と、前に何人いるかを確認できるリンクが渡されます。スタッフは、ペアリング済みの任意のデバイスから次の人を呼び出せます。
• DeepTutor Records：教育と個別指導のサブスクリプションビジネス向けです。学生、評価、回答、成果物、スコアカードを管理します。学生の登録、評価の送信、回答の収集、採点を行う、すぐに実行できる9つのワークフローが付属しています。質問を作成するにはDeepTutorパックが必要です。ご自身のマシンで実行できます。データを変更するアクションには、Recuedの承認コントロールが適用されます。DeepTutorはHKUDSによるオープンソースプロジェクトです。
• Rental Book：物件、家主、台帳、記録を管理します。
• Federated Projects：プロジェクト管理、フェデレーション、記録、作業エンティティを扱います。Federated Project Peerを介して、複数のRecuedサーバーが連携して作業する様子を紹介します。
• Social Publishing：Mastodon、X、Facebook、Blueskyへの投稿を予約できます。

ドキュメント

**https://recued.com/docs**では、インストール、ペアリング、接続の方法を説明しています。また、レシピやパックの作成、公開、AIチャットとMCP、スキーマリファレンスについても解説しています。

このリポジトリ内のドキュメント：

• INSTALL.md：リリースのインストール方法とオプション、およびクローンからのビルド方法
• ARCHITECTURE.md：コードの構成
• CONTRIBUTING.md：ビルド、テスト、プルリクエスト

ソースから実行する

LinuxおよびmacOSの場合：

npm ci
npm run build
npm run build:server
npm run build:webclient
RECUED_WEBCLIENT_DIR="$PWD/apps/webclient/build" npm start

WindowsのPowerShellの場合：

npm.cmd ci
npm.cmd run build
npm.cmd run build:server
npm.cmd run build:webclient
$env:RECUED_WEBCLIENT_DIR = "$PWD\apps\webclient\build"
npm.cmd start

npmではなくnpm.cmdと入力してください。PowerShellでは、通常のnpmが実行するスクリプトが既定でブロックされます。npm.cmdは、スクリプトを介さずに実行する同じnpmです。

サーバーはポート7717で待ち受けます。http://localhost:7717/webclient/を開いてください。安定版の静的Webクライアントhttps://app.recued.com/も利用できます。

各プラットフォームで事前に必要なものを含む詳細は、INSTALL.mdをご覧ください。

このリポジトリの内容

• backend/server/：セルフホスト可能なRecuedサーバーとCLI
• apps/webclient/：ローカルのWebクライアント
• packages/：上記2つの構成に使われるワークスペースモジュール
• community/：Day-1の基盤パックとそのレシピ。作成ガイドの実例として用意されています

ルートのpackage.json、ロックファイル、TypeScriptビルドグラフは、手作業ではなくツールによって生成されます。これらには、このリポジトリが依存するパッケージがすべて含まれています。ブラウザーブリッジ、クラウドサービス、マーケットプレイス、Recued独自の社内ツールは、それぞれ別のものです。このリポジトリには含まれていません。

ソースコードは、レビュー済みのRecuedソースツリーのチェックポイント1つをフィルタリングしてコピーしたものです。このチェックポイントはgitコミットです。.recued-public-export.jsonには、どのコミットを使ったか、省かれた内容とその理由が記録されています。このREADME、インストールガイド、変更履歴、コントリビューター向けの説明は、ここで直接管理しています。

ライセンス

RecuedはGNU Affero General Public License、バージョン3のみ（AGPL-3.0-only）のもとでライセンスされています。