API キーと外部アプリの接続
ソクミツのデータを、他のシステムや AI アシスタントから使えるようにするための設定です。組織の管理者が行います。
現在この機能は限定提供中です。利用ご希望の場合は お問い合わせ からご相談ください。
設定する場所は「管理 → データ連携」です (管理のメニューは管理者にだけ表示されます)。使う場面に合わせて、次の 2 つを使い分けます。
| 設定 | 画面 | 使う場面 |
|---|---|---|
| API キー | 管理 → データ連携 → API キー | 定期的なデータの取り込みなど、人を介さない処理に使うとき |
| 外部アプリの接続 | 管理 → データ連携 → AI アシスタント・外部アプリ | ほかのアプリや、Claude・ChatGPT などの AI アシスタントから、利用者本人の同意で接続するとき |
どんな時に使う?
- 会計システムとの連携: 確定した見積を会計ソフトに取り込む
- CRM（顧客管理）との同期: 顧客や案件を他のシステムと共有する
- 集計・分析ツール: 売上データを集計ツールに取り込んでグラフにする
- AI アシスタント: Claude や ChatGPT から、見積や顧客を探したり、商品マスタの設定を相談しながら変えたりする
API キーを発行する
「API キー」の画面の「新しいキーを発行する」で、用途を入れ、必要な権限にチェックを入れて「発行」を押します。
| 項目 | 内容 |
|---|---|
| 用途 | 何に使うキーかが分かる名前（例: 「会計連携用」） |
| 権限 | 「参照」だけか、「マスタの更新」「顧客・案件・見積の編集」も許すか |
| 個人情報 | 顧客の氏名・連絡先・住所なども渡すか。既定は渡しません |
「マスタの更新」で変えられるのは、商品と商品マスタ系の設定（見積タイプ・価格タイプ・商品カテゴリ・オプション・オプションセット）と、Salesforce との連携設定です。「顧客・案件・見積の編集」では、顧客・案件の登録と編集と、見積の下書きの作成・編集ができます（顧客と見積には「個人情報」も必要です）。見積の確定は API ではできません。
「個人情報」を付けないキーでは、顧客の氏名や連絡先が空で返ります。会社名は返ります。何を伏せるかは 認証と権限 にまとめています。
発行後の注意
発行されたキーは、発行した直後の 1 回だけ全文が表示されます。 安全な場所にコピーして保管してください。あとから見ることはできません。なくした場合は、新しく発行し直してください。
キーが漏れた恐れがある場合は、すぐに一覧のそのキーのごみ箱のボタンを押し、「失効させる」を押してください。失効させたキーは、その場で使えなくなります。
組織の削除を予約すると、その間は組織のキーもすべて使えなくなります。削除を取り消して組織を復旧すれば、同じキーで再び使えます。
外部アプリの接続を許可する
ほかのアプリや AI アシスタントは、API キーを使う代わりに、利用者本人がソクミツにログインして同意する方法（OAuth）で接続できます。
- 「AI アシスタント・外部アプリ」の画面で「この組織で外部アプリからの接続を許可する」をオンにします。既定はオフです
- 接続するアプリの側で「ソクミツに接続」を始めると、ソクミツの同意画面が開きます。Claude や ChatGPT などの AI アシスタントでは、同じ画面に表示される 接続先の URL を、コネクタ（MCP サーバー）として追加します
- 利用者は、どの組織のデータを渡すか、商品マスタの変更も許すか、顧客・案件・見積の下書きの登録と編集も許すか、顧客の個人情報も渡すかを選んで許可します。どれも既定では許しません
接続したアプリは、許可した人の権限の範囲でしか操作できません。 商品マスタの変更を許せるのは組織の管理者だけです。管理者でない利用者が接続したアプリは、商品マスタを変更できません (顧客・案件・見積の下書きの登録と編集は、同意画面で選べば許可できます)。見積の確定はどの接続でもできません。
読み取り専用で繋ぐ
画面には、接続先の URL のほかに 読み取り専用の URL も表示されます。こちらで繋いだ AI アシスタントは、同意画面で何を選んでも参照しかできません。社外の人に渡すときや、まずは試してみたいときに使ってください。
接続済みのアプリを確かめる・切る
「接続済みの外部アプリ」に、アプリの名前（アプリが名乗っている名前）、許可した人と日付、最後に使われた日時、権限、個人情報の有無が並びます。行のごみ箱のボタン (接続を切る) を押し、確認で「切る」を押すと、そのアプリはすぐに使えなくなります。
「この組織で外部アプリからの接続を許可する」をオフにすると、接続済みのアプリもすべてその時点で使えなくなります。もう一度オンにしても、切れた接続は元に戻らないので、それぞれ繋ぎ直しが必要です。API キーはこのスイッチの対象外です (キーは「API キー」の画面で失効させます)。
接続を許可した人のアカウントや、組織を削除した場合も、接続済みのアプリはその時点で使えなくなります。復旧しても接続は戻らないので、繋ぎ直してください。
セキュリティ
- 通信はすべて暗号化されています
- API キーや外部アプリからの変更は、すべて操作ログに残ります。外部アプリの操作は、許可した人の名前で記録されます（操作ログ。操作ログはご契約のプランによっては使えません）
- 呼び出し回数に上限があります。通常の業務の使い方では問題ありません
詳しい技術仕様
エンドポイントや認証の手順、AI アシスタントから使えるツールは、開発者向けドキュメント にまとめています。