インストール
make install誰に向いているか
Margince は自分でデータを埋めていく CRM です。公式ページによると、メール・会議・カレンダーから自分のレコードを自動入力し、AI エージェントはその中でユーザーと同じルールに従って動きます。向いているのは 2 種類の人です。1 つは、顧客情報がメールボックスやカレンダー招待、会議のやり取りに散らばっていて、手作業の入力を最小限にしたいチームや個人。もう 1 つは、照会やフォローアップといった日常的な操作を AI エージェントに CRM 内で直接担わせたいが、エージェントに人間の権限体系をバイパスしてほしくない人です。
向いていない、または始める前に考えたいケース：自分でサービスを運用したくない人——公式ページが述べているのは、コアが backend/ の Go モジュールと frontend/ の React アプリであることだけで、ソースから自分でビルドして実行する必要があり、具体的な依存ツールやバージョンは示されていません。また、license token を取得する前からすぐ使えると期待する人——公式には、サーバーの起動には Gradion の license token が必要で、1 シートのデプロイでも同じだと明記されています。
3 分で最初の試行を完了する
公式ページが裏付けるメインパスは次の一段だけです。公式リポジトリから margince のソースを取得し、リポジトリのルートに入って、次を実行します。
make install
公式の文言は「Install the tools and the git hooks once: make install.」、つまり必要なツールと git hooks を一度だけインストールするというものです。観測できる成功のサイン：ツールがインストールされ、リポジトリの git hooks が有効になること。これが公式の説明で裏付けられるインストール手順のすべてです。
着手前に知っておくべきこと：サーバーの起動には Gradion が発行する license token が必要で、1 シートでも例外ではありません。公式ページには開発用途の免除や無料枠の記載がないため、ローカルでサービスを動かすなら token なしで済むと考えないでください。token を手に入れる前は、インストールまでが限界です。
その先について、公式はアクセス方式が MCP または REST であると説明していますが、起動コマンド、サービスのエンドポイント、エージェントツールの名前とパラメーターは公式ページには示されておらず、リポジトリ内で自分で確認する必要があります。接続後の最初の呼び出しは読み取りまたは発見系の操作にとどめ、エージェントに何ができるかを見てから、レコードを変更する操作を検討してください。
ユースケース
事例 1：権限ルールの中でエージェントに顧客レコードを閲覧させる。シーン：AI エージェントが本当に CRM 内で働けるかの検証。方法：インストールを終え、license token を用意したうえで、MCP クライアントをサービスに接続し、照会系のリクエストを 1 回送ります。期待できる結果：公式の位置づけでは、エージェントはユーザーと同じルールに従い、何を見られるかはその権限で決まります。エビデンスの境界：具体的なツール名やエンドポイントは公式ページになく、確認できるのは「アクセス方式が MCP または REST」の部分までです。リクエストの前にリポジトリ内でツール一覧を確認してください。
事例 2：メール・会議・カレンダーから CRM に顧客レコードを自動入力させる。シーン：手作業の入力を減らし、メールボックスやカレンダーに散らばる顧客とのやり取りをレコードに変える。方法：サービスが使えるようになったら、これらのデータソースを接続します。期待できる結果：レコードがシステムによって自動入力されること。これは公式の説明が記す中核的な動作です。副作用の注意：自動入力はメール・会議・カレンダーの情報を CRM のレコードに書き込みます。データソースをどう認可して接続するかは公式には説明がなく、接続する前にどのメールボックスとカレンダーをつなぎ、どれをつなぐべきでないかを決めてください。
利用の境界
読み書きの性質：Margince はメール・会議・カレンダーの情報を CRM のレコードに自動書き込みします。データは入った時点でレコードの内容になります。エージェントはユーザーと同じルールで、能力の上限もユーザー並みなので、最初の試行は読み取りと発見にとどめるのが無難です。
ライセンスと認証情報：サーバーの起動には Gradion の license token が必要で、1 シートでも同じです。開発免除、無料枠、課金基準の有無は公式ページに説明がなく、ローカル開発がライセンス不要だと想定してはいけません。
未確認の重要情報：依存ツールとバージョン、起動コマンド、MCP/REST のエンドポイント、エージェントツールの一覧、license の申請手順、ホスト型版の有無は、いずれも公式ページに説明がありません。公式の情報は非常に限られており、この記事は公式説明で裏付けられる内容だけを書いています。正確な設定はリポジトリ内の実際のファイルを正とし、着手前に一つずつ確認してください。