導入・運用ガイド

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 アカウントと紐付けます。

管理者が行うこと

  1. Slack App を作るワークスペースに App を作成し、Bot Token Scopes に commands と chat:write を追加してインストールします。注文書・請求書の PDF を取り込む場合は files:read も追加します。
  2. スラッシュコマンドを登録するSlash Commands に /maskeel を追加し、Request URL に Maskeel の /integrations/slack/commands を指定します。
  3. ボタンを有効にするInteractivity をオンにし、Request URL に /integrations/slack/interactions を指定します。「確定」「取消」ボタンの操作がここに届きます。
  4. Maskeel に接続情報を登録するSigning Secret・Bot Token・ワークスペース ID を、導入時にご案内する安全な方法で Maskeel に登録します。チャットやメールには貼り付けません。
  5. チャンネルに招待する使うチャンネルに Maskeel を招待します。PDF を取り込む場合は Event Subscriptions で file_shared を受け取り(Request URL は /integrations/slack/events)、注文書用・請求書用の取込チャンネルを指定します。

メンバーが行うこと

  1. 連携コードを発行するMaskeel にログインし、「設定 → Slack 連携」で会社と本人を確かめて「連携コードを発行」を押します。
  2. Slack に貼る表示された /maskeel link コード を、10 分以内に Maskeel のいるチャンネルで送信します。コードは 1 回だけ使えます。
  3. 連携を確かめる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 で管理し、データベースは自動バックアップと任意時点への復元、削除保護を有効にしています。

自動テスト

守れていることを、テストで確かめる

他社のデータに届かないこと、権限のない人が承認できないこと、監査証跡の改ざんを検知できることを、変更のたびに自動テストで確かめています。

セキュリティについての個別のご質問はお問い合わせからどうぞ。