Claude Garoon連携の設定手順 — 公式MCPサーバーの使い方
サイボウズ公式のGaroon MCPサーバーをClaude Code / Claude Desktopに接続する手順を、インストール方法別にまとめます。
Claude Garoon連携とは何か
Claude Garoon連携は、サイボウズが公式に配布する「Garoon MCP Server」を使って実現します。Garoonのスケジュールや施設、組織情報をClaudeから直接操作できるようになる仕組みです。生成AIに対応したMCPクライアント経由でGaroonのREST APIを呼び出すため、Claude側で個別の連携コードを書く必要はありません。
対応するのはClaude DesktopとClaude Codeの2つの利用形態です。Claude Desktopでは.mcpbファイルをダブルクリックするだけの簡易インストールが使え、Claude Codeではclaude mcp addコマンドでDockerイメージかnpmパッケージを登録します。どちらもサイボウズがOSSとして公開しているコード(garoon/garoon-mcp-server)が土台です。
この記事では、3つのインストール方法それぞれの手順と、接続後に使える操作の一覧を扱います。前提として、Garoonのログインアカウント(ユーザー名とパスワード)が必要です。管理者権限は不要ですが、操作できる範囲はそのアカウントがGaroon上で持つ権限に従います。
インストール方法をどう選ぶか
インストール方法は3つあり、使っているツールと環境によって選択肢が変わります。表で比較します。
| 方法 | 対応クライアント | 必要なもの | 向いているケース |
|---|---|---|---|
| MCPB(旧DXT) | 対応クライアントClaude Desktopのみ | 必要なものなし(実行ファイル同梱) | 向いているケースGUIで完結させたい、Node.jsやDockerを入れたくない |
| Dockerイメージ | 対応クライアントClaude Code / Cursor / VS Code等 | 必要なものDocker | 向いているケース環境をコンテナで隔離したい、チーム配布したい |
| npmパッケージ | 対応クライアントClaude Code / Cursor / VS Code等 | 必要なものNode.js | 向いているケースすでにNode.js環境がある、設定を軽くしたい |
MCPBはClaude Desktop専用のインストール形式です。Claude Codeでは使えないため、CLIから接続する場合はDockerかnpmパッケージの2択になります。両方とも内部的には同じMCPサーバーが動くため、機能差はありません。
Claude Desktopに接続する(MCPB方式)
MCPB方式は、Claude Desktopの設定画面から.mcpbファイルを開くだけで完結します。ターミナル操作は不要です。
手順は次の通りです。
- Garoon MCP Serverのリリース一覧を開く
- Assetsから
garoon-mcp-server.mcpbをダウンロードする - ダウンロードしたファイルをClaude Desktopで開く
- インストール確認ダイアログで「インストール」を選ぶ
- 設定ダイアログでGaroonのベースURL・ユーザー名・パスワードを入力して保存する
- トグルスイッチが無効になっていれば有効にする
入力する設定項目はGaroon MCP Server共通で、Docker・npm方式でも同じ値を使います。詳細は後述の「設定項目の一覧」を参照してください。.mcpbという拡張子はDesktop Extensionsの仕組みで、Claude Desktopにワンクリックでツールを追加する目的で作られています。
Claude Codeに接続する(Docker / npm方式)
Claude CodeではCLIコマンド1行でGaroon MCP Serverを登録できます。claude mcp addまたはclaude mcp add-jsonのいずれかを使います。
npmパッケージ方式がもっとも設定が軽量です。Node.jsがインストール済みなら、以下のコマンドで接続できます。
bash claude mcp add garoon \ --env GAROON_BASE_URL=https://example.cybozu.com/g \ --env GAROON_USERNAME=your-username \ --env GAROON_PASSWORD=your-password \ -- npx @garoon/mcp-server
Dockerイメージ方式を使う場合は、事前にdocker pull ghcr.io/garoon/mcp-server:latestでイメージを取得してから、次のように登録します。
bash claude mcp add garoon \ --env GAROON_BASE_URL=https://example.cybozu.com/g \ --env GAROON_USERNAME=your-username \ --env GAROON_PASSWORD=your-password \ -- docker run --rm -i \ -e GAROON_BASE_URL -e GAROON_USERNAME -e GAROON_PASSWORD \ ghcr.io/garoon/mcp-server:latest
どちらのコマンドも既定では「ローカルスコープ」で登録され、実行したプロジェクトだけで有効になり自分専用です。チームで設定を共有したい場合は--scope projectを付けると、プロジェクト直下の.mcp.jsonに書き込まれてバージョン管理に含められます。ただしGaroonのログイン情報が平文で入るため、.mcp.jsonをリポジトリにコミットする運用は避け、環境変数側で個人ごとに渡す構成を検討してください。
登録できたかどうかはclaude mcp listで確認できます。ステータスが✔ Connectedになっていれば接続完了です。claude mcp get garoonで詳細情報も見られます。
claude mcp addのオプションやスコープの使い分けをもう少し詳しく知りたい場合は、claude mcp addの構文からスコープ・認証までをまとめた記事が参考になります。
設定項目の一覧
Garoon MCP Serverの設定項目は、必須3つと任意6つの合計9つです。MCPB版では設定名がGUIのラベル、Docker/npm版では環境変数名になります。
| 環境変数 | 説明 | 必須 |
|---|---|---|
GAROON_BASE_URL | 説明GaroonのベースURL(例: https://example.cybozu.com/g) | 必須✓ |
GAROON_USERNAME | 説明Garoonのログイン名 | 必須✓ |
GAROON_PASSWORD | 説明Garoonのログインパスワード | 必須✓ |
https_proxy | 説明HTTPSプロキシのURL | 必須- |
GAROON_PFX_FILE_PATH | 説明クライアント証明書(*.pfx)の絶対パス | 必須- |
GAROON_PFX_FILE_PASSWORD | 説明クライアント証明書のパスワード | 必須- |
GAROON_BASIC_AUTH_USERNAME | 説明Basic認証のユーザー名 | 必須- |
GAROON_BASIC_AUTH_PASSWORD | 説明Basic認証のパスワード | 必須- |
GAROON_PUBLIC_ONLY | 説明非公開予定を除外するモード(既定false) | 必須- |
クライアント証明書認証を使う場合、GaroonのドメインはURLの末尾が.s.cybozu.comになる点に注意してください。GAROON_PUBLIC_ONLYをtrueにすると、予定取得系のツールが非公開予定をレスポンスから除外します。共有端末や複数人が見る場所でClaudeを使う場合に有効な設定です。
接続後にできる操作
接続が完了すると、Claudeは10種類のツールを通じてGaroonを操作できるようになります。
| ツール | できること |
|---|---|
| Create Schedule Event | できることスケジュールを作成する |
| Get Schedule Events | できることユーザー・組織・施設を指定して予定を取得する |
| Search Available Times | できること条件を指定して空き時間を検索する |
| Get Facilities | できること施設名から施設IDを検索する |
| Garoon Get Facility Groups | できること施設グループの一覧を取得する |
| Get Facilities In Group | できること施設グループに所属する施設を取得する |
| Get Current Datetime | できること現在の日時を取得する |
| Get Garoon Users | できること名前からユーザーIDや表示名を検索する(「私」「自分」にも対応) |
| Get Organizations | できること組織名から組織IDを検索する |
| Get Users In Organization | できること組織IDに所属するユーザーを取得する |
見て分かる通り、対応しているのはスケジュール・施設・組織・ユーザーの管理機能に絞られています。メッセージやワークフローの操作はまだ含まれません。「明日の午後空いている会議室を教えて」「田中さんと佐藤さんの来週の予定を並べて」のような依頼から使い始めるのが分かりやすいでしょう。スケジュール操作を軸にした具体的な使い方は、GaroonのスケジュールをClaudeで一括確認・調整する方法で扱っています。
接続確認を兼ねて最初に試すなら、「Get Current Datetime」を呼ぶだけで完結する依頼が手軽です。たとえば「今の日時を教えて」と聞くと、Claudeは追加の権限確認なしにGaroonから現在時刻を取得して返します。ここで正しい応答が返れば、認証情報とネットワーク経路の両方が通っている証拠になります。次に「私の今日の予定を教えて」のようにユーザーを指定する依頼を試すと、Get Garoon UsersでユーザーIDを解決してからGet Schedule Eventsで予定を引く、という2段階のツール呼び出しをClaudeが自動で組み立てる様子が確認できます。
よくあるつまずき
すべてのリクエスト・レスポンスパラメーターに対応しているわけではないという点が最初のつまずきどころです。GaroonのフルGUIでできる細かい設定(繰り返し予定の高度なパターンなど)は、MCP経由では反映できない場合があります。Google Calendarを使っている組織では事情が異なり、標準搭載のコネクタが読み書き両対応で予定の作成・変更・削除・RSVPまでカバーします。詳しくはClaude Googleカレンダー連携 — 予定調整から招待までで扱っています。
パッケージ版Garoonではツールが動かないことがあります。Garoon MCP Serverは内部でGaroonのREST APIを呼び出しますが、利用しているGaroonのバージョンによってはそのREST APIが存在しない場合があるためです。REST APIの対応バージョンはGaroon APIドキュメントで確認できます。
DB分割構成の環境では使えません。大規模組織向けにデータベースを分割しているGaroon環境は、Garoon MCP Serverの対応範囲外です。
接続情報を含む設定ファイルの保管には注意が必要です。Garoonのログインパスワードが平文で設定ファイルに残るため、共有PCやバージョン管理下のファイルに書き込む前に、扱いを社内のセキュリティ方針と照らし合わせてください。接続自体がうまくいかないときは、MCPサーバーに接続できないときの切り分け手順が原因の絞り込みに使えます。
よくある質問
Garoon MCP Serverはどこが提供していますか
サイボウズがApache License 2.0のOSSとして公開しています。Garoon本体のAPIサポート窓口の対象外で、バグ報告や機能要望はGitHubのIssuesで受け付けています。
追加費用はかかりますか
Garoon MCP Server自体は無料で公開されています。利用するにはGaroonの契約とログインアカウントが前提です。Claude Code / Claude Desktopの利用条件は別途、Claudeのプランに従います。
CursorやVS Codeでも使えますか
使えます。Garoon MCP ServerはMCPの標準仕様に沿ったサーバーなので、Docker・npm方式であればMCPに対応したクライアントから接続できます。READMEにはCursorとVS Code向けの設定例が用意されています。
今後、メッセージやワークフローの操作にも対応しますか
サイボウズは今後の機能拡充を予告していますが、具体的な対応時期は公表されていません。最新の対応状況はGitHubのツール一覧で確認するのが確実です。
まとめ
Claude Garoon連携は、サイボウズ公式のGaroon MCP Serverを使えばコード不要で実現できます。Claude Desktopなら.mcpbファイルを開くだけ、Claude CodeならCLIコマンド1行で接続でき、スケジュール・施設・組織・ユーザーの10ツールが利用可能です。まずはGaroonのログイン情報を用意し、自分の利用形態に合ったインストール方法から試すのが近道です。