導入・運用ガイド
Slack設定と、
運用の仕組み。
業務への導入を具体的に検討する方向けの情報です。
01
Slack から動かせる ERP。
現場は、いつもの Slack で /maskeel と打つだけ。照会はその場で答え、残高が動く操作は確認カードを返し、本人が「確定」を押して初めて記録されます。回答は操作した本人にだけ表示されます。
# 営業部Maskeel が参加しています
山田
/maskeel 今月のサンプル社の未出荷の受注一覧
Maskeel アプリ あなただけに表示
今月の受注一覧です(得意先:サンプル 期間:2026-09-01〜2026-09-30 状態:未出荷)
受注 得意先 受注日 状態 税抜合計 SO-19 サンプル商事 2026-09-17 引当済 ¥400 SO-22 サンプル商事 2026-09-24 在庫待ち ¥18,600
山田
/maskeel 出荷 SO-19 出荷日=2026-09-30
Maskeel アプリ あなただけに表示
出荷の確認 SO-19
サンプル商事 商品A × 2 出荷日 2026-09-30
在庫 14 → 12 評価原価 ¥12,400
佐藤
注文書_サンプル商事_0930.pdf
Maskeel アプリ
注文書を読み取りました。3 明細・税抜合計 ¥86,000。帳票と照合のうえ、受付した本人が確定してください。
コマンド例
定型の書き方でも、自然な日本語でも通じます。
- 照会
-
/maskeel 在庫 商品A -
/maskeel 受注照会 SO-19 -
/maskeel 受注検索 得意先=サンプル 期間=今月 状態=未出荷 -
/maskeel 未入金 得意先=サンプル - 受注と変更
-
/maskeel 得意先Aから商品Aを2個、単価200円で受注 -
/maskeel SO-19の受注数を3個に変更して -
/maskeel 受注取消 SO-19 理由=顧客の依頼 - 出荷・売上・入金
-
/maskeel 出荷 SO-19 出荷日=2026-09-21 -
/maskeel 売上計上 SO-19 計上日=2026-09-21 -
/maskeel 請求書発行 SO-19 -
/maskeel 入金 SO-19 入金額=1000.00 入金日=2026-09-21 - 返品
-
/maskeel 返品候補 SO-15 -
/maskeel SO-15の2行目を3個返品 理由=数量過剰 - 書類の取込
- 取込用チャンネルに顧客の注文書 PDF → 受注の下書き
- 仕入先の請求書 PDF → 照合の下書き
Slack で呼び出すための設定
管理者が一度だけ Slack App を用意し、各メンバーが自分の Maskeel アカウントと紐付けます。
管理者が行うこと
-
Slack App を作るワークスペースに App を作成し、Bot Token Scopes に
commandsとchat:writeを追加してインストールします。注文書・請求書の PDF を取り込む場合はfiles:readも追加します。 -
スラッシュコマンドを登録するSlash Commands に
/maskeelを追加し、Request URL に Maskeel の/integrations/slack/commandsを指定します。 -
ボタンを有効にするInteractivity をオンにし、Request URL に
/integrations/slack/interactionsを指定します。「確定」「取消」ボタンの操作がここに届きます。 - Maskeel に接続情報を登録するSigning Secret・Bot Token・ワークスペース ID を、導入時にご案内する安全な方法で Maskeel に登録します。チャットやメールには貼り付けません。
-
チャンネルに招待する使うチャンネルに Maskeel を招待します。PDF を取り込む場合は Event Subscriptions で
file_sharedを受け取り(Request URL は/integrations/slack/events)、注文書用・請求書用の取込チャンネルを指定します。
メンバーが行うこと
- 連携コードを発行するMaskeel にログインし、「設定 → Slack 連携」で会社と本人を確かめて「連携コードを発行」を押します。
-
Slack に貼る表示された
/maskeel link コードを、10 分以内に Maskeel のいるチャンネルで送信します。コードは 1 回だけ使えます。 -
連携を確かめるMaskeel に戻り「連携状態を更新」で「連携済み」になれば完了です。
/maskeel 在庫 商品Aで試してみてください。
安全のために
- すべてのリクエストを Slack の署名と時刻で検証
- 権限は Maskeel 側の設定どおり。処理時と返信の直前に確認
- 同じ確認の再送でも、二重に記録しない
- AI が読み取るのは下書きまで。確定するのは人
- 通常のチャンネル発言は読み取らない
02
見えないところを、計算機科学で守る。
会社の取引と数字を預かる以上、守りは後付けにしません。暗号学的ハッシュによる改ざん検知、要求のたびに検証するゼロトラスト、必要な権限だけを与える最小権限。いまのセキュリティ工学で標準とされる考え方を、業務ロジックの中に組み込んでいます。
SHA-256 ハッシュ連鎖
改ざんを、あとから見抜ける記録
すべての操作を、ひとつ前の記録のハッシュとつなげて残します。ブロックチェーンと同じ考え方で、途中の 1 件でも書き換えれば連鎖が崩れます。月次締めのたびに全件を検証します。
ハッシュ化・一定時間比較
秘密は、保存しない
API キー、パスワード再設定、Slack 連携コード、Idempotency-Key は、元の値ではなくハッシュだけを保存します。照合は処理時間から推測されない一定時間比較で行い、パスワードはソルト付きの PBKDF2-SHA256 で保管します。
ゼロトラスト・最小権限
要求のたびに、確かめる
すべての要求で「どの会社の、だれか」を照合し、他社のデータには届きません。権限は役割とエージェントごと、API キーは操作の範囲(スコープ)と最長 90 日の期限つき。時間をおいて実行される処理でも、実行の時点の権限を確かめ直します。
排他制御・状態の指紋
正しい順番で、一度だけ
会社ごとの書込ロックで記録を一列に並べ、確認と確定のあいだに在庫や残高が変わっていれば、状態の指紋(ハッシュ)の違いで検知して止めます。同じ要求の再送は Idempotency-Key で一度だけに。締めた月の記録は変わりません。
署名検証・入力検査
外からの入口を、疑ってかかる
Slack からの要求は HMAC-SHA256 の署名と 5 分以内の時刻で本物か確かめます。取り込むファイルは種類・大きさ・先頭のバイト列まで確認し、ログインの試行回数を制限。ブラウザには HSTS・CSP などの保護ヘッダーを返します。
メイカー/チェッカー
AI に、確定させない
AI が行うのは読み取りと下書きまで。文書の中に書かれた命令には従わないよう指示し、1 日の利用回数にも上限を設けています。記録を確定するのは、権限を持つ人です。
Google Cloud 東京リージョン
基盤は、日本のクラウドに
アプリケーションとデータベースは Google Cloud の東京リージョンで動かしています。接続情報などの秘密は Secret Manager で管理し、データベースは自動バックアップと任意時点への復元、削除保護を有効にしています。
自動テスト
守れていることを、テストで確かめる
他社のデータに届かないこと、権限のない人が承認できないこと、監査証跡の改ざんを検知できることを、変更のたびに自動テストで確かめています。
セキュリティについての個別のご質問はお問い合わせからどうぞ。