Kickserv MCP by usefulapi について
Kickserv MCP by usefulapiは、Kickservを利用するチーム向けのホスト型MCPサーバーです。MCPクライアントから顧客やジョブの照会・更新ができ、OAuthでサインインします。
主な機能
- 01顧客とジョブの検索
- 02メモと作業時間の参照
- 03顧客情報の作成と更新
- 04ジョブとタスクの作成・更新
- 05メモ追加、時間記録、料金追加
活用シーン
- 01顧客のジョブとメモの確認
- 02ジョブに記録された時間の確認
- 03ジョブの作成とタスク追加
- 04作業時間やジョブ料金の記録
MCP 対応
顧客、ジョブ、メモ、タスク、作業時間、料金を扱うツールをMCPクライアントに公開します。リモートエンドポイントで稼働し、OAuthでユーザーを認証します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://kickserv.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-kickserv https://kickserv.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-kickserv":{"type":"http","url":"https://kickserv.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-kickserv":{"type":"http","url":"https://kickserv.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-kickserv":{"type":"http","url":"https://kickserv.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-kickserv":{"serverUrl":"https://kickserv.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
20| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| name | string | いいえ | 完全一致する顧客名。 |
| only | string | いいえ | 返す列名をカンマ区切りで指定します(例:`customer_number,name`)。Kickserv はこの指定を推奨しており、応答が大幅に小さくなり高速化します。 |
| page | integer | いいえ | ページ番号(Kickserv は 1 ページあたり 30 件を返します)。1 ページ目では省略できます。 |
| include | array | いいえ | 埋め込む関連データ:contacts、jobs、tasks、notes、tax_entity、custom_field_assignments。 |
| billing_city | string | いいえ | 請求先の市区町村。 |
| phone_number | string | いいえ | 完全一致する電話番号(例:800-555-1212)。 |
| service_city | string | いいえ | サービス提供都市。 |
| billing_state | string | いいえ | 請求先の州/都道府県。 |
| email_address | string | いいえ | 完全一致するメールアドレス。 |
| service_state | string | いいえ | サービス先の州/都道府県(2 文字の略称)。 |
| customer_number | integer | いいえ | 顧客番号。 |
| service_zip_code | string | いいえ | サービス先の ZIP コード(レコードに ZIP+4 がある場合は完全な値)。 |
詳細
usefulapi による Kickserv MCP
Kickserv を Claude、Cursor、または任意の MCP クライアントから利用できます。顧客、ジョブ、メモ、時間記録を検索し、顧客、ジョブ、タスク、メモ、時間、請求項目を作成または更新できます。 ホスト型のため、ローカルへのインストールは不要です。ご自身の Kickserv 認証情報で接続できます。
ライブエンドポイント: https://kickserv.usefulapi.io/mcp · ホームページ: https://usefulapi.io/kickserv
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://kickserv.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http kickserv https://kickserv.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"kickserv": {
"url": "https://kickserv.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを処理し、ログインページで Kickserv の認証情報を求めます。
手順ごとの設定方法、認証情報の確認場所、よくある質問:https://usefulapi.io/kickserv/
初回接続時に、Kickserv アカウントのスラッグ(app.kickserv.com/ から取得)と従業員 API トークン(My Account > API token)を入力します。 これらは検証され、ユーザーごとに保存され、本人にのみ適用されます。設定ファイルにキーを保存する必要はありません。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
kickserv_list_customers | read | 顧客の一覧を取得 |
kickserv_get_customer | read | 顧客を取得 |
kickserv_list_customer_jobs | read | 顧客のジョブ一覧を取得 |
kickserv_list_jobs | read | ジョブの一覧を取得 |
kickserv_get_job | read | ジョブを取得 |
kickserv_list_customer_notes | read | 顧客のメモ一覧を取得 |
kickserv_list_job_notes | read | ジョブのメモ一覧を取得 |
kickserv_list_job_time_entries | read | ジョブの時間記録一覧を取得 |
kickserv_get_task | read | タスクを取得 |
kickserv_list_employees | read | 従業員の一覧を取得 |
kickserv_list_items | read | 項目の一覧を取得 |
kickserv_create_customer | write | 顧客を作成 |
kickserv_update_customer | write | 顧客を更新 |
kickserv_add_customer_note | write | 顧客にメモを追加 |
kickserv_create_job | write | ジョブを作成 |
kickserv_update_job | write | ジョブを更新 |
kickserv_add_job_note | write | ジョブにメモを追加 |
kickserv_create_task | write | タスクを作成 |
kickserv_log_time_entry | write | ジョブの作業時間を記録 |
kickserv_add_job_charge | write | ジョブに請求項目を追加 |
kickserv_usage_status | meta | 利用状況(無料プランの使用量) |
kickserv_request_feature | meta | 不足している機能をリクエスト |
kickserv_upgrade | meta | Pro にアップグレード(無制限*) |
kickserv_cancel_subscription | meta | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアントは実行前に確認を求めてください。meta ツールは利用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月 50 回のツール呼び出し |
| Pro(ユーザーごと) | 月 $9 または 年 $90(2 か月分無料) | 無制限* |
*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正利用の上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro の対象はこのサーバーのみです。kickserv_upgrade を使用して登録してください(Stripe Checkout のリンクが返されます)。kickserv_cancel_subscription でいつでもキャンセルできます。Pro は有料期間の終了まで利用でき、現在の期間分の返金はありません。終了前に kickserv_upgrade を実行すると、キャンセルが取り消されます。[email protected] へのご連絡も可能です。
ライセンス
MIT © usefulapi。Kickserv との提携関係はなく、同社からの承認も受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。