Teachworks MCP by usefulapi について
Teachworks MCP by usefulapiは、個別指導事業者とスタッフ向けのホスト型MCPサーバーです。MCPクライアントから授業や会計の記録を確認し、レッスンを予約できます。家族、学生、レッスン、支払いの作成にも対応します。
主な機能
- 01学生、家族、従業員の参照
- 02レッスン、空き状況、イベントの確認
- 03請求書と支払い記録の参照
- 04家族、学生、レッスンの作成
- 05学生のレッスン追加と支払い記録
活用シーン
- 01学生とレッスン予定の確認
- 02請求書と支払い情報の確認
- 03レッスンを作成して学生を追加
MCP 対応
ClaudeやCursorなどのクライアント向けのホスト型MCPサーバーです。Teachworks API tokenを使い、読み取り専用ツールと一部の書き込みツールにアクセスします。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://teachworks.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-teachworks https://teachworks.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-teachworks":{"type":"http","url":"https://teachworks.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-teachworks":{"type":"http","url":"https://teachworks.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-teachworks":{"type":"http","url":"https://teachworks.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-teachworks":{"serverUrl":"https://teachworks.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
24| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| page | integer | いいえ | ページ番号(1 始まり、デフォルトは 1)。 |
| type | enum | いいえ | family = 子どもの生徒、independent = 独立した生徒。family | independent |
| string | いいえ | メールアドレスで検索します。 | |
| grade | string | いいえ | 学年で検索します。 |
| school | string | いいえ | 学校で検索します。 |
| status | enum | いいえ | Active | Inactive | Prospective |
| subject | string | いいえ | 主題で検索します。 |
| per_page | integer | いいえ | 1 ページあたりのレコード数(デフォルトは 20、最大 50)。 |
| direction | enum | いいえ | id の昇順(デフォルト)または降順(新しい順)で並べ替えます。asc | desc |
| last_name | string | いいえ | 姓で検索します。 |
| first_name | string | いいえ | 名で検索します。 |
| customer_id | any | いいえ | この顧客/家族の id に属する生徒のみを対象にします。 |
| phone_number | string | いいえ | 電話番号で検索します。 |
詳細
usefulapi の Teachworks MCP
Teachworks を Claude、Cursor、または任意の MCP クライアントから利用できます。Teachworks の生徒、家族、講師、レッスン、請求書、支払いの読み取りや、レッスンの予約ができます。 ホスト型のため、ローカルへのインストールは不要です。お使いの Teachworks 認証情報で接続できます。
ライブエンドポイント: https://teachworks.usefulapi.io/mcp · ホームページ: https://usefulapi.io/teachworks
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://teachworks.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcpを実行し、続いて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"teachworks": {
"url": "https://teachworks.usefulapi.io/mcp"
}
}
}
URL だけを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインイン処理を行い、ログインページで Teachworks の認証情報を求めます。
手順を追ったセットアップ方法、認証情報の確認方法、FAQ:https://usefulapi.io/teachworks/
初回の接続時に、Teachworks API token を入力します。 認証情報は検証され、ユーザーごとに保存され、本人にのみ適用されます。設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
teachworks_list_students | read | 生徒の一覧を取得 |
teachworks_get_student | read | 生徒を取得 |
teachworks_list_customers | read | 顧客の一覧を取得 |
teachworks_get_customer | read | 顧客を取得 |
teachworks_list_employees | read | 従業員の一覧を取得 |
teachworks_get_employee | read | 従業員を取得 |
teachworks_get_employee_earnings | read | 従業員の報酬を取得 |
teachworks_get_lesson_totals | read | レッスンの合計を取得 |
teachworks_list_lessons | read | レッスンの一覧を取得 |
teachworks_get_lesson | read | レッスンを取得 |
teachworks_list_other_events | read | その他のイベントの一覧を取得 |
teachworks_list_availabilities | read | 講師の空き状況の一覧を取得 |
teachworks_list_invoices | read | 請求書の一覧を取得 |
teachworks_get_invoice | read | 請求書を取得 |
teachworks_list_payments | read | 支払いの一覧を取得 |
teachworks_get_payment | read | 支払いを取得 |
teachworks_list_locations | read | 場所の一覧を取得 |
teachworks_list_services | read | サービスの一覧を取得 |
teachworks_list_subjects | read | 科目の一覧を取得 |
teachworks_create_family | write | 家族を作成 |
teachworks_create_child_student | write | 子どもの生徒を作成 |
teachworks_create_lesson | write | レッスンを作成 |
teachworks_add_student_to_lesson | write | 生徒をレッスンに追加 |
teachworks_create_payment | write | 支払いを記録 |
teachworks_usage_status | meta | 使用状況(無料プランの利用状況メーター) |
teachworks_request_feature | meta | 不足している機能をリクエスト |
teachworks_upgrade | meta | Pro にアップグレード(無制限*) |
teachworks_cancel_subscription | meta | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更します(クライアントは実行前に確認する必要があります)。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月 50 回のツール呼び出し |
| Pro(ユーザーごと) | $9/mo または $90/yr(2 か月分無料) | 無制限* |
*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro はこのサーバーのみを対象とします。teachworks_upgrade で登録してください(Stripe Checkout のリンクが返されます)。teachworks_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで継続し、現在の期間分の返金はありません。また、期間終了前に teachworks_upgrade を実行すると、キャンセルが取り消されます。[email protected] までご連絡いただくこともできます。
ライセンス
MIT © usefulapi。Teachworks との提携や、Teachworks による推奨を受けているものではありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。