mcpField
K
Kickserv MCP by usefulapi

Kickserv MCP by usefulapi

リモート
usefulapi.ioビジネス・マーケティング0今日更新
リポジトリ公式サイト

Kickserv MCP by usefulapi について

Kickserv MCP by usefulapiは、Kickservを利用するチーム向けのホスト型MCPサーバーです。MCPクライアントから顧客やジョブの照会・更新ができ、OAuthでサインインします。

主な機能

  1. 01顧客とジョブの検索
  2. 02メモと作業時間の参照
  3. 03顧客情報の作成と更新
  4. 04ジョブとタスクの作成・更新
  5. 05メモ追加、時間記録、料金追加

活用シーン

  1. 01顧客のジョブとメモの確認
  2. 02ジョブに記録された時間の確認
  3. 03ジョブの作成とタスク追加
  4. 04作業時間やジョブ料金の記録

MCP 対応

顧客、ジョブ、メモ、タスク、作業時間、料金を扱うツールをMCPクライアントに公開します。リモートエンドポイントで稼働し、OAuthでユーザーを認証します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://kickserv.usefulapi.io/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

20
パラメーター型必須説明
namestringいいえ完全一致する顧客名。
onlystringいいえ返す列名をカンマ区切りで指定します(例:`customer_number,name`)。Kickserv はこの指定を推奨しており、応答が大幅に小さくなり高速化します。
pageintegerいいえページ番号(Kickserv は 1 ページあたり 30 件を返します)。1 ページ目では省略できます。
includearrayいいえ埋め込む関連データ:contacts、jobs、tasks、notes、tax_entity、custom_field_assignments。
billing_citystringいいえ請求先の市区町村。
phone_numberstringいいえ完全一致する電話番号(例:800-555-1212)。
service_citystringいいえサービス提供都市。
billing_statestringいいえ請求先の州/都道府県。
email_addressstringいいえ完全一致するメールアドレス。
service_statestringいいえサービス先の州/都道府県(2 文字の略称)。
customer_numberintegerいいえ顧客番号。
service_zip_codestringいいえサービス先の 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_customersread顧客の一覧を取得
kickserv_get_customerread顧客を取得
kickserv_list_customer_jobsread顧客のジョブ一覧を取得
kickserv_list_jobsreadジョブの一覧を取得
kickserv_get_jobreadジョブを取得
kickserv_list_customer_notesread顧客のメモ一覧を取得
kickserv_list_job_notesreadジョブのメモ一覧を取得
kickserv_list_job_time_entriesreadジョブの時間記録一覧を取得
kickserv_get_taskreadタスクを取得
kickserv_list_employeesread従業員の一覧を取得
kickserv_list_itemsread項目の一覧を取得
kickserv_create_customerwrite顧客を作成
kickserv_update_customerwrite顧客を更新
kickserv_add_customer_notewrite顧客にメモを追加
kickserv_create_jobwriteジョブを作成
kickserv_update_jobwriteジョブを更新
kickserv_add_job_notewriteジョブにメモを追加
kickserv_create_taskwriteタスクを作成
kickserv_log_time_entrywriteジョブの作業時間を記録
kickserv_add_job_chargewriteジョブに請求項目を追加
kickserv_usage_statusmeta利用状況(無料プランの使用量)
kickserv_request_featuremeta不足している機能をリクエスト
kickserv_upgrademetaPro にアップグレード(無制限*)
kickserv_cancel_subscriptionmetaPro サブスクリプションをキャンセル

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 との提携関係はなく、同社からの承認も受けていません。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。