よくある質問

APIキーについて

APIキーはどこで発行しますか？

「ユーザー設定 > API キー」画面で発行できます。発行した API キーは、そのキーを発行したユーザー自身の権限の範囲でのみ動作します。

APIキーをなくしました。再表示できますか？

いいえ。平文のキー（ktk_...）はセキュリティ上、発行時に一度だけ表示され、サーバには SHA256 ハッシュのみが保存されます。あとから再表示はできません。紛失した場合は、そのキーを失効（revoke）し、新しいキーを発行してください。

権限・検索について

自分の権限のないフォルダの契約書も取得できますか？

いいえ。API は画面と同じ権限ロジックを使うため、発行者が閲覧・編集できるフォルダの契約書だけが対象です。権限のないフォルダ・他組織の契約書は、検索・取得のいずれでも返りません。

検索したのに目的の契約書が出てきません。

一覧 API は1ページずつ返すため、件数が多いと先頭ページしか見えないことがあります。query（文書名・取引先名）、status、folder_uuid、agreed_from / agreed_to（締結日）などの絞り込みパラメータを指定して件数を絞ってください。フォルダで絞りたい場合は、先に list_folders / find_folder（または /folders API）で folder_uuid を取得します。

契約書の編集ができません。

編集（PATCH /contracts/:uuid / update_contract）には、対象フォルダの編集権限と、read_write スコープの API キーが必要です。read スコープのキーでは参照のみ可能です。権限とスコープを確認してください。

MCP連携について

Microsoft 365 Copilot / Copilot Studio から使えますか？

現時点では未対応です。クラウド系の Copilot は、ローカル stdio ではなくリモート HTTPS + OAuth での接続が必要で、リモートモードは準備中（WIP）です。Claude Code および VS Code の GitHub Copilot（ローカル stdio）からは利用できます。詳しくは MCP連携 を参照してください。

PDFの契約書をアップロードできますか？

MCP 経由でのファイルアップロードは未対応です。契約書アップロード（PDF）は REST API（POST /api/v1/contracts）で提供されます。