よくある質問
1. 接続テストは成功したのに、 メンションすると応答しない
最も多い原因は、 MCP サーバーに receive_google_chat_event ツールが 実装されていないことです。 接続テスト (initialize /tools/list) は URL に到達できれば成功しますが、 実際の応答は このツールが返すテキストを使うため、 ツールが無いと無反応になります。
/statusで表示されるツール一覧にreceive_google_chat_eventが含まれているか確認してください。- ツール名のスペルが完全一致しているか (例:
receive_chat_event等の 別名では動きません) を確認してください。 - 実装例は 接続設定の手順 の ステップ 3 にあります。
2. メンションしても bot が応答しない (その他の確認)
確認順:
- bot がスペースに追加されているか? スペースのメンバーリストで「Agent Hub」 が表示されているか確認してください。
- 正しくメンションしているか?
@Agent Hubと入力し、 オートコンプリート候補から選んでメンションする必要があります。 - MCP サーバーが設定されているか?
/statusで確認してください。 未設定なら/connectでセットアップ。 - MCP サーバーが動作しているか? サーバー側のログを確認し、 リクエストが届いているかチェック。
- 認可されているか? Workspace admin が install ユーザー側で利用者を 認可している必要があります。
3. 接続テストで「unauthorized」 が出る
認証 token が間違っている、 もしくは MCP サーバー側が期待する形式 (Bearer auth) に 合っていません。 サーバーのドキュメントを確認し、 token を再発行してください。
4. 接続テストで「timeout」 や「fetch failed」 が出る
- URL が
https://またはhttp://で始まっているか確認 - サーバーが起動しており、 公開されているか確認
- Cloudflare Tunnel / ngrok を使っている場合、 トンネルが生きているか確認
- サーバー側のレスポンスタイムが長すぎないか (Agent Hub のタイムアウトは約 25 秒)
5. Dialog (モーダル) が開かない
Workspace の管理者が Chat App の「Interactive features」 を無効化している可能性があります。 Workspace 管理者に確認してください。
6. Slash コマンドが効かない
bot がそのスペースに追加されている必要があります。 DM の場合は問題ありません。
7. 「未認可ユーザー」 と表示される
Marketplace 公開後の濫用防止のため、 認可されたメールアドレスのみが応答対象です。 Workspace 内の管理者に依頼して、 認可ユーザーリストに追加してもらってください。
解決しない場合
サポート連絡先: お問い合わせ