Customermates

AGPL ライセンスのコミュニティ版、AI エージェント、API、MCP、セルフホストに対応したオープンコアの CRM です。

ウェブサイト | デモ | ドキュメント | GitHub | 使い方の解説

Customermates は、一般的なエンタープライズ向け製品のような複雑なセットアップをせずに、連絡先、組織、取引、サービス、タスクを明確に管理したい現代のチーム向けの CRM です。実用的な CRM ワークフローに、API アクセス、Webhook、n8n による自動化、MCP ベースのツール、AI エージェントのワークフローを組み合わせています。

マネージドクラウド版を利用することも、Docker Compose を使って独自のインフラストラクチャ上で Customermates を実行することもできます。

🚀 はじめに

Customermates の利用を開始する方法は 2 つあります。

オプション	説明
クラウド	最も手軽に開始できます。Customermates が管理します。
セルフホスト	Docker Compose と PostgreSQL を使って、独自のサーバーで Customermates を実行できます。

ドキュメントへのリンク：

• CRM の概要
• セルフホスト（インストール、管理、クラウドとセルフホストの比較）
• AI（Claude）を接続する
• Webhook

⭐ 主な機能

• 連絡先、組織、取引、サービス、タスク向けの CRM
• OpenAPI ドキュメント付きの API アクセス
• Webhook とイベント駆動型の統合
• n8n のワークフローと自動化に対応
• エージェント向けツールと構造化されたツール呼び出しに対応する MCP サポート
• メール、LinkedIn、WhatsApp、Instagram、Telegram の統合受信トレイ（クラウド版、Pro プランから）
• 監査ログ
• Enterprise プランでシングルサインオンとホワイトラベルに対応（セルフホスト型 Enterprise の導入は契約によります）
• チーム向けのロールベースのアクセス制御
• 1 つのログインで複数の独立したワークスペースを利用でき、それぞれに独自のデータモデル、メンバー、請求、API キー、MCP 接続があります
• Docker Compose と PostgreSQL によるセルフホスト型のデプロイ
• クラウド版は月額のユーザー単位の料金です。詳しくは現在のプランをご覧ください

📊 比較

Customermates は、クラウドとセルフホストの両方のデプロイ方式に対応しています。

基準	クラウド	セルフホスト
料金	月額のユーザー単位のプラン	コア機能は無料 + インフラストラクチャの費用
セットアップ時間	2 分	約 15 分
必要なメンテナンス	なし	Docker、Postgres、プロキシ、TLS、バックアップ
更新	自動	docker compose pull && docker compose up -d
EU でホスト	✅	任意の場所に設置できます
バックアップ	毎日自動	自分で設定
API と統合	✅	✅
ユーザー数無制限	✅	✅
レコード数無制限	✅	✅
1 つのログインで複数のワークスペースを利用	✅（それぞれに独自のプラン）	✅
n8n と自動化ワークフロー	✅	✅
統合受信トレイとカレンダー同期	Pro プランから	❌（クラウド版の機能）
監査ログ	含まれます	含まれます
Enterprise（SSO、ホワイトラベル）	Enterprise プラン	契約による

詳しい選び方については、セルフホストのドキュメントをご覧ください。

🐳 セルフホスティング

セルフホスティングに必要なのは、2 つのファイル（docker-compose.yml と .env）と docker compose up -d の実行だけです。git clone もビルド手順も不要です。公開イメージ ghcr.io/customermates/customermates:latest は、起動のたびに保留中のマイグレーションを適用します。

前提条件

• Docker と Docker Compose v2。
• TLS を使用する場合はドメイン名（ローカル環境では任意）。
• 1,000 レコードあたり約 2 GB の RAM と数 GB のディスク容量。

セットアップ

mkdir customermates && cd customermates
curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/docker-compose.yml -o docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/.env.selfhost.template -o .env
# edit .env with real values
docker compose up -d

必須の .env 値：

• BETTER_AUTH_SECRET：長いランダム文字列（openssl rand -hex 32）。
• POSTGRES_PASSWORD：デフォルト値を変更します。
• BASE_URL：公開 URL（例：https://crm.example.com）。
• RESEND_API_KEY と RESEND_OPERATOR_EMAIL：サインアップの確認、パスワードのリセット、招待メールに使用します。

任意：GOOGLE_CLIENT_ID と GOOGLE_CLIENT_SECRET、または AZURE_AD_CLIENT_ID と AZURE_AD_CLIENT_SECRET のコメントを解除すると、Google または Microsoft でのサインインを提供できます。ユーザーは Google または Microsoft でサインインできますか？をご覧ください。

CRON_SECRET（openssl rand -hex 32）を設定し、毎日この値を使って /api/cron/lifecycle を呼び出してください。そうしないと、Trash は 30 日後も空になりません。実行が必要なスケジュールジョブをご覧ください。

Prisma がマイグレーションを適用するため、初回起動には約 1 分かかります。docker compose logs -f app でログを確認してから、<BASE_URL>/auth/signup を開いてください。

日常の運用

docker compose pull && docker compose up -d   # update
docker compose up -d                           # apply .env changes
docker compose logs -f app                     # logs

TLS 用のリバースプロキシ（Caddy、nginx、Traefik）の背後にアプリを配置し、BASE_URL を公開 https:// アドレスに設定してください。Customermates はリンクのスキームとホストに BASE_URL を使用し、https:// を使用する場合はセキュア Cookie を設定するため、X-Forwarded-Proto は不要です。サインインやサインアップなど、送信元がホストと一致しないフォーム送信はアプリが拒否するため、プロキシは元の Host ヘッダーを引き継ぐ必要があります。

その他のドキュメント：

• セルフホスティング（インストールと管理）
• アーキテクチャとセキュリティ

🛠️ 開発

分離されたワークツリーを作成し、Customermates をローカルで実行します：

git fetch origin main
git worktree add ../customermates-my-change -b feat/my-change origin/main
cd ../customermates-my-change
nvm use
yarn db:provision
cp .env.cloud.template .env
# Paste the printed DATABASE_URL and DIRECT_URL into .env.
yarn install --frozen-lockfile
yarn db:reset
yarn dev

yarn db:provision は、現在のワークツリーが所有する名前付きボリュームと PostgreSQL 17 コンテナーを作成します。繰り返し実行しても問題ありません。yarn db:reset はマイグレーションを適用し、データベースにシードデータを投入して、ワークフローのスキーマを準備します。データベースボリュームの置き換えは破壊的な操作で、yarn db:provision --recreate を実行した場合にのみ行われます。ワークツリーを廃止するときは、yarn db:provision --destroy を使って、そのワークツリーが所有するデータベースを削除してください。

便利なスクリプト：

• yarn dev
• yarn build
• yarn lint
• yarn openapi:generate
• yarn db:provision
• yarn db:reset

設定可能な CRM アーキテクチャのレビュー、分離されたデータベース、本番ビルドでのブラウザ操作、SSH による検証については、ブラウザ検証ガイドをご覧ください。

📚 ドキュメント

ドキュメントでは、以下を扱っています：

• 製品の概要と CRM の比較
• セルフホスティングと運用
• API 連携と OpenAPI
• MCP と n8n
• アーキテクチャとセキュリティ

まずはこちらをご覧ください：customermates.com/docs

📄 ライセンス

Customermates はオープンコアライセンスモデルを採用しています。

コミュニティ版（ee/ 外のファーストパーティコードすべて）は、AGPL-3.0-only の下でライセンスされています。

ee/ 内のその他のファーストパーティファイルは、AGPL クライアント資料に関する例外の適用を受け、Customermates Commercial License の下でソースコードを利用できます。限定的な Community Build の許可範囲を超える商用ソフトウェアの本番環境での使用には、エンタープライズ機能の使用を含め、商用契約が必要です。

公式のコミュニティイメージ ghcr.io/customermates/customermates は共有コードベースからビルドされ、コンパイル済みの商用ソフトウェアを含みます。限定的な Community Build の許可により、ドキュメントに記載された APP_MODE=self-hosted の動作で必然的に実行される、変更されていない商用サポートコンポーネントは誰でも実行できます。ただし、エンタープライズ機能の使用は許可されません。

コントリビューター規約は.github/CLA.mdで確認できます。

サードパーティのデータには、それぞれ独自のライセンスが適用されます。Customermates に同梱される Google libaddressinput の住所形式と、GeoNames からダウンロードする郵便番号は、CC BY 4.0 の下でライセンスされています。詳細はTHIRD_PARTY_NOTICES.mdをご覧ください。