canvas-mcp

Canvas MCP サーバー

Canvas LMS 用の MCP サーバーです。最大128個のツールと8個のエージェントスキルを利用できます。Claude Desktop、Cursor、Codex、Windsurf、およびその他40以上のエージェント向けに設計されています。セットアップ方法と機能はクライアントによって異なります。

クイックスタート

1. MCP サーバーをインストールします（スキルを含む、ほかのすべての機能を使うには、サーバーを起動しておく必要があります）。

• Claude Desktop： 最新リリースからcanvas-mcp.mcpbをダウンロードし、ダブルクリックします。Canvas の URL とトークンの入力を求められます。ターミナルは不要です。詳細はこちら。
• Cursor、Zed、Windsurf、Continue、Claude Code、その他のクライアント： 仮想環境にpip installし、.envにトークンを追加して、クライアントからcanvas-mcp-serverバイナリを指定します。ローカルインストールに、クライアントごとの設定ブロックがあります。

2. 接続を確認します。 canvas-mcp-server --testを実行すると、Canvas への接続成功が報告されます。その後、クライアントを再起動してください。

3. 任意：ワークフロースキルを追加します。 これらのスキルは、ツールに加えて、複数ステップの手順（週間計画、朝の確認、一括採点、ピアレビュー、コースの品質チェック）をエージェントに教えます。

npx skills add vishalsachdev/canvas-mcp

スキルの一覧はエージェントスキルを参照してください。エージェントが Claude Code の場合、同じ手順をスラッシュコマンドとしても利用できます。

AI エージェント向け

Canvas MCP は、Canvas LMS とやり取りするための最大128個のツールを提供します。デフォルトのプロファイルでは登録されるツール数は少なく、オプションの機能ゲート付きツールを有効にすると、合計128個まで増やせます。ツールはユーザーの種類ごとに整理されています。

クイックリファレンス

コース識別子： Canvas ID（12345）、コースコード（badm_350_120251_246794）、または SIS ID

できないこと： コースの作成・削除、コース設定の変更、他のユーザーのデータへのアクセス

レート制限： 10 分あたり約 700 リクエスト。一括処理には max_concurrent=5 を使用してください。

詳細なドキュメント： AGENTS.md | tools/TOOL_MANIFEST.json | tools/README.md

概要

Canvas MCP Server は、AI アシスタントと Canvas Learning Management System の間をつなぎ、学生、教育者、学習デザイナー、開発者向けに役割別のワークフローを提供します。Model Context Protocol（MCP）に基づいて構築され、MCP 対応クライアント向けに設計されています。セットアップ方法とサポートされる機能は、クライアントによって異なります。

最新リリース：v1.16.0

リリース日： 2026 年 10 月 | 変更履歴の全文 | すべてのリリース

セキュリティリリースです。非公開で報告された 3 件の問題を修正し、1.13.0 のプロンプトインジェクションに関する注意喚起で残っていた最後の問題を解消しました。また、コースグループの作成機能を追加しました。ローカルコード実行に関する破壊的変更として、ローカルサンドボックスには Node.js 22.18 以降が必要になりました。

• ローカルコードサンドボックス (GHSA-7pp5-29mw-9jq3)：コンテナーランタイムを使用しないデフォルトのローカルサンドボックスモードでは、execute_typescript は Node の権限モデルの下で実行されます。コードが読み取れるのはバンドルされたコード API のみです。また、Node は子プロセス、ワーカースレッド、ネイティブアドオン、ファイルへの書き込みを拒否します。破壊的変更：Node.js 22.18 以降が必要です。TypeScript は型を除去して実行されるため、型のインポートには import type を使い、列挙型と名前空間は避けてください。ローカルモードでのネットワーク遮断は、引き続きベストエフォートです（#157）。
• Canvas トークンは Canvas に限定 (GHSA-7mj9-4mcg-hvhv)：別のストレージホストからファイルをダウンロードする際、リダイレクト後も含め、Canvas トークンが送信されなくなりました。また、Canvas 外でのアップロード確認は拒否されます。
• ファイルの内容を隔離 (GHSA-hmr8-mvr2-mvw5)：read_course_file は、返されるファイルの内容を信頼できない Canvas データとしてマークします。また、CI のレジストリテストでそのペイロードを検証します。
• Windows のダウンロード権限 (GHSA-qf6c-jv93-38gv)：Windows では、ダウンロードしたファイルは保存先フォルダーの権限を継承します。Windows でのダウンロード時には毎回、この点が通知されます。これは仕様上の制限です。
• コースグループの作成：create_course_groups は、新しいグループセット、グループ、メンバーシップを CSV からプレビューして確認し、resume_course_group_creation は中断された処理を完了します（#526）。
• リクエストに応じた提出テキスト：list_submissions(include_body=True) は、manage_grades のチェック後に、匿名化され、隔離され、サイズが制限された提出テキストを返します（#523）。

報告してくださった @EQSTLab、@KKazuhaK、@bruchris に感謝します。

学生向け 👨‍🎓

AI を活用したサポートで、次のことができます。

• これから提出する課題と締め切りの確認
• すべてのコースの成績の把握
• ピアレビュー課題の管理
• コースのコンテンツとディスカッションへのアクセス
• TODO リストの整理

→ 学生向けガイドを見る

教育者向け 👨‍🏫

次の機能で授業をより効果的に進められます。

• 課題と採点の管理
• 学生の分析と成績状況の把握
• ディスカッションとピアレビューの進行
• FERPA に配慮したワークフローを支援するプライバシー制御
• 一括メッセージ送信とコミュニケーションツール

→ 教育者向けガイドを見る

学習デザイナー向け 🎨

AI を活用したコース設計と品質保証：

• コースの骨組み作成 — 仕様書、テンプレート、または既存のコースの複製をもとに、コース全体の構成を作成します
• 品質監査 — 学期開始前に、構成、コンテンツ、公開状況、完全性を確認する QC チェックを実施します
• アクセシビリティレビュー — 20 項目の WCAG 指向スキャナー（見出し、表、スコープ、コントラスト、代替テキスト、リンク、キャプション、DesignPLUS への移行）、優先順位付きレポート、ガイド付き修正、検証を提供します
• コース構成の分析 — 1 回の呼び出しでモジュールから項目までのツリー全体を取得し、コースをすばやくレビューできます

専用スキル 3 種（canvas-course-qc、canvas-accessibility-auditor、canvas-course-builder）と、get_course_structure ツールを利用できます。

🤖 エージェントスキル

AI エージェントが Canvas MCP ツールを効果的に使えるようにする、事前構築済みのワークフローレシピです。skills.sh を通じて 40 以上のコーディングエージェントで利用できるほか、Claude Code 専用のスラッシュコマンドとしても利用できます。

skills.sh からインストール（すべてのエージェント）

スキルは MCP ツールを呼び出すため、まずサーバーをインストールしてください。サーバーがなければ、スキルを実行できません。

npx skills add vishalsachdev/canvas-mcp

これを実行すると、任意のエージェント（Claude Code、Cursor、Codex、OpenCode、Cline、Zed、その他多数）にスキルをインストールするための対話型ピッカーが起動します。

特定のスキルをインストールするには：

npx skills add vishalsachdev/canvas-mcp -s canvas-week-plan

Claude Code のスラッシュコマンド

Claude Code を使用している場合、同じワークフローをスラッシュコマンドとしても利用できます：

You: /canvas-morning-check CS 101
Claude: [Generates comprehensive course status report]

You: /canvas-week-plan
Claude: [Shows prioritized weekly assignment plan]

Claude Code のスキルは .claude/skills/ にあり、ワークフローに合わせてカスタマイズできます。

カスタムスキルをお求めですか？ 繰り返し行うワークフローの内容を記載して、リクエストを送信してください！

🔒 プライバシーとデータ保護

教育者向け：FERPA に配慮したデータ取り扱い

Canvas MCP には、教育機関の FERPA 上の義務への対応に役立つ、オプションのプライバシー制御機能があります。ただし、コンプライアンスはデプロイ方法、設定、教育機関のポリシー、AI プロバイダーにも左右されます。

• 応答の匿名化により、対応する ID フィールドを一貫した匿名 ID（Student_xxxxxxxx）に変換します
• ディスカッション投稿および提出物に含まれるメールアドレスのマスキングと、対応する PII パターンのフィルタリング
• 設定可能なプライバシー制御（ENABLE_DATA_ANONYMIZATION=true）を備えたローカルサーバーのデプロイ
• プライバシーに配慮した分析：「サポートが必要な学生は誰ですか？」と尋ねながら、AI クライアントに返される個人を特定するデータを減らせます
• 教職員が匿名 ID と実際の学生をローカルで照合するための匿名化解除マッピングツール

ENABLE_DATA_ANONYMIZATION=true を有効にすると、ツールの結果が AI クライアントに渡される前に、対応する ID フィールドが匿名化されます。学生データを使用する前に、教育者向けガイドと所属機関の要件を確認してください。

学生向け：データの範囲とプライバシー

• Canvas のスコープに限定されたアクセス：学生固有のツールは Canvas の「self」エンドポイントを使用します。共有コースコンテンツのツールは、Canvas がアカウントに付与する権限に従います
• 共有サーバーでの認証情報の保存なし：ローカルモードでは、自分の .env から Canvas トークンを読み取ります。認証済みの組織向け HTTP 環境では、各リクエストでユーザーの Canvas トークンを送信し、サーバーはこれを保存しません
• 組み込みのプロダクト分析機能なし：Canvas MCP はテレメトリーを追加しません。Canvas と AI クライアントには、それぞれ独自のログ記録とデータポリシーが適用されます
• 匿名化は任意：学生向けツールは自分の Canvas データに限定されていますが、AI クライアントのプライバシーポリシーは引き続き適用されます

ホステッドサーバー（提供終了）

公開ホステッドサーバー（mcp.illinihunt.org）は提供を終了しました。アクセス制御のない公開 MCP エンドポイントは、組み込みのコード実行ツールが公開されるため、安全に運用できません。そのため、推奨される方法は、以下の**ローカルインストール**です。

HTTP／ストリーム可能なトランスポート自体は、独自の認証の背後でセルフホストする場合、引き続き完全にサポートされます（canvas-mcp-server --transport streamable-http）。組織向けに、認証付きの共有インスタンスを運用する場合は、サンプルのワークフローと設定テンプレートを含む、本番環境での動作確認済みのデプロイ仕様（Azure App Service + Entra ID プラットフォーム認証、ユーザーごとの Canvas トークン）について、**deploy/azure/**を参照してください。

前提条件（ローカルインストール）

• Python 3.11+ - モダンな機能と型ヒントに必要です
• Canvas API へのアクセス - API トークンと組織の URL が必要です
• MCP クライアント - MCP 互換クライアント（Claude Desktop、Cursor、Zed、Windsurf、Continue など）。セットアップ方法と機能はクライアントによって異なります

対応する MCP クライアント

Canvas MCP は、Claude Desktop、Codex、Cursor、Zed、Windsurf、Continue、Replit、Copilot Studioなどの MCP 互換クライアント向けに設計されています。セットアップの詳細と対応する機能は、クライアントによって異なります。

Canvas MCP は、User-Agent ヘッダーや per_page によるページネーションなど、文書化された Canvas API のパターンを使用します。Canvas Cloud と、互換性のあるセルフホスト型インスタンスを対象としています。

Claude Desktop Extension としてインストール（最も簡単）

Claude Desktop を使用している場合、Canvas MCP はワンクリックでインストールできます。ターミナルも設定ファイルの編集も不要です。

1. 最新のリリースから canvas-mcp.mcpb をダウンロードします。
2. ファイルをダブルクリックするか、Claude Desktop → Settings → Extensions にドラッグします。
3. プロンプトが表示されたら、/api/v1 パスを含む Canvas API URL（例：https://canvas.youruniversity.edu/api/v1）と、Canvas API token（Canvas → Account → Settings → New Access Token。一部の機関では代わりに申請フォームから発行されます。下記を参照）を入力します。トークンは OS のキーチェーンに保存されます。

この拡張機能はサーバーをローカルで実行し、ご自身のトークンを使って Canvas を呼び出すため、リクエストにはそのトークンの Canvas 権限が適用されます。Canvas とお使いの AI クライアントには、それぞれ独自のアクティビティ記録が保持される場合があります。この拡張機能は uv を使用して Python 3.13 を選択し、依存関係を管理します。Python 3.13 が見つからない場合、初回起動時に uv がダウンロードします（インターネット接続が必要で、Python のダウンロードが許可されている必要があります）。Python を別途インストールしたり、システムのデフォルト Python を変更したりする必要はありません。他のクライアントで使用する場合や、ソースから実行する場合は、以下の手動セットアップを使用してください。

Windows のトラブルシューティング： spawn uv ENOENT は、Claude Desktop が uv を見つけられないことを意味します。uv をインストールしてから、Claude Desktop を完全に終了して再起動し、更新された PATH を読み込ませてください。古い拡張機能バンドルでは Python 3.15 が選択され、cffi のコンパイル時に「Microsoft Visual C++ 14.0 or greater is required」というエラーが発生することがあります。コンパイラーをインストールする代わりに、手動のクライアント設定で uv run --python 3.13 を使い、Python 3.13 を明示的に選択してください。issue #391 を参照してください。既存のリリース済みバンドルには、変更を含むリリースをインストールしない限り、ランチャーの変更は反映されません。

ローカルインストール

1. 依存関係をインストールする

# (Recommended) Use a dedicated virtualenv so the MCP binary is in a stable location
python3 -m venv .venv
. .venv/bin/activate

# Install the package editable
pip install -e .

2. 環境を設定する

# Copy environment template
cp env.template .env

# Edit with your Canvas credentials
# Required: CANVAS_API_TOKEN, CANVAS_API_URL

Canvas API token の取得先：Canvas → Account → Settings → New Access Token

一部の機関では、トークンの作成が制限されています。 セルフサービスが無効になっている場合、 「New Access Token」ボタンが表示されないか、操作時にエラーが発生し、代わりに IT の申請フォームから トークンが発行されます。API にアクセスできないと判断する前に、所属機関の IT ナレッジベースを確認してください。

University of Illinois Urbana-Champaign では、学生も教員も例外なくこの方式です。
Canvas API Token Request form からトークンを申請してください（NetID でのログインが必要です）。承認されたら：

1. Canvas → Account → Settings → Approved Integrations に移動し、新しいトークンを見つけて、 Activate をクリックし、ページを更新します。
2. Technology Services から送信される U of I Box のリンクで、トークンの値を取得します。

2026 年 8 月時点で、新しい Illinois トークンはすべて 有効期限が 30 日です（上流の Instructure の要件によるものです）。有効期限は監視も通知もされず、期限切れのトークンは 予告なく削除されます。現在のトークンが期限切れになる前に、後継のトークンを申請してください。 詳細：Answers KB 150325。

他の地域の学生：「There is a limit to the number of access tokens you can create」と表示される場合や、トークン作成のオプションが見つからない場合は、所属機関の Canvas 管理者または IT サポート部門に連絡して、API アクセスを申請してください。

3. MCP クライアントの設定

Canvas MCP は、MCP 互換クライアント向けに設計されています。以下に一般的なクライアントの設定例を示します。正確な設定方法や機能はクライアントによって異なります。

{
  "mcpServers": {
    "canvas-api": {
      "command": "/absolute/path/to/canvas-mcp/.venv/bin/canvas-mcp-server"
    }
  }
}

[mcp_servers.canvas-api]
command = "/absolute/path/to/canvas-mcp/.venv/bin/canvas-mcp-server"
cwd = "/absolute/path/to/canvas-mcp"

codex mcp add canvas-api -- /absolute/path/to/canvas-mcp/.venv/bin/canvas-mcp-server

{
  "mcpServers": {
    "canvas-api": {
      "command": "/absolute/path/to/canvas-mcp/.venv/bin/canvas-mcp-server"
    }
  }
}

{
  "context_servers": {
    "canvas-api": {
      "command": {
        "path": "/absolute/path/to/canvas-mcp/.venv/bin/canvas-mcp-server",
        "args": []
      }
    }
  }
}

{
  "mcpServers": {
    "canvas-api": {
      "command": "/absolute/path/to/canvas-mcp/.venv/bin/canvas-mcp-server"
    }
  }
}

{
  "mcpServers": {
    "canvas-api": {
      "command": "/absolute/path/to/canvas-mcp/.venv/bin/canvas-mcp-server"
    }
  }
}

Windows ユーザー向け：パス内のスラッシュをバックスラッシュに置き換えてください（例：C:\Users\YourName\canvas-mcp\.venv\Scripts\canvas-mcp-server.exe）

動作確認

設定をテストします。

# Test Canvas API connection
canvas-mcp-server --test

# View configuration
canvas-mcp-server --config

# Start server (for manual testing)
canvas-mcp-server

利用可能なツール

Canvas MCP Server は、Canvas LMS API を操作するためのツールセットを提供します。これらのツールは、見つけやすさと保守性を高めるため、用途別に分類されています。

ツールのカテゴリ

学生向けツール（新機能！）

• 個人の課題の追跡と締切の管理
• すべてのコースの成績をモニタリング
• TODO リストと相互レビューの管理
• 提出状況の追跡

共有ツール（学生と教育者の両方が利用）

1. コースツール - コースの一覧表示と管理、詳細情報の取得、シラバスの内容を使った概要の生成
2. ディスカッションとお知らせのツール - ディスカッション、お知らせ、返信の管理
3. ページとコンテンツのツール - ページ、モジュール、コースコンテンツへのアクセス

教育者向けツール 4. 課題ツール - 分析機能を備えた課題、提出物、相互レビューの管理 5. ルーブリックツール - ルーブリックの作成、安全な更新と一覧表示、課題との関連付け、提出物の採点（効率的な一括採点を行うbulk_grade_submissionsを含む）。update_rubricは保護された全置換操作です。既存の評価基準と評価の ID を保持し、プレビューと確認を必須とし、結果を検証します。ルーブリック API の動作と採点に関する注意事項を参照してください。 6. ユーザーと登録ツール - 登録、ユーザー、グループの管理 7. 分析ツール - 学生の分析データ、課題の統計、進捗状況の追跡を表示 8. メッセージングツール - 学生へのメッセージとお知らせの送信

開発者向けツール 9. 検索ツール - search_canvas_toolsで登録済みの MCP ツールとコード実行 API 操作を検索し、list_code_api_modulesでコード実行モジュールを一覧表示 10. コード実行ツール - execute_typescriptでTypeScriptコードを実行し、一括項目処理をモデルのコンテキスト外で行えるようにします

📖 利用可能なツールの詳細については、ツールのドキュメント全文を見る。

コード実行 API

一括操作（30項目以上）では、Canvas MCP はTypeScriptコード実行に対応しています。すべての項目をモデルのコンテキストに読み込まずに、一括操作をローカルで処理できます。

search_canvas_toolsで利用可能な操作を検索し、続いてexecute_typescriptでローカル実行します。デフォルトのサンドボックスでは、時間、メモリ、環境、およびベストエフォートのネットワーク制御が適用されますが、完全なセキュリティ境界ではありません。信頼できないコードや厳格な送信トラフィック制御が必要な場合は、より強力な外部隔離を使用してください（issue #157を参照）。macOS、Linux、Windowsで動作します。

import { bulkGrade } from './canvas/grading/bulkGrade';

await bulkGrade({
  courseIdentifier: "60366",
  assignmentId: "123",
  gradingFunction: (submission) => {
    const notebook = submission.attachments?.find(f =>
      f.filename.endsWith('.ipynb')
    );
    if (!notebook) return null;
    return { points: 100, comment: "Great work!" };
  }
});

使い方

MCP クライアントがサーバーを自動的に起動します。自然な言葉で質問するだけです。

• 「今週の締切は何ですか？」 ／ 「自分の成績を表示して」 ／ 「必要な相互レビューは何ですか？」
• 「課題3をまだ提出していないのは誰ですか？」 ／ 「未提出の学生にリマインダーを送って」

クイックスタートガイド：学生向け | 教育者向け | 実際のワークフロー | トラブルシューティング

ドキュメント

• ツールのドキュメント — 利用可能なツール（オプションの機能フラグ付きツールを含む）のリファレンス
• 学生向けガイド — 学生向けの入門ガイド
• 教育者向けガイド — FERPA に関する考慮事項と教育者向けのワークフロー
• 一括採点の例 — 一括採点の手順
• 開発ガイド — アーキテクチャと貢献方法

トラブルシューティング

問題が発生した場合は、次の項目をご確認ください。

1. サーバーが起動しない — .env ファイル、仮想環境のパス、依存関係など、ローカルインストールの設定を確認してください
2. 認証エラー — Canvas API トークンの有効性と権限を確認してください
3. 接続の問題 — Canvas API の URL が正しいことと、ネットワークにアクセスできることを確認してください
4. デバッグ — MCP クライアントのコンソールログ（例：Claude Desktop の開発者コンソール）を確認するか、サーバーを手動で実行してエラー出力を確認してください

セキュリティ

実行時のセキュリティとプライバシー制御：

FERPA に配慮した教育者向けワークフローでは、オプションで匿名化を有効にできます：ENABLE_DATA_ANONYMIZATION=true。適用範囲と設定の詳細については、教育者向けガイドをご覧ください。

公開

PyPI、MCP Registry、skills.sh（エージェントスキル）で公開されています。リリースは GitHub Actions により自動化されています。バージョンにタグを付け（git tag vX.Y.Z && git push origin vX.Y.Z）、あとは CI が処理します。

関連プロジェクト：UIUC Course MCP

Canvas MCP の作者である Vishal Sachdev による UIUC Course MCP は、イリノイ大学の公開コース検索、説明、セクションのスケジュールをローカルの AI アシスタントで利用できるようにします。読み取り専用で、アカウントや API キーは不要です。コースの検索にはこちらを、Canvas コース内でサポート対象のワークフローを実行するには Canvas MCP をご利用ください。サーバーのセットアップはそれぞれ別々で、自動アカウント連携機能はありません。

利用を開始 · ソースと機能リクエスト

貢献

貢献を歓迎します！お気軽にどうぞ：

• バグや機能リクエストについて issue を提出する
• 改善を含むプルリクエストを作成する
• ユースケースやフィードバックを共有する

貢献者

Canvas MCP に貢献してくださった皆さん、ありがとうございます。

• @KKazuhaK — 学生グループ、成績、クイズ、カレンダー、フィード、受信トレイのツール、Windows CI、コース識別子の解決、完全な全コンテンツの読み取り（#456 から #470）
• @bruchris — テストスイート内のすべてのテキストの読み取りと書き込みで UTF-8 を使用（#445）
• @papatistos — GraphQL を介したグループスペースのディスカッションと匿名ディスカッションの読み取り（#433、#439）
• @lindsay-cheng — 期限超過の提出物に対する Canvas の missing フラグ（#423）
• @EastArctica — 外部ツールの課題が未提出として報告されないように修正（#390）
• @DomBarker99 — リモート MCP デプロイ向けの read_course_file ツール（#90）
• @Promithius-DR — ロールベースのツールフィルタリングとツールアノテーション（#84）
• @Metzpapa — ファイルのダウンロードおよび一覧表示ツール（#75）
• @JCSnap — 学生向けツールのバグ修正（#72、#73）

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

Vishal Sachdev が作成