mcpField
H
HQBase

HQBase

リモート
hqbase.ioコミュニケーション3512 週間前に更新
リポジトリ公式サイト

HQBase について

HQBaseは、チームが自社のCloudflareインフラで運用するオープンソースの共有メールワークスペースです。OAuthで保護されたリモートMCPサーバーにより、メールや認証情報を管理下に置いたまま、AIエージェントが共有メールの業務に接続できます。

主な機能

  1. 01共有メールボックスとチームアクセス制御
  2. 02複数ドメイン設定と下書き
  3. 03監査履歴
  4. 04インストール、更新、バックアップ、復旧

活用シーン

  1. 01AIエージェントによるチーム共有メールの処理
  2. 02チームアクセス制御による共有メールボックス管理

MCP 対応

HQBaseは、AIエージェントがワークスペースに接続するためのOAuth保護付きリモートMCPサーバーを提供します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://{installation_domain}/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

HQBase

HQBase

チームのメールワークスペースを、チームのインフラ上で。

Cloudflare アカウント上で動作し、メールと認証情報をお客様が管理するインフラに保管する、オープンソースの共有メールワークスペースです。

ウェブサイト · ドキュメント · リリース · コントリビューション

CI ステータス 最新リリース AGPL-3.0-only ライセンス HQBase Discord コミュニティに参加 X で @berman_to をフォロー

Cloudflare にデプロイ

HQBase について

HQBase の共有受信トレイ画面

HQBase を使うと、チームは共有メールボックスを一か所で利用でき、アプリケーション、メール、 Cloudflare の認証情報をお客様のインフラに保管できます。以下の機能を備えています。

  • 共有メールボックスとチームのアクセス制御。
  • マルチドメイン設定、下書き、監査履歴。
  • インストール、アップデート、バックアップ、復旧の操作。
  • OAuth で保護されたリモート MCP サーバー。

インストール、日常的な利用、アーキテクチャ、運用については、製品ドキュメントをご覧ください。

コミュニティが開発したプロジェクト

HQBase を活用した開発が広がるのを見るのは大きな喜びです。独立したクライアントを使えば、ワークスペースをさらに多様な方法で利用できます。

  • Herald — HQBase 用の macOS ネイティブメールクライアントです。

HQBase は互換性確認のため Herald をテストしています。これは独立したコミュニティの開発者が作成、保守しているため、リリース、サポート、動作に関する責任は HQBase ではなく、開発者が担います。プロジェクトの内容を確認し、ご自身のワークスペースに適しているかご判断ください。

ローカルで開発する

アプリケーションを起動する
pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

任意のシードコマンドを実行する前に、以下の値を .dev.vars に追加してください。

  • BETTER_AUTH_SECRET
  • 8～128 文字の HQBASE_LOCAL_SEED_PASSWORD

シードコマンドはローカルの D1 にのみ書き込み、Cloudflare OAuth には接続しません。http://127.0.0.1:5173/ を開き、[email protected] とそのパスワードでサインインしてください。Vite はポート 5173 でライブリロード対応のフロントエンドを配信し、API リクエストをポート 8787 の Wrangler Worker にプロキシします。

初回セットアップのフローを利用するには、シードコマンドを実行せずに http://localhost:5173/setup を開いてください。

ローカルデータをリセットする

ローカルの D1 データをすべて破棄し、スキーマを再構築して、デモ用ワークスペースを再作成するには、次のコマンドを実行します。

pnpm db:reset:local
pnpm db:seed:local

リセットコマンドは破壊的な操作で、ローカル環境にのみ適用されます。デプロイ済みのデータベースには変更を加えません。

セットアップ画面をプレビューする

プレゼンテーションのみを目的とするオンボーディング作業では、次のコマンドを実行します。

pnpm dev:setup-ui

http://127.0.0.1:5173/__ui/setup を開いてください。

ビジュアルシステムを確認する

共有コンポーネント、インタラクティブな状態、製品のパターン、ローカルの画面ルートを確認するには：

pnpm dev:ui

http://127.0.0.1:5173/__ui/design を開きます。ギャラリーでは再現性のある表示用フィクスチャを使用し、製品 API は呼び出しません。

変更を検証する

ローカルの品質ゲートをすべて実行します：

pnpm check
pnpm deploy:dry-run

wrangler.jsonc を変更した後は、pnpm cf:typegen を実行してください。

main へのプッシュでは、同じ品質ゲートとデプロイのドライランが実行されます。ステージング環境へのデプロイは手動で行い、署名付きリリースワークフロー内でも実行されます。リリースは、直前の安定版が署名済みの候補バージョンに正確にアップグレードされ、チェックに合格するまでドラフトのままです。顧客のインストールと更新では、デプロイ前に署名済みマニフェストとアーティファクトのダイジェストを検証します。

ドキュメント

hqbase.io/docs は、ユーザーおよび運用担当者向けガイド、製品仕様、メンテナー向け手順を公開しています。

コントリビューション

プルリクエストを作成する前に、コントリビューションガイドをお読みください。

セキュリティ

脆弱性を報告するには、セキュリティポリシーに記載されている非公開の手順に従ってください。

ライセンス

HQBase は、GNU Affero General Public License v3.0 only の下で利用できます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。