MCP 経由で Connecteam を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Connecteam をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Connecteam + Gemini

デスクを持たない現場チーム向けアプリ Connecteam：ユーザーとカスタムフィールド、打刻済みシフト、タイムシート集計、出退勤打刻を備えたタイムクロック、スケジューラーのシフト、ジョブ、フォームと提出内容、クイックタスク、休暇の残高と申請、チャットメッセージ。API キーで Connecteam API に接続します。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

CONNECTEAM_API_HOST, CONNECTEAM_API_KEY

ステップ 1 — 認証情報を取得

設定は約 2 分で、Connecteam のオーナーまたは管理者が必要です。

1. Connecteam で Settings > API Keys を開き、Add API key をクリックします。キーを CONNECTEAM_API_KEY にコピーします。アカウント全体にアクセスできるので、パスワードと同じように扱ってください。
2. CONNECTEAM_API_HOST を https://api.connecteam.com に設定します。app-au.connecteam.com でサインインしている場合（オーストラリアのアカウント）は https://api-au.connecteam.com にします。
3. コネクタをインストールすると、connecteam_get_account でインストールが確認されます。

API を使うには、ハブごとに Expert プラン以上が必要です。タイムクロック、スケジューラー、ジョブ、タスクは Operations、チャットは Communications、休暇は HR & Skills です。ユーザー、アカウント、パブリッシャーは対象となるどのハブでも使えます。

個人データ: ユーザーには氏名、電話番号、メールアドレス、誕生日、住所、ID 番号などのカスタムプロフィール項目が含まれ、勤務記録には GPS 位置情報が含まれることがあります。タスクに必要なものだけを求めてください。

まず ID を取得: タイムクロック、スケジューラー、タスクボードはそれぞれ独立したアプリインスタンスです。AI は timeClockId、schedulerId、taskBoardId が必要なツールを呼ぶ前に、connecteam_list_time_clocks、connecteam_list_schedulers、connecteam_list_task_boards で ID を取得します。

読み取る内容:

• アカウントと人: connecteam_get_account、connecteam_list_users（ID、氏名、メール、電話番号、ステータス、変更日時で絞り込み）、connecteam_list_custom_fields、connecteam_list_custom_field_categories、connecteam_list_smart_groups。
• タイムクロック: connecteam_list_time_activities はユーザーごとの打刻済みシフト、手動の休憩、休暇を返します（1 回の呼び出しで最大 92 日）。connecteam_get_timesheet_totals はユーザーと日ごとの時間を、休憩、残業、給与、承認・提出・ロックの状態とともに返します。
• シフト管理: connecteam_list_shifts（期間は Unix 秒）、connecteam_get_shift、connecteam_list_shift_custom_fields、connecteam_list_user_unavailabilities。
• ジョブ（シフトや打刻時間をひも付ける顧客、現場、プロジェクト）: connecteam_list_jobs、connecteam_get_job、connecteam_list_job_custom_fields。
• フォーム: connecteam_list_forms、connecteam_get_form（設問）、connecteam_list_form_submissions、そして画像やファイルリンクを含む全回答付きの connecteam_get_form_submission。
• タスク: connecteam_list_tasks と connecteam_list_task_labels。
• 休暇: connecteam_list_time_off_policy_types、connecteam_list_time_off_balances、connecteam_list_time_off_requests。最後のツールは statuses を渡さない限り承認済みの申請だけを返します。
• チャット: connecteam_list_conversations と connecteam_list_publishers。

書き込む内容:

• タイムクロック: connecteam_clock_in と connecteam_clock_out は、現在または指定時刻でユーザーの出勤・退勤を打刻します。ジョブや予定シフトを指定することもできます。connecteam_create_time_activities は過去のシフトや手動の休憩を追加し（打刻忘れなど）、connecteam_update_time_activities はそれを修正します。ロック済みや承認済みの日は拒否されます。
• シフト管理: connecteam_create_shifts と connecteam_update_shifts。isPublished と notifyUsers を true にすると、スタッフにシフトが表示され通知が届きます。
• ジョブ: connecteam_create_jobs（parentId でサブジョブも）と connecteam_update_job（title は必須）。
• タスク: connecteam_create_task と connecteam_update_task。API はタスク全体を置き換えるため、AI は毎回 userIds、status、title を送ります。ステータス completed で完了になります。
• 休暇: connecteam_create_time_off_request（承認待ち、または承認済みとして作成）と connecteam_update_time_off_request（status で承認または却下）。
• ユーザー: connecteam_create_users（それぞれ firstName、lastName、phoneNumber、userType が必要。sendActivation でアクティベーション SMS を送信）、connecteam_update_users、connecteam_archive_users（isArchived を false にして更新すれば元に戻せます）、connecteam_create_user_note。
• チャット: connecteam_send_message は会話に投稿し、connecteam_send_private_message は 1 人のユーザーに送ります。どちらも connecteam_list_publishers のパブリッシャー ID を senderId に使います。メッセージはすぐに配信されます。

インストール時はオフ: connecteam_delete_user、connecteam_delete_shift、connecteam_delete_task。元に戻せないため、チームが必要とするときにワークスペース管理者がオンにします。ユーザーのアーカイブは元に戻せる代替手段です。

データ形式: 応答は { "requestId": "...", "data": {...}, "paging": { "offset": n } } の形です。シフト、打刻、タスクの時刻は秒単位の Unix タイムスタンプで、IANA の timezone が別に付きます。フィルターの日付は YYYY-MM-DD です。ユーザー ID は整数、シフト、ジョブ、タスク、申請の ID は文字列です。一括書き込み（connecteam_create_users、connecteam_create_shifts、connecteam_create_jobs と各更新）はリストを受け取り、項目ごとに応答します。

ページング: limit（既定 10、上限はツールごとに異なり最大 500）と offset。AI はページの件数が limit を下回るまで offset を limit ずつ増やします。

制限とよくあるエラー: レート制限はアカウントとプランごと（Expert は 1 分あたり 100 リクエスト、1 日 10,000 リクエスト）で、超えると 429 になります。401 または 403 はキーの誤り、API アドレスの誤り（グローバルかオーストラリアか）、または API を使えないプランやハブ、404 は不明な ID、422 は検証エラー（本文に項目名が示されます）を意味します。

このコネクタは給与計算を行わず、フォームの編集やフォーム回答の提出もせず、タイムクロック、スケジューラー、タスクボードの作成もしません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Connecteam のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「先週、倉庫のタイムクロックで各従業員は残業を含めて何時間働きましたか？」
• 「フィールドチームのスケジューラーで、明日の空きシフトを見せてください。」
• 「まだ承認待ちの休暇申請はどれで、各人の残りの休暇はどれくらいですか？」
• 「今週提出された車両点検フォームを、回答付きで一覧にしてください。」
• 「店舗ボードに、金曜までに冷蔵室を補充するタスクを Daniel 宛てに作成して公開してください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続