Bill4Time MCP by usefulapi について
Bill4Time MCP by usefulapiは、MCPクライアントからBill4Timeの記録を参照するホスト型MCPサーバーです。請求や勤怠のデータを型付き条件で絞り込み、並べ替えでき、機密フィールドは返しません。
主な機能
- 01顧客とプロジェクトの参照
- 02時間記録と経費の参照
- 03請求書と支払いの参照
- 04ユーザーと連絡先の参照
- 05結果の絞り込みと並べ替え
- 06機密フィールドの除外
活用シーン
- 01顧客とプロジェクトの記録確認
- 02記録された時間と経費の確認
- 03請求書と支払い記録の確認
- 04機密フィールドを除いて記録を取得
MCP 対応
型付き条件による絞り込みと並べ替えに対応し、Bill4Timeの記録を読み取り専用でMCPクライアントに提供します。利用にはBill4Time v1 API keyが必要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://bill4time.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-bill4time https://bill4time.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-bill4time":{"serverUrl":"https://bill4time.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
8| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| id | integer | いいえ | この ID のレコードのみ。 |
| top | integer | いいえ | 返すレコード数。1~100(デフォルト:25)。 |
| skip | integer | いいえ | スキップするレコード数(デフォルト:0)。次のページを読み込むには、前回の応答の next_skip を渡します。 |
| sort | enum | いいえ | 並べ替えに使用するフィールド(デフォルト:Bill4Time 独自の順序)。id | clientName | creationDate |
| status | enum | いいえ | Active | Disabled |
| descending | boolean | いいえ | 降順で並べ替えます(新しいもの、または値の大きいものを先に表示)。デフォルトは昇順。 |
| client_name | string | いいえ | クライアント名の完全一致(大文字と小文字の規則は Bill4Time に準拠します)。 |
| created_after | string | いいえ | この日付以降に作成されたクライアント。 |
| created_before | string | いいえ | この日付以前に作成されたクライアント。 |
| include_custom_fields | boolean | いいえ | カスタムフィールドも返します(デフォルトは false)。 |
詳細
usefulapi による Bill4Time MCP
Bill4Time を Claude、Cursor、または任意の MCP クライアントから利用できます。型付きフィルターと並べ替えを使って、クライアント、プロジェクト、時間記録、経費、請求書、支払い、ユーザー、連絡先を読み取れます。読み取り専用です。住所、納税者番号、時間単価などの機密フィールドは返されません。Bill4Time v1 API キーが必要です。 ホスト型のため、ローカルへのインストールは不要です。ご自身の Bill4Time 認証情報で接続してください。
ライブエンドポイント: https://bill4time.usefulapi.io/mcp · ホームページ: https://usefulapi.io/bill4time
接続
- Claude(claude.ai、デスクトップ):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://bill4time.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http bill4time https://bill4time.usefulapi.io/mcpを実行し、その後/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"bill4time": {
"url": "https://bill4time.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで Bill4Time の認証情報を尋ねます。
手順に沿った設定方法、認証情報の確認場所、よくある質問:https://usefulapi.io/bill4time/
ツール
| ツール | 種類 | 説明 |
|---|---|---|
bill4time_list_clients | read | クライアントを一覧表示 |
bill4time_list_projects | read | プロジェクト(案件)を一覧表示 |
bill4time_list_time_entries | read | 時間記録を一覧表示 |
bill4time_list_expenses | read | 経費を一覧表示 |
bill4time_list_invoices | read | 請求書を一覧表示 |
bill4time_list_payments | read | 支払いを一覧表示 |
bill4time_list_users | read | ユーザー(タイムキーパー)を一覧表示 |
bill4time_list_contacts | read | 連絡先を一覧表示 |
bill4time_usage_status | meta | 使用状況(無料プランの利用量) |
bill4time_request_feature | meta | 不足している機能をリクエスト |
bill4time_upgrade | meta | Pro にアップグレード(無制限*) |
bill4time_cancel_subscription | meta | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認が必要です。meta ツールは使用状況の報告、サブスクリプションの管理、または機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| 無料 | $0 | 月50回のツール呼び出し |
| Pro(API キーごと) | $9/mo または $90/yr(2か月分無料) | 無制限* |
*Pro には、このサーバーで月10,000回のツール呼び出しという公正使用上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro の対象はこのサーバーのみです。bill4time_upgrade で登録してください(Stripe Checkout のリンクが返されます)。bill4time_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現行期間の返金はありません。期間終了前に bill4time_upgrade を実行すると、キャンセルは取り消されます。[email protected] へのご連絡でも対応できます。
ライセンス
MIT © usefulapi。Bill4Time とは提携関係になく、Bill4Time の推奨も受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。