ioffice-mcp について
ioffice-mcpは、ClaudeをiOfficeのワークスペース管理に接続します。会議室予約、来訪者管理、メンテナンスチケットに対応し、状態を変える操作には確認の仕組みがあります。
主な機能
- 01会議室の予約
- 02来訪者の管理
- 03メンテナンスチケットの処理
- 04書き込み前の変更確認
- 05対象レコード変更のプレビュー
活用シーン
- 01ワークスペースの会議室を予約
- 02来訪者レコードを管理
- 03メンテナンスチケットを登録・追跡
- 04更新や削除の実行内容を確認
MCP 対応
MCPサーバーを通じて、ClaudeにiOfficeのワークスペース管理操作を公開します。書き込みや状態変更は、クライアントの機能に応じて確認を求めるか、プレビューと使い捨てトークンを返します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y ioffice-mcpIOFFICE_HOSTYour iOffice tenant hostname (e.g. yourcompany.ioffice.com)IOFFICE_TOKENシークレットYour iOffice API token (preferred over username/password)IOFFICE_USERNAMEYour iOffice username (used if no API token)IOFFICE_PASSWORDシークレットYour iOffice password (used if no API token)ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
53掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| view | enum | いいえ | レスポンス形式:"compact"(デフォルト)は、レスポンス内の別の場所にすでに含まれているフィールドを省略します。"full" は、このサーバーが認識するすべてのフィールドを返します。compact はレスポンスから画像/アバターの URL を除外し、"full" は iOffice のペイロードを変更せずに返します。フィールドの射影には対応していません。どの iOffice フィールドが重要かについて、このサーバーには検証済みの記録がなく、推測でリストを作成すると呼び出し元が必要とするフィールドを削除するおそれがあるためです。compact | full |
| limit | integer | いいえ | 結果の最大件数(デフォルトは 50、最大 100) |
| search | string | いいえ | 名前または説明で絞り込みます |
| orderBy | string | いいえ | 並べ替えに使うプロパティ(デフォルト:id) |
| startAt | integer | いいえ | ページネーションのオフセット(デフォルトは 0) |
| orderByType | enum | いいえ | 並べ替え順(デフォルト:asc)asc | desc |
詳細
ioffice-mcp
Claude 用の iOffice MCP サーバー — AI(Claude Code)によって開発・保守されています
確認
書き込みや状態を変更するツール(34 個)は、すべて最初にユーザーに確認を求めます。
確認プロンプトを表示できるクライアント(Claude Code)では、MCP_CONFIRM_ELICITATION=off でない限り、実際の確認プロンプトが表示されます。
表示できないクライアント(claude.ai、Claude Desktop)では、最初の呼び出しでは何も書き込まず、送信されるメソッド、パス、正確な本文のプレビューと、1 回限りの confirmToken を返します。そのトークンを付けて再度呼び出すと書き込みが実行され、途中で引数が変更されていた場合はトークンが拒否されます。
更新、削除、io_cancel_move、io_return_mail では、対象レコードを最初に読み取るため、プレビュー(およびプロンプト)には変更内容が明記されます。たとえば、ID だけでなくメールアドレスも含めた Delete iOffice user 42 (Alice Smith) が表示されます。また、プレビューの後でレコードが変更されていた場合もトークンは拒否されます。存在しない ID は読み取り時にエラーとなり、プレビューは表示されません。
| 変数 | デフォルト | |
|---|---|---|
MCP_CONFIRM_MODE | ask-user | 確認プロンプトを表示できないクライアント(claude.ai、Claude Desktop)での書き込み動作です。ask-user:2 段階で処理します。最初の呼び出しでは何も書き込まず、プレビューとトークンを返します。モデルは再度呼び出す前に、チャットでユーザーの承認を得る必要があります。auto:同じく 2 段階で処理しますが、モデルはプレビューを確認した後にトークンを使用できます。refuse:そのようなクライアントでは書き込みを拒否します。プロンプトを表示できるクライアント(Claude Code)には、MCP_CONFIRM_ELICITATION=off でない限り、常に実際のプロンプトが表示されます。認識できない値は refuse として扱われます。 |
MCP_CONFIRM_ELICITATION | on | off にすると確認プロンプトは表示されず、すべてのクライアントで MCP_CONFIRM_MODE の動作になります。プロンプトを表示できるとされているのに、実際には表示しないクライアント(書き込みが停止する opencode 2.0.x)では、この値を設定してください。それ以外の値は on として扱われ、stderr に警告が表示されます。 |
MCP_CONFIRM_TTL_SECONDS | 600 | トークンの有効期間です。 |
MCP_CONFIRM_SECRET | プロセスごとにランダム | 署名キーです。サーバーの再起動後もトークンを有効にする必要がある場合に限り設定してください。 |
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。