Groove MCP by usefulapi について
Groove MCP by usefulapi は、Groove を使うサポートチーム向けのホスト型 MCP サーバーです。ローカルにインストールせず、MCP クライアントから共有受信トレイのデータを確認し、会話を管理できます。
主な機能
- 01会話と連絡先の読み取り
- 02担当者、チャネル、タグ、フォルダー、チームの参照
- 03会話の終了、再開、スヌーズ、スター設定
- 04会話の割り当てとタグの追加・削除
活用シーン
- 01共有受信トレイの会話確認
- 02会話の状態と担当者の更新
- 03連絡先やチーム構成の検索
MCP 対応
Groove の会話やアカウント情報を読み取るツールと、会話の状態、割り当て、タグを変更するツールを MCP クライアントに提供します。クライアントはホスト型エンドポイントに接続し、Groove の認証情報で認証します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://groove-hq.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-groove-hq https://groove-hq.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-groove-hq":{"type":"http","url":"https://groove-hq.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-groove-hq":{"type":"http","url":"https://groove-hq.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-groove-hq":{"type":"http","url":"https://groove-hq.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-groove-hq":{"serverUrl":"https://groove-hq.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
16| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| after | string | いいえ | Relay ページネーションカーソル — 前のページの `endCursor` を渡すと次のページを取得できます。 |
| first | integer | いいえ | 返すレコード数(Relay ページネーションの `first`)。 |
| state | enum | いいえ | 会話の状態で絞り込みます。unread | opened | closed | snoozed | spam |
| starred | boolean | いいえ | 設定すると、スター付き(true)またはスターなし(false)の会話に絞り込みます。 |
| assigned | boolean | いいえ | 設定すると、割り当て済み(true)または未割り当て(false)の会話に絞り込みます。 |
| keywords | string | いいえ | 会話全体を対象にキーワードを全文検索します。 |
| tag_name | string | いいえ | このタグ名が付いた会話に絞り込みます。 |
| folder_id | string | いいえ | 単一のフォルダー ID で絞り込みます。 |
| channel_id | string | いいえ | 単一のチャネル(メールボックス)ID で絞り込みます。 |
詳細
usefulapi の Groove MCP
Claude、Cursor、または任意の MCP クライアントから Groove のサポート会話を管理できます。共有受信トレイの会話、連絡先、エージェント、チャネル、タグ、フォルダー、チームを読み取り、会話をクローズ、オープン、スヌーズ、スター付け、割り当て、タグ付けできます。ホスト型のため、ローカルへのインストールは不要です。Groove API トークンで接続します。
ライブエンドポイント: https://groove-hq.usefulapi.io/mcp · ホームページ: https://usefulapi.io
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://groove-hq.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"groove-hq": {
"url": "https://groove-hq.usefulapi.io/mcp"
}
}
}
URL だけを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで Groove の認証情報を尋ねます。
手順ごとのセットアップ、認証情報の確認方法、よくある質問:https://usefulapi.io/groove-hq/
初回接続時に、Groove API トークン(Groove → Settings → API)を貼り付けます。 トークンは検証され、ユーザーごとに保存され、本人だけに適用されます。設定ファイルにキーを保存する必要はありません。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
groove_list_conversations | read | 会話を一覧表示 |
groove_get_conversation | read | 会話を取得 |
groove_list_contacts | read | 連絡先を一覧表示 |
groove_get_contact | read | 連絡先を取得 |
groove_list_agents | read | エージェントを一覧表示 |
groove_list_channels | read | チャネルを一覧表示 |
groove_list_tags | read | タグを一覧表示 |
groove_list_folders | read | フォルダーを一覧表示 |
groove_list_teams | read | チームを一覧表示 |
groove_close_conversation | write | 会話をクローズ |
groove_open_conversation | write | 会話をオープン |
groove_snooze_conversation | write | 会話をスヌーズ |
groove_star_conversation | write | 会話にスターを付ける |
groove_assign_conversation | write | 会話を割り当て |
groove_tag_conversation | write | 会話にタグを付ける |
groove_untag_conversation | write | 会話からタグを外す |
groove_usage_status | meta | 利用状況(無料プランの使用量) |
groove_request_feature | meta | 不足している機能をリクエスト |
groove_upgrade | meta | Pro にアップグレード(無制限*) |
groove_cancel_subscription | meta | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認を求める必要があります。meta ツールは利用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 価格 | 上限 |
|---|---|---|
| Free | $0 | 月50回のツール呼び出し |
| Pro(ユーザーごと) | $9/mo または $90/yr(2か月分無料) | 無制限* |
*このサーバーでの Pro の公正利用上限は月10,000回のツール呼び出しです。それ以上必要な場合は、[email protected] までご連絡ください。
Pro の対象はこのサーバーのみです。groove_upgrade を実行して登録してください(Stripe Checkout のリンクが返されます)。groove_cancel_subscription を実行すればいつでもキャンセルできます。Pro は支払い済み期間の終了まで継続し、現在の期間分の返金はありません。その前に groove_upgrade を実行すると、キャンセルは取り消されます。または、[email protected] までご連絡ください。
ライセンス
MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホストされています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。