Smartplan MCP by usefulapi について
Smartplan MCP by usefulapiは、SmartplanアカウントをMCPクライアントに接続し、勤務スケジュールのデータを扱います。アカウント、スタッフ、ロケーション、シフト、勤務記録、休暇を参照する読み取り専用ツールを備え、ホスト型OAuth認証を利用します。
主な機能
- 01接続アカウントとメンバーの確認
- 02ロケーションと職種の参照
- 03シフトの一覧と取得
- 04勤務記録と休暇の確認
活用シーン
- 01今後のシフトとスタッフ情報の確認
- 02記録済み勤務時間の確認
- 03従業員の休暇日の照会
MCP 対応
リモートエンドポイントを通じて、Smartplanの読み取り専用ツールをMCPクライアントに公開します。Smartplanの認証情報を使うホスト型認証フローを利用します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://smartplan.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-smartplan https://smartplan.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-smartplan":{"type":"http","url":"https://smartplan.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-smartplan":{"type":"http","url":"https://smartplan.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-smartplan":{"type":"http","url":"https://smartplan.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-smartplan":{"serverUrl":"https://smartplan.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
usefulapi の Smartplan MCP
リモート MCP エンドポイント:https://smartplan.usefulapi.io/mcp
接続
- Claude(claude.ai、デスクトップ):カスタマイズ → コネクタを開き、+ 追加 → カスタムコネクタを追加をクリックして、
https://smartplan.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http smartplan https://smartplan.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code:VS Code に追加。
- **Cursor およびその他のクライアント:**リモート MCP サーバーとして URL を追加します。
{
"mcpServers": {
"smartplan": {
"url": "https://smartplan.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーが OAuth でログインし、ログインページで Smartplan の認証情報を求められます。
設定手順、認証情報の確認方法、よくある質問:https://usefulapi.io/smartplan/
ホストされた認証フローを使用して、Smartplan の認証情報で接続します。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
smartplan_list_accounts | 読み取り | 接続済みアカウントを表示 |
smartplan_get_account | 読み取り | 接続済みアカウントを取得 |
smartplan_list_members | 読み取り | メンバー一覧を取得 |
smartplan_get_member | 読み取り | メンバーを取得 |
smartplan_list_locations | 読み取り | ロケーション一覧を取得 |
smartplan_get_location | 読み取り | ロケーションを取得 |
smartplan_list_jobtypes | 読み取り | 職種一覧を取得 |
smartplan_get_jobtype | 読み取り | 職種を取得 |
smartplan_list_shifts | 読み取り | 今後のシフト一覧を取得 |
smartplan_get_shift | 読み取り | シフトを取得 |
smartplan_list_worklogs | 読み取り | 記録済みの勤務記録一覧を取得 |
smartplan_get_worklog | 読み取り | 勤務記録を取得 |
smartplan_list_absences | 読み取り | 休暇日一覧を取得 |
smartplan_get_absence | 読み取り | 休暇を取得 |
smartplan_usage_status | メタ | 使用状況(無料プランの利用量) |
smartplan_request_feature | メタ | 不足している機能をリクエスト |
smartplan_upgrade | メタ | Pro または Pro+ にアップグレード |
smartplan_cancel_subscription | メタ | Pro サブスクリプションを解約 |
readツールは読み取り専用です。writeツールはデータを変更するため、クライアントは実行前に確認する必要があります。metaツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| 無料 | $0 | 月50回のツール呼び出し |
| Pro(アカウントごと) | 月額$9または年額$90(2か月分無料) | 無制限* |
*このサーバーでのProの公正利用上限は、月10,000回のツール呼び出しです。それ以上必要な場合は、[email protected] までご連絡ください。
Proの対象はこのサーバーのみです。smartplan_upgradeで登録してください(Stripe Checkout のリンクが返されます)。smartplan_cancel_subscriptionでいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。期間終了前にsmartplan_upgradeを実行すると、解約が取り消されます。または、[email protected] までご連絡ください。
ライセンス
リポジトリのライセンスを参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。