コネクタ
各コネクタが、チャットやスケジュールタスクでハルノに何をできるようにするか、コネクタの接続と解除の方法、そして月次決算にコネクタが必要ない理由を説明します。
コネクタの役割と、対象外の用途
コネクタを使うと、ハルノがチャットやスケジュールタスクの中で、お客様のアカウントやツールを利用できるようになります。メールの送信、カレンダーへの予定の追加、共有フォルダでの作業、チームのチャンネルへの投稿などです。コネクタは任意で、どのコネクタも月次決算には含まれません。
決算が読み取るのは、各社に追加したエクスポートか、[同期]で QuickBooks から取り込んだ月のデータだけです。また、決算が数値を記帳した各ファイルについて、フィンガープリント付きのコピーを保管します。そのため、決算済みの月は、監査人に示せるファイルに基づいています。ライブ接続は、誰かが遅れて届いた請求書や科目の振替を記帳するたびに内容が変わるため、その証跡にはなりません。「会社にファイルを追加する」をご覧ください。
| やりたいこと | 使うもの |
|---|---|
| 会社に月次のエクスポートをメールで依頼する | Gmail(Google のどのサインインでも可) |
| メールの中から会社のエクスポートを探し、添付ファイルを保存する | Gmail(組織の Google アプリ経由) |
| クラウドストレージや SharePoint ライブラリのファイルを扱う | Google ドライブ、OneDrive、SharePoint、Dropbox |
| 決算のための時間を予定に入れる、またはカレンダーを確認する | Google カレンダー |
| 決算の進捗状況をチームに投稿する | チャットでの Slack、またはお客様が作成するボット経由の Discord |
| Excel の明細表、Word のメモ、PowerPoint の取締役会向け資料を作成する | Office ツール。Microsoft Office は不要です。 |
| 基準やレート、提出期限を調べる | ウェブ検索(サインインしている間は常にオン) |
| 会社の QuickBooks の数値について質問する | コネクタはありません。[ポートフォリオ]で会社を追加し([会社を追加]▸[QuickBooks から])、チャットで質問してください。ハルノは会社の帳簿から回答します。 |
| Outlook のメールや Outlook カレンダーを扱う | Windows アプリのみ |
| 銀行、給与、Stripe、HubSpot の数値を取り込む | コネクタはありません。Stripe の請求書と HubSpot の取引のエクスポートは、ほかのエクスポートと同じように追加します。 |
ほかのデータソースからのエクスポート:「会計ソフト以外のデータソース」。毎月のメール依頼のひな形:「各社に月次のエクスポートを依頼する」。
コネクタが、会社へのファイルの追加、マッピングの変更、月の決算・ロック・再オープン、決算済みの月への数値の書き込みを行うことはありません。これらを行うのはアプリ自身の操作で、チャットでハルノが変更できるのは、お客様が依頼した場合の会社のマッピングだけです(「ハルノへの質問」をご覧ください)。また、コネクタが受信トレイやカレンダーを監視することもありません。ハルノがコネクタを使うのは、チャットで依頼したときと、スケジュールタスクが設定した時刻に実行されるときだけで、ハルノが起動している間に限られます。
[コネクタ]ウィンドウを開く
コネクタには専用のウィンドウがあり、[設定]ではなくアカウントメニューから開きます。「コネクタ」へ案内するメッセージは、このウィンドウを指します。
- サイドバー下部のアカウント行(お名前またはメールアドレスが表示されている場所)をクリックし、[コネクタ…]を選択します。
- コネクタの行で[サインイン]または[接続]をクリックします。Office ツールには、代わりにスイッチがあります。
行は、[Google](Gmail、Google カレンダー、Google ドライブ)、[クラウドストレージ](OneDrive、SharePoint、Dropbox)、[コミュニケーション](Slack、Discord)、[組み込みツール](Office ツール)のセクションに分かれており、詳細ビューではさらに[カスタム MCP サーバー]が加わります。ウェブ検索と、ハルノに渡したドキュメント、PDF、画像、音声の読み取りは常にオンで、行はありません。ハルノをインストールした後、コネクタは、セキュアサンドボックスの 1 回限りのセットアップが終わるまで待機します。それまでの間は、ウィンドウ下部の 1 行に、その状況が表示されます。「セキュアサンドボックス」をご覧ください。
ほとんどのコネクタは、ブラウザで開くサービス自身のページでサインインします。Discord ではボットトークンを入力します。Slack は、ハルノのサービスを通じてサインインします。そのため、先にハルノにサインインし(アカウントメニュー▸[サインイン…])、約 3 分以内にブラウザで完了してください。その間、行(クラウドストレージではシート)には「ブラウザでサインインを完了してください…」と表示され、[キャンセル]ボタンが付きます。
接続すると、Gmail、Google カレンダー、Slack、Discord の各行と、カスタムサーバーごとの行にスイッチが表示されます。オフにすると、サインイン情報は残したまま、ハルノがそのコネクタを使わなくなります。クラウドストレージにはスイッチがありません。ハルノが使えるものは、共有するフォルダで決まります。
ほかの人に届く操作ができるコネクタには、[…前に確認を求める]設定もあり、既定ではオンです。ハルノは、そこで何かを送信、投稿、変更する前に、チャットでお客様に確認します。クラウドストレージは常に確認します。これらはオンのままにしてください。会社にメールが届く前に内容を確認できるのは、この設定があるからです。「コネクタの確認スイッチ」をご覧ください。このウィンドウでの変更は、すでに開いているチャットではなく、次に開始するチャットから反映されます。変更を当てにする前に、新しいチャット(⌘N)を開始してください。
QuickBooks Online
QuickBooks Online には[コネクタ]に行がなく、チャットにもスケジュールタスクにも、QuickBooks のツールは用意されていません。「QuickBooks Online」の説明に従って、会社を接続し、その月のデータを同期して、決算してください。そのうえで、チャットは会社の帳簿から回答し、帳簿がどの月までのものかを伝えます。ハルノは QuickBooks を読み取るだけです。
Google:Gmail、Google カレンダー、Google ドライブ
Google の各サービスには、ブラウザで行う専用のサインインがあります。何ができるかは、サインインの経由先である Google アプリによって決まります。ハルノ内蔵のアプリか、お客様の組織にすでにある場合は、組織の Google アプリです(「組織の Google アプリ」をご覧ください)。
| コネクタ | 内蔵の Google アプリ | 組織の Google アプリ |
|---|---|---|
| Gmail | メールの送信とラベルの管理のみです。 | メールの検索と閲覧、添付ファイルの保存、スレッドへの返信、メールのゴミ箱への移動もできます。 |
| Google カレンダー | 予定の表示、追加、変更、削除ができます。 | 同じです。 |
| Google ドライブ | ハルノが作成するフォルダのみです。 | Drive のフルアクセスを選択したままにした場合は、ご自身のマイドライブです。共有ドライブや、自分と共有されているだけのフォルダは対象外です。 |
Gmail または Google カレンダーに接続する
- Gmail または Google カレンダーの行で[サインイン]をクリックし、ブラウザで Google が示すアクセスを許可します。Gmail では、「Send email on your behalf」(ユーザーに代わってメールを送信)を選択したままにしてください。外すと、Gmail は接続されません。
- ページに「サインインしました ✓」と表示されたら、ハルノに戻ります。行には、アカウント、スイッチ、[⋯]メニューが表示されます。
Gmail と Google カレンダーは、この Mac でそれぞれ 1 つの Google アカウントに接続します。別のアカウントでサインインすると、置き換わります。組織のアプリを経由する場合、ハルノはメールの添付ファイルを、そのチャットの作業フォルダ([ファイル]▸[フォルダーを開く…]で開いたフォルダ、またはハルノ自身の Workspace フォルダ)に保存できます。そのファイルで決算するには、ほかのエクスポートと同じように会社に追加してください。
Google ドライブに接続する
- Google ドライブの行で[接続]をクリックし、[Google Drive に進む]をクリックして、ブラウザでアクセスを許可します。Drive へのアクセスは選択したままにしてください。そうしないと、接続は作成されません。組織のアプリでは、マイドライブを利用するために「Google Drive のすべてのファイルの表示、編集、作成、削除」を選択したままにしてください。オフにすると、ハルノは専用のフォルダだけを使います。
- [保存]をクリックし、ハルノが使用できるフォルダにチェックを入れるか、[すべてを共有]をオンにして、[保存]をクリックします。
以降、Google ドライブは、ほかのクラウドストレージの接続と同じように動作します。組織の Google アプリが変更された場合、再度サインインが必要になると、その旨が行に表示されます。「メンバーの接続はどうなるか」をご覧ください。
OneDrive、SharePoint、Dropbox
[クラウドストレージ]セクションでは、Google ドライブと同様に、OneDrive、SharePoint のドキュメントライブラリ、Dropbox のフォルダを、この Mac 上のコピーと同期した状態に保ちます。OneDrive、SharePoint、Dropbox、Google ドライブでは、ハルノが使用できるフォルダをお客様が選び、ハルノがそこにあるものを削除することはありません。お客様が承認すれば、ハルノはファイルをゴミ箱に移動できます。OneDrive と Google ドライブが対象とするのはご自身のドライブだけです。そのため、共有ドライブや、自分と共有されているだけのフォルダは表示されないことがあります。そのようなファイルは、代わりにダウンロードしてください。
- 該当するサービスの行で[接続]をクリックします。OneDrive には[テナント(任意)]、SharePoint には[サイト ID(任意)]または[ドライブ ID(任意)]の入力欄があります。
- [OneDrive に進む]、[SharePoint に進む]、[Dropbox に進む]のいずれかをクリックしてサインインします。OneDrive、SharePoint、Dropbox は、アカウント全体へのアクセスを求めます。ハルノが使える範囲を限るのは、フォルダの選択です。
- [保存]をクリックし、ハルノが使用できるフォルダを選んで、[保存]をクリックします。
それまでは、行に「共有フォルダがまだありません — Haruno が使用できるフォルダを選択してください」と表示され、[フォルダを選択…]ボタンが付きます。
行の[⋯]メニューには、[共有フォルダ…]、[再確認]、[編集…]、[別のアカウントを追加…]、[サインアウト…]があります。行には、この Mac 上のコピーの状態として「同期中…」、「同期済み」、「同期エラー」も表示され、[再確認]は接続をテストします。フォルダの共有をやめるときは、ハルノがそのフォルダからダウンロードしたものを削除するかどうかを選べます。クラウド上のファイルは変更されません。チャットでは、クラウドフォルダをこの Mac で開く前、同期する前、ファイルをアップロードする前に、ハルノが確認します。開いたフォルダは双方向の同期が続くため、ハルノが行った変更はクラウドにも反映されます。検索できるのは Google ドライブだけです。
Slack
Slack を使うと、ハルノがチャットの中で、お客様のワークスペースにメッセージを投稿し、チャンネルを読み取れます。たとえば、決算の状況を財務チャンネルに投稿したり、会社に関する同僚の質問を探したりできます。Slack の行で[サインイン]をクリックし、ブラウザでワークスペースを選びます。先にハルノにサインインしておいてください。
Discord
Discord は、お客様が作成し、サーバーに招待したボットを通じて接続します。これにより、ハルノは、選択したチャンネルと、そのボットが見えるほかのすべてのチャンネルで、メッセージを読み取り、メッセージとファイルを投稿できます。1 つのチャンネルにとどめたい場合は、Discord でボットのアクセスを制限してください。
- Discord の開発者ポータルでアプリケーションを作成し、その Bot ページでトークンをリセットして、メッセージの送信とファイルの添付の権限を付けて、ボットをサーバーに招待します。
- Discord の行で[接続]をクリックし、トークンを[ボットトークン]に貼り付けて、[続ける]をクリックします。[サーバー]と[チャンネル]を選び、[このチャンネルを使う]をクリックします。
開発者ポータルでボットの Message Content Intent がオフの場合、ボットへのメンションを含むメッセージ以外は、ハルノが読み取ってもメッセージの内容が空になります。スケジュールタスクでは、Discord への投稿は、お客様の確認のために[保留中]に置かれます。
ウェブ検索
ウェブ検索は、サインインしている間は常にオンで、行はありません。ハルノは、基準の変更、税率、提出期限のように、最新の公開情報が必要な質問のときに検索します。検索した語句はお客様の Mac の外に送信されるため、調べてもらう内容に会社の機密情報を含めないでください。ハルノが検索の前に確認する場合、カードには「Haruno がウェブを検索しようとしています。」と「検索した語句はこの Mac の外に送信されます。」が表示されます。検索結果は手がかりとして扱い、出典を開いて日付を確認してください。ページを開くときには、「Haruno がこのウェブサイトを開くことを許可しますか?」と確認されることがあります(「ウェブサイト」をご覧ください)。
Office ドキュメント
Office ツールを使うと、Microsoft Office がインストールされていなくても、ハルノが Word、Excel、PowerPoint のファイルを作成・編集できます。たとえば、ロールフォワードの明細表、取締役会向けのメモ、業績報告のスライドなどです。Word、Excel、PowerPoint がインストールされている場合は、既定でオンになります。そうでない場合、行には「Microsoft Office がインストールされていません」と表示されますが、オンにすることはできます。ご自身で設定すると、その選択が維持されます。ワークブック、ドキュメント、PDF、画像の読み取り、音声の文字起こし、PDF の作成は、どちらの場合でも使えます。ハルノが作成したものをプレビューして保存する方法:「ハルノが書くドキュメント」。
カスタムサーバー(詳細ビュー)
詳細ビューでは、[コネクタ]ウィンドウに[カスタム MCP サーバー]セクションがあり、お客様自身のサーバーにハルノを接続できます。MCP(Model Context Protocol)は、AI アシスタントにツールを提供するためのオープンな標準規格です。ほとんどの財務チームでは、必要になることはありません。
- [設定]▸[一般]で、[詳細ビュー]をオンにします。
「通常ビューと詳細ビュー」をご覧ください。
- [サーバーを追加]をクリックし、[名前]と[サーバー URL](通常は https://…)を入力して、[認証]で[なし]、[ヘッダー]、[OAuth]のいずれかを選びます。
- [接続]をクリックし、各ツールを[オン]、[確認]、[オフ]のいずれかに設定して、[保存]をクリックします。
[確認]にすると、ハルノは使用のたびにチャットで確認します。「カスタムサーバーのツールごとの設定」をご覧ください。
セキュアサンドボックスは、この Mac 上のサーバーに localhost アドレスではアクセスできません。ホスト名またはネットワークアドレスを使用してください。詳細ビューをオフにすると、このセクションは非表示になります。ハルノにサーバーを使わせないようにするには、先にそのサーバーをオフにするか、削除してください。
スケジュールタスクでのコネクタ
スケジュールタスクでは確認する人がいないため、確認の設定は適用されません。メール、返信、ゲストを含むカレンダーの招待、Discord への投稿、同期しているクラウドフォルダへの変更は、お客様が送信するまで[保留中]で待機します。ラベルの操作、ゴミ箱への移動、ゲストのいない予定は、すぐに実行されます。既存の予定の変更や削除は拒否されます。自動送信を許可されたタスクは、これらをすべてすぐに実行します。タスクに Slack やカスタムサーバーが提供されることは、送信を許可されているかどうかにかかわらず、ありません。「保留されるものと、すぐに実行されるもの」をご覧ください。
コネクタが共有する内容と、サインイン情報の保管場所
コネクタのサインイン情報は、お使いの Mac のログインキーチェーンに保管されます。別の Mac や Windows アプリには移りません。また、ハルノのアカウントを削除しても、そのまま残ります。オンにしたコネクタは、セキュアサンドボックスがそのサービスにアクセスすることも可能にするため、ウェブサイトとして許可するかどうかは確認されません。サービスが返した内容はチャットの一部となり、チャットは Inferara のホスティングサービスを経由してモデル提供事業者に送られます。「データの取り扱いとセキュリティ」をご覧ください。
接続の解除
コネクタを一時停止するには、オフにします。サインイン情報は残ります。終了するには、行の[⋯]メニューを使います。
| コネクタ | メニュー項目 | 動作 |
|---|---|---|
| Gmail、Google カレンダー、Slack | [サインアウト] | サインイン情報を削除し、サービスにハルノのアクセスの終了を依頼します。 |
| Google ドライブ、OneDrive、SharePoint、Dropbox | [サインアウト…] | サインイン情報を削除します。ダウンロードしたファイルを残すかどうかは選べます。クラウド上のファイルは変更されません。 |
| Discord | [接続を解除] | ボットトークンを削除します。ボットは、Discord で削除するまでサーバーに残ります。 |
| カスタムサーバー | [削除] | ハルノはそのサーバーを使えなくなります。 |
アクセスが確実に終了したことを確かめるには、サービス自身のアカウント設定でも、ハルノを削除してください。[ローカルデータを削除…]は、この Mac 上のすべてのコネクタのサインイン情報を、帳簿など、ハルノがこの Mac に保管しているほかのすべてのものとともに消去します。どのサービスにも通信しません(「ローカルデータの削除」をご覧ください)。サービスが保存済みのサインイン情報を拒否した場合、ハルノは、そのコネクタのツールを最長 1 日間、または行から再度サインインするまでオフにします。その後、新しいチャットを開始してください。
表示されることのあるメッセージ
ほとんどのメッセージは「トラブルシューティング▸コネクタ」に、Google 関連のメッセージは「メンバーの Mac の場合」にあります。そのほかは次のとおりです。
| 表示される内容 | 対処方法 |
|---|---|
| 「Slack を接続する前に、設定で Haruno にサインインしてください。」 | アカウントメニュー▸[サインイン…]を選択してから、接続します。 |
| 「Slack のサインインがタイムアウトしました。もう一度お試しください。」 | もう一度サインインし、約 3 分以内にブラウザで完了します。 |
| 「Discord がそのボットトークンを受け付けませんでした。アプリケーションの Bot ページからもう一度コピーしてください。」 | 開発者ポータルからトークンをもう一度コピーします。 |
| 「このボットはまだどのサーバーにも招待されていません。…」 | 開発者ポータルから招待し、そのあとシートを開き直します。 |
| 「ボットがそのチャンネルを参照できません。…」または「そのサーバーで参照できるテキストチャンネルがありません。…」 | Discord でボットにチャンネルへのアクセスを許可してから、もう一度試すか、サーバーを選び直します。 |
| 「Discord からペースを落とすよう求められています。少し待ってからもう一度お試しください。」 | しばらく待ってから、もう一度お試しください。 |
| 「今回のサインインで使用された Google アプリでは、この Google サービスが有効になっていません。…」 | 組織の管理者が、組織の Google アプリでそのサービスを有効にします。 |
| 「この接続からは、あなたの Google Drive 内の Haruno フォルダしか見えなくなりました。…」 | [⋯]▸[編集…]を選び、Drive のフルアクセスで再度サインインして、フォルダをもう一度選択します。 |
| 「https:// の URL を入力してください。」 | カスタムサーバーに https:// のアドレスを指定します。 |
| 「キーチェーンのロックを解除して再接続してください。」 | Mac のログインキーチェーンのロックを解除します。 |
| 「この接続を使い続けるには、まもなく再度サインインしてください。」 | その Google の接続は、ハルノがもう持っていないアプリを通じて作成されたものです。もう一度サインインしてください。 |
| 「ツールサーバーに接続できません」 | ハルノを終了してから開き直します。表示が消えない場合は、サポートにお問い合わせください。 |
Windows の場合
Windows アプリにもコネクタがあります。Mac との違いについては、「Windows 版ハルノ」をご覧ください。
| 項目 | Mac | Windows |
|---|---|---|
| 場所 | アカウントメニュー▸[コネクタ…] | [設定]▸[コネクタ]の[連携]カード |
| オンにする方法 | [サインイン]または[接続] | [有効にする]でハルノのカタログから署名済みパッケージをダウンロードしてから、[接続] |
| カスタムサーバー | 詳細ビューのみ | 詳細ビューのみで、サンドボックス内のセッションでは使用できません |
| スケジュールタスク | 外部への操作は[保留中]で保留 | [確認]に設定したツールは拒否され、[保留中]のキューはありません |
| 削除する方法 | [サインアウト]または[接続を解除] | [削除]でパッケージと、保存済みのアカウント情報を削除 |
Windows アプリにしかないコネクタ
| コネクタ | できること |
|---|---|
| Outlook メール | メールの検索、閲覧、送信、返信、削除 |
| Outlook カレンダー | 予定の読み取りと管理 |
| Notion | ワークスペースの検索と更新 |
| Telegram | メッセージとファイルのためのボット |
| 弥生 | Misoca での請求書発行。先に、組織の管理者が組織の Misoca アプリを登録します。 |
| 弥生会計 Next | 1 か月分の仕訳または残高試算表を、プロジェクトフォルダーにエクスポートします。読み取り専用のため、弥生会計で何かが作成、変更、支払いされることはありません。その月を決算するには、残高試算表の ZIP を会社に追加してください。 |
この一覧はハルノのカタログから取得されるため、アプリをアップデートしなくても変わることがあります。Git、LinkedIn、WhatsApp、X は、すでにそのコネクタを導入している PC にだけ提供され、QuickBooks Online はコネクタではありません。ウェブ検索と、ファイルの読み取りおよびプレビューは常にオンで、カードはありません。承認については、「Windows での承認」をご覧ください。Windows では、Google ドライブの接続時に、[Haruno 接続フォルダー]か[マイドライブ]のどちらかを選ぶよう求められます。「Windows の Google コネクタ」をご覧ください。