Faroz

Faroz MCP サーバー — 子ども向け教育プラットフォームのリモート MCP

エンドポイント： https://faroz.uz/mcp · ドキュメント： faroz.uz/faroz-mcp · レジストリ： uz.faroz/faroz · 認証： OAuth 2.0（API キー不要）

AI アシスタント（Claude、ChatGPT、Gemini、および任意の MCP クライアント）を、8〜17 歳の子ども向け学習プラットフォームである Faroz に接続できます。教師、保護者、コンテンツ作成者は、アシスタントに話しかけるだけで、授業の計画、学習コンテンツの作成、授業カレンダーの管理、生徒の宿題の確認、年齢に適した習慣づくりを行えます。

トランスポート：Streamable HTTP。認証：動的クライアント登録を使用する OAuth 2.0 — 初回利用時にクライアントが Faroz のサインインページを開きます。

できること

領域	機能
コース	カタログや自分のコースを閲覧し、検索して、詳細（レッスン、演習、教科、レベル、対象年齢）を確認できます。コースを作成し、タイトル、説明、教科、レベル、対象年齢、タグ、公開範囲を編集できます。
レッスン	コースにレッスンを追加して編集し、各レッスンに最大 5 件の演習（自分の演習、または ID、タイトル、説明、カテゴリーから見つけたほかの教師の演習）を添付できます。コースの計画の順序を変更し、課題文を指定して宿題を有効にできます。
授業カレンダー	コースのスケジュールを確認し、レッスンを別の日や時間に移動したり、追加のレッスンを追加したり、グループの週間時間割を変更したりできます。新しいレッスンは自動的にカレンダーに登録されます。
宿題の確認	生徒の提出物を一覧表示し、提出物を開いて課題、生徒のコメント、写真、PDF／Word／PowerPoint ファイルのテキストを確認できます。その後、アプリで生徒に表示されるフィードバックを添えて採点（0〜100）するか、修正のために差し戻せます。成績は生徒の習熟度に反映されます。
生徒の進捗	習熟度順に並んだコースの生徒を確認できます（電話番号やメールアドレスは表示されません）。
インタラクティブ演習	任意のテキスト、トピック、授業計画を、すぐに使える演習に変換できます。保存前に各演習が Faroz の形式に照らして検証されるため、モバイルアプリとウェブアプリで正しく開きます。
ゲーム	ゲームのカテゴリーとゲームを閲覧できます。games 権限を持つ作成者は、1〜20 件の演習からゲームを作成できます。
ライブラリ	教科ツリーとメディアライブラリ（動画、音声、画像）を閲覧して演習に再利用できます。また、自分のメディアにタイトル、説明、タグを付けられます。
おすすめと戦略	対象年齢と日付を指定しておすすめを作成し、「怠け心を克服する」などの戦略にまとめることで、対象年齢の子どもが段階的に取り組めるようにできます。
検索	コース、演習、動画、音声、画像、おすすめ、戦略を横断して検索できます。

演習ブロックの種類（11 種類＋2 種類のレイアウト）

テキスト選択問題 · 画像選択問題 · 空欄補充 · 記述式回答 · 音読回答（音声認識） · 画像 · 画像ギャラリー · 音声 · 動画 · 装飾付きリッチテキスト · コールアウトボックス（ルール、例、ヒント）

レイアウトブロック：column（ブロックを縦に並べます。例：1 つのコールアウト内に複数のブロックを配置）と row（スマートフォンでも 2〜3 個のブロックを同じ幅で横に並べます）。

ツール

読み取り専用： whoami、search、fetch、list_courses、get_course、get_course_filters、get_course_schedule、list_course_students、list_homework_submissions、get_homework_submission、list_exercises、get_exercise、get_exercise_usages、get_exercise_format_guide、validate_exercise_body、list_game_categories、list_games、list_media、list_subjects

作成： create_course、add_lesson、create_exercise、create_game、add_calendar_lesson、create_recommendation、create_strategy、add_strategy_recommendations

編集（既存の内容を上書き）： update_course、update_lesson、reorder_lessons、reschedule_lesson、set_group_schedule、update_exercise、update_game、update_media、review_homework、update_recommendation、update_strategy、reorder_strategy_stages

削除ツールはなく、決済にも対応していません： 価格、サブスクリプション、ウォレットがこのサーバーを通じて表示・変更されることはありません。すべての呼び出しはサインイン中のユーザーとして実行され、Faroz アプリとまったく同じ権限が適用されます。宿題ツールを利用できるのは、そのコースのスタッフ（教師、サポート教師、コース管理者）のみです。

コース全体を作成する（組み込みのプレイブック）

すべてのクライアントには、コース作成用プレイブックが自動的に提供されます。設定は不要です。

• サーバーの指示： コース作成前にプレイブックを読むよう、アシスタントに指示します。
• ツールガイド： get_exercise_format_guide(topics=["course_authoring"]) を実行すると、プレイブック全体が返されます（リソース faroz://docs/exercise/course_authoring としても利用できます）。
• プロンプト： create_course（引数：topic、任意の audience、lessons）。Claude ではプロンプトメニューから選択し、Gemini CLI では /create_course を実行します。
• ツールの結果： create_course は next_steps を返し、create_exercise／update_exercise は validation_warnings（例：問題文のないテスト、スタイル未設定のテキスト）を返すため、アシスタントが修正できます。
• スキルファイル： skills/faroz-course-builder/SKILL.md。Claude ではスキルとしてアップロードするか、ChatGPT／Codex プラグインから使用します。

プレイブックで徹底される内容：コースのメタデータをすべて入力し、バナーを設定すること、各レッスンに演習を2～3問含む4～6レッスンを用意すること（理論 → 実践 → テストの順で、最後に最終テストを配置）、コース全体で11種類すべてのコンテンツブロックを使うこと（役立つ場合は column／row レイアウトも使用）、すべての解答ブロックの前に問題を置くこと、テキストにスタイルを設定し、コールアウトを使うこと、画像／動画／音声のリンクを検証すること、1～2レッスンに宿題を設定すること、is_active=false の状態で作成し、最終確認後にのみ公開すること。

宿題

生徒は Faroz アプリでレッスンの宿題を提出します。画像、音声、PDF、Word 文書、プレゼンテーションを合計20 MBまで添付でき、コメントを任意で追加できます。ファイルは非公開で保存され、有効期限付きの署名済みリンクを通じてのみ提供されます。教師はアプリ内、またはこのサーバーを介して AI アシスタントを使って宿題を確認できます。

インストール

Claude： Settings → Connectors → Add custom connector → URL https://faroz.uz/mcp → Connect → Faroz アカウントでサインインします。

ChatGPT： Settings → Apps & Connectors → Advanced → Developer mode → Create → MCP Server URL https://faroz.uz/mcp、Authentication: OAuth を設定します。

Claude Code

claude mcp add --transport http faroz https://faroz.uz/mcp

Cursor、VS Code、Windsurf、その他の mcp.json クライアント

{
  "mcpServers": {
    "faroz": { "url": "https://faroz.uz/mcp" }
  }
}

Gemini CLI

gemini extensions install https://github.com/Akramjon-koder/faroz-mcp

任意の MCP クライアント： URL https://faroz.uz/mcp を使用してリモートサーバーを追加します。クライアントが自身を登録し（RFC 7591）、その後 Faroz のサインインページ（メールアドレス／パスワードまたは Google）が開きます。

プロンプトの例

• 「分数をテーマにした小学5年生向けの数学コースを作成してください。4つのレッスンを設け、各レッスンに演習問題を2つずつ用意してください。」
• 「9～13歳向けの、太陽系について学ぶすてきなコースを作ってください。」（アシスタントはコースのプレイブックに従い、バナー、動画、画像、テスト、宿題を用意します）
• 「水循環についての段落をこちらに用意しました。これをもとに、選択式、穴埋め式、記述式の演習問題を作成し、レッスン2に追加してください。」
• 「分数のコースを開き、すべてのレッスンの演習問題に誤りやわかりにくい設問がないか確認し、見つかったものを修正してください。」
• 「自分のコースを表示し、最初のレッスンの演習問題を一覧にしてください。」
• 「分数のコースでレビュー待ちの宿題をすべて確認し、それぞれを採点して、各生徒に短いフィードバックを書いてください。」
• 「習熟度が高い生徒の上位5人は誰ですか？」
• 「分数のコースの明日のレッスンを金曜日の16:00に変更してください。」
• 「10～12歳向けに、適切なおすすめをもとに『怠け癖を克服する』ための戦略を作り、11月分として新しい毎日のおすすめを1つ追加してください。」

要件

Faroz の無料アカウントが必要です。faroz.uz から登録してください。API キーは不要です。

ロードマップ

今後の対応候補：

• 教師と保護者向けの生徒別進捗レポート
• 生徒のレッスンと学習の進捗に関するサポート

ライセンス

このリポジトリ内のファイル（拡張機能マニフェスト、コンテキストファイル、スキル）は、MIT License のもとで公開されています。Faroz プラットフォームと https://faroz.uz/mcp の MCP サーバーはプロプライエタリなサービスです。

プライバシーとサポート

• プライバシーポリシー： https://faroz.uz/privacy
• 利用規約： https://faroz.uz/terms
• サポート： [email protected]