TaScan

TaScan MCP サーバー

TaScan 向けの AI エージェント連携 — クローズドループ型の自律運用プロトコルです。Claude、GitHub Copilot、または MCP 互換の AI クライアントを通じて、プロジェクト、イベント、タスク、ワーカー、QR コード、テンプレート、完了レポート、AI を活用した問題解決を管理できます。

タスク。スキャン。完了。

TaScan とは？

TaScan は、物理世界の作業に向けた、ダウンロード不要のタスク割り当て・検証プラットフォームです。ワーカーは QR コードをスキャンし、写真で検証しながらタスクを完了します。マネージャーはリアルタイムの完了レポートを受け取れます。アプリのダウンロード、ログイン、トレーニングは必要ありません。

問題が発生すると、AI が問題を分析し、修正手順を生成して、適切なワーカーに指示を送信します。これにより、10 秒以内に自律的にループを完了します。

業界：ライブイベント、建設、ホスピタリティ、倉庫、プロパティマネジメント、医療、航空、FEMA の災害対応など。

仮特許を10件出願済み — 265件の請求項、約1000ページ以上の明細書。USPTO 出願番号 #63/995,189 から #64/001,286 まで。

最速の開始方法：Claude.ai / Claude Mobile

インストールは不要です。Claude で TaScan をカスタムコネクターとして追加します。

1. 設定 > コネクター > カスタムコネクターを追加
2. 次を入力します：https://app.tascan.io/mcp
3. ツールを初めて使用するときに、TaScan のメールアドレスとパスワードでサインインします

これで完了です。claude.ai と Claude モバイルで動作します。GitHub、Netlify、Supabase のコネクターと同じサインイン方法です。

---

インストール（Claude Desktop / Claude Code）

npm install tascan-mcp

または npx で直接実行します：

npx tascan-mcp

設定

環境変数

変数	必須	説明
TASCAN_API_KEY	はい	TaScan API キー（Admin Portal > Team > API Keys で生成）
TASCAN_API_URL	いいえ	API のベース URL（デフォルト：https://app.tascan.io/api/v1）

Claude Desktop

Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "tascan": {
      "command": "npx",
      "args": ["-y", "tascan-mcp"],
      "env": {
        "TASCAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add tascan -- npx -y tascan-mcp

次に、環境変数に API キーを設定します。

リモート（claude.ai / Claude Mobile）

TaScan MCP はリモートサーバーとしても利用できます。インストールも API キーも不要です：

https://app.tascan.io/mcp

Claude のカスタムコネクターとして追加します（設定 > コネクター）。ツールを初めて使用するときに、TaScan のメールアドレスとパスワードでサインインするようリダイレクトされます。GitHub や Netlify への接続と同じです。OAuth 2.0 と PKCE がすべて自動的に処理します。

ツール（36）

プロジェクト

ツール	説明	種類
tascan_list_projects	組織内のすべてのプロジェクトを一覧表示	読み取り
tascan_get_project	特定のプロジェクトの詳細を取得	読み取り
tascan_create_project	新しいプロジェクトを作成	作成
tascan_update_project	プロジェクト名、場所、ステータス、日付を更新	更新
tascan_delete_project	プロジェクトとそのすべての内容を削除	削除

イベント（タスクリスト）

ツール	説明	種類
tascan_list_events	プロジェクト内のすべてのイベントを一覧表示	読み取り
tascan_get_event	タスクを含むイベントの詳細を取得	読み取り
tascan_create_event	プロジェクト内に新しいイベントを作成	作成
tascan_update_event	イベント名、説明、モードを更新	更新
tascan_delete_event	イベントとそのすべてのタスクを削除	削除

タスク

ツール	説明	種類
tascan_list_tasks	イベント内のすべてのタスクを一覧表示	読み取り
tascan_get_task	完了情報を含むタスクの詳細を取得します。各完了情報には photo_url（生のストレージパス）と photo_signed_url（取得可能、有効期限は約1時間、写真がない場合は null）が含まれます	読み取り
tascan_add_tasks	イベント内にタスクを一括作成	作成
tascan_update_task	タスクのタイトル、種類、フラグ、順序を更新	更新
tascan_delete_task	タスクとその完了情報を削除	削除

作業者

ツール	説明	種類
tascan_list_workers	組織内のすべての作業者を一覧表示します	読み取り
tascan_create_worker	新しい作業者プロフィールを作成します	作成
tascan_update_worker	作業者の名前、電話番号、メールアドレスを更新します	更新

オペレーション

ツール	説明	種類
tascan_generate_qr	イベント用の QR コードを生成します	作成
tascan_apply_template	イベントに既成のテンプレートを適用します	作成
tascan_list_templates	利用可能なタスクテンプレートを一覧表示します	読み取り
tascan_get_report	イベントの完了レポートを取得します（省略可能な include_responses を指定すると、送信済みの回答データに加えて、タスクごとの { path, signed_url, completed_at, worker_name } のリスト photos[] を返します）	読み取り
tascan_generate_report	共有可能な完了／サービス（クライアントのブランドに合わせた、確認可能なレポート）／プロジェクト／証拠パックのリンクを発行します。テキストメッセージでの送信も指定できます	書き込み
tascan_list_reports	リストまたはプロジェクトの既存のレポートリンクと確認状況を一覧表示します	読み取り
tascan_invite_worker	マーケットプレイスの作業者に、同意を得たうえで紹介します。TaScan が作業者にテキストメッセージを送り、YES の場合は組織に追加してリストを送信し、NO の場合は匿名のままにします	書き込み
tascan_list_invites	マーケットプレイスへの招待とそのステータスを表示します。承諾された招待には作業者の連絡先が含まれます	読み取り
tascan_zone_compliance	危険区域の監査：立ち入り状況、AI が検証した PPE チェックポイントの判定、違反、直近の PPE チェックと照合した負傷情報を表示します（ゾーンには現在、kind、required_ppe、task_list_on_enter、作業者向け SMS ルールが含まれます）	読み取り
tascan_create_invoice	明示的に指定した項目、または検証済み作業（プロジェクト／リスト × 時間単価または定額料金）からクライアント向け請求書を作成します。共有リンクを返し、単一リストの請求書の場合は、リンクされたクライアント向けサービスレポートも返します	書き込み
tascan_list_invoices	ステータス、合計金額、支払期限、リンク、未払い残高とともに請求書を一覧表示します	読み取り
tascan_update_invoice	支払い済み／期限超過／キャンセル済みへの変更、クライアント情報、メモ、支払期限の編集を行います	書き込み
tascan_query_responses	プロジェクト内のすべてのリストにわたる、1 つのタスクへの回答を時系列の推移として表示します	読み取り

クローズドループ自律オペレーション（特許出願中）

ツール	説明	種類
tascan_list_issues	現場から報告された問題を、ステータス、カテゴリ、深刻度で絞り込んで一覧表示します	読み取り
tascan_analyze_issue	AI が問題の深刻度を分類し、根本原因を特定して、緊急度を評価します	AI
tascan_recommend_fix	AI が段階的な手順を含む、優先順位付きの是正タスクを生成します	AI
tascan_auto_resolve	1 回の呼び出しでクローズドループ全体を実行します。問題を受け取り、AI が分析し、修正を手配して、ループを完了します	AI

コミュニケーション

ツール	説明	種類
tascan_dispatch_instruction	作業者に複数のチャネル（SMS、メール、QR）で指示を送信します	作成
tascan_send_task_email	タスクリンクや通知をメールで送信します	作成
tascan_complete_task	省略可能な回答データとともに、タスクを完了としてマークします	更新

AI エージェントの連携（特許 #10）

ツール	説明	種類
tascan_list_agents	システムに登録されている AI エージェントを一覧表示します	読み取り
tascan_register_agent	機能を指定して、新しい AI エージェントを登録します	作成
tascan_dispatch_to_agent	タスクを特定の AI エージェントに割り当てて実行します	作成

使用例

例 1：建設現場の点検を設定する

User: Create a construction project for the Downtown Tower site and set up a daily safety inspection with tasks for PPE check, fall protection, scaffolding inspection, and fire extinguisher check. Make all tasks safety checkpoints that require photos.

Claude will:
1. Call tascan_create_project with name "Downtown Tower" and location "123 Main St"
2. Call tascan_create_event with name "Daily Safety Inspection"
3. Call tascan_add_tasks with 4 safety checkpoint tasks requiring photos
4. Call tascan_generate_qr to create a scannable QR code for the foreman

例 2：AI を活用した自律的な問題解決

User: Check if there are any open issues on the Marriott load-in and have TaScan fix them automatically.

Claude will:
1. Call tascan_list_issues to find open issues
2. Call tascan_auto_resolve for each issue — AI analyzes root cause, generates fix tasks, and dispatches instructions to the nearest qualified worker via SMS
3. Report back with resolution status and confidence scores

例 3：テンプレートを使ってイベントをすばやく展開する

User: We have a warehouse receiving shipment coming in tomorrow. Set up the standard receiving checklist.

Claude will:
1. Call tascan_list_templates with category "logistics" to find available templates
2. Call tascan_create_project for the warehouse
3. Call tascan_create_event for the receiving session
4. Call tascan_apply_template with the "warehouse-receiving" template slug
5. Call tascan_generate_qr for the receiving dock crew

例 4：現場の問題を分析して優先順位を付ける

User: We have 5 open issues on the concert setup. Analyze them all and tell me which ones are most urgent.

Claude will:
1. Call tascan_list_issues to get all open issues
2. Call tascan_analyze_issue for each one — AI classifies severity, root cause probability, and urgency score
3. Rank by urgency and recommend which to auto-resolve vs which need human attention

タスクの種類

タスクでは、複数の応答タイプをサポートしています。

種類	説明
checkbox	完了／未完了のシンプルな選択（デフォルト）
photo	完了するには写真のアップロードが必要
text	自由記述で回答
number	数値で回答
date	日付を選択
choice	選択肢から選択

タスクには、次のフラグも設定できます。

• 安全チェックポイント（is_safety_checkpoint: true） — 赤色で強調表示され、スキップできません
• 写真必須（requires_photo: true） — 完了するには作業者が写真を添付する必要があります

API キーの取得

1. TaScan Admin Portal にログインします
2. サイドバーで Team に移動します
3. API Keys までスクロールします
4. Generate API Key をクリックします
5. キーをコピーします（表示されるのは一度だけです）
6. 環境変数 TASCAN_API_KEY に設定します

API キーは組織に紐付けられ、レート制限（1 分あたり 60 リクエスト）が適用されます。

トラブルシューティング

「Connection failed」または OAuth リダイレクトの問題

• 正しい URL を使用していることを確認します：https://app.tascan.io/mcp
• ブラウザーのキャッシュをクリアして、再接続を試します
• Claude Desktop を使用している場合は、コネクターの追加後にアプリを再起動します

「Unauthorized」または 401 エラー（ローカルでの npm インストール）

• Admin Portal > Team > API Keys で API キーを再生成します
• TASCAN_API_KEY が設定ファイルだけでなく、環境変数にも設定されていることを確認します
• キーは組織ごとに設定されています。正しい組織のキーを使用していることを確認します

Claude にツールが表示されない

• TaScan コネクターを切断してから再接続します
• Claude Code の場合は、claude mcp list を実行してサーバーが登録されていることを確認します
• TaScan アカウントに有効な組織があることを確認します（無料プランでも問題ありません）

「Rate limited」エラー

• デフォルトの制限は API キーごとに 1 分あたり 60 リクエストです
• Pro および Business プランでは、より高い制限が適用されます
• バッチ操作（tascan_add_tasks など）は、個別の呼び出しより効率的です

タスクの完了が表示されない

• 作業者はタスクのリンク（QR スキャンまたは直接 URL）から送信する必要があります
• 写真必須のタスクは、写真がアップロードされるまで完了として表示されません
• イベントの応答モード（単一または複数の応答）を確認します

写真の証拠リンク

• photo_url はストレージオブジェクトの生パスで、安定しており変更されません。photo_signed_url は取得可能な HTTPS リンクで、約 1 時間後に期限切れになります（サーバーのデフォルトは TASCAN_PHOTO_URL_TTL=3600）。新しいリンクを取得するには読み取りツールを再実行してください。署名付き URL は保存しないでください。
• photo_url が null でないのに photo_signed_url: null の場合、読み取り時に署名を取得できなかったことを意味します（ストレージの一時的な問題）。読み取り自体は成功しているため、リンクの取得を再試行してください。

変更履歴

v3.15.0 — 2026-09-19

• tascan_create_cycle に任意の reviews[] 配列が追加されました。これは複数の観点によるレビューパネルです（設計項目 14a）。1～8 個の観点を指定でき、それぞれ {lens, brief, provider: openai|anthropic|gemini, model?, blocking? (デフォルトは true), max_tool_calls? (openai のみ)} を指定します。POST /coord/cycles に転送され、少なくとも 1 つの観点をブロッキングにする必要があります。単一の OpenAI レビューを行う場合は省略してください。
• tascan_get_cycle_report は、パネルレビューのステップでは review[<lens>] を出力します。従来のステップでは、これまでどおり review を出力します。
• ツールは 79 個で、新しいツールはありません。スコープに変更はありません。

v3.14.1 — 2026-09-18

• tascan_create_cycle に任意の repo 引数が追加されました。これはビルドを実行するエグゼキューター上のコードベースを指定するもので、エグゼキューターの許可リスト（tascan-agent/repos.json）にあるエイリアスを使用します（デフォルトは tascan）。artifact_paths はそのリポジトリからの相対パスです。不明なエイリアスはエグゼキューターに拒否され（repo_unknown）、サイクルは停止します。このプロトコルにより、TaScan 自体だけでなく、エグゼキューターに登録された任意のプロジェクトでビルド、レビュー、ゲート処理ができるようになりました（マイグレーション 161）。
• ツールは 78 個です。

v3.14.0 — 2026-09-18

• 調整レイヤーが稼働開始（マイグレーション 155）：tascan_create_cycle、tascan_get_cycle_report、tascan_get_build、tascan_get_build_file、tascan_post_message がリリース済みのスキーマで動作するようになりました。ビルド → 独立レビュー → 人間による1回の判断 → 統合という流れで、各ステップに署名済みレシートが付与されます。
• SMS の予約送信（マイグレーション 157）：tascan_schedule_sms（full ティア）、tascan_list_scheduled_sms（read）、tascan_cancel_scheduled_sms（full）を追加しました。TaScan 独自の5分間隔スケジューラーが、tascan_send_sms と同じ保護された経路で送信するため、TaScan 以外のものを稼働し続ける必要はありません。
• tascan_get_receipt：profile 引数（full | public）を追加しました。プロトコルページのビルド履歴用に、public プロフィールのレシートが公開されるようになりました。
• 78 個のツール。ホスト型 MCP（https://app.tascan.io/mcp）ではすでにこのバージョンが提供されています。このリリースにより、stdio パッケージも同じバージョンになりました。

v3.13.1 — 2026-09-14

• ドキュメントのみの更新です。tascan_get_task と tascan_get_receipt の説明を明確にしました。ステータスが completed の完了は、実行者が処理を返し、結果が記録されたことを意味しますが、結果が承認されたことを意味するものではありません。承認の有無は、名前付きポリシーに基づくレシートの verification.result で確認します。v0.1 ではエージェントタスクに対してポリシーが実行されない（no_policy_run）ため、エージェントの完了を成功として扱う前に、記録された応答を確認してください（プロトコル §8.3 C11）。レシートの説明には、11段階の検証処理（65,536バイトのサイズゲート、実在するカレンダー上の日付時刻、GPS の範囲、トークンを含まないロケーター、verifier.identity の語彙）も記載しています。ツールの追加はありません。引き続き70個のツールです。

v3.13.0 — 2026-09-14

• 認可スコープ。 すべてのキーと OAuth の許可に、read、write、full のいずれかのティアと、2つの追加権限が付与されるようになりました。追加権限は、PLAN／RESEARCH／WRITE／REVIEW／DEFAULT タスクを AI エージェントの受信トレイに渡す agent:dispatch と、組織独自のマシン上で実行される CODE／SHELL タスク用の agent:dispatch:code です。ツールは scopes.cjs で分類されています。許可された範囲外の呼び出しには、再接続時に必要なスコープを示す isError 結果が返されます。既存の OAuth 接続から再度ディスパッチするには、再接続し、同意ページでディスパッチのチェックボックスを選択する必要があります。
• tascan_get_receipt（新規、ツール数70個）。 1件の完了に関する、署名済みアクションレシート（Ed25519 JWS、TaScan Protocol v0.1）を取得します。実行内容、実行者、証拠ハッシュ、検証結果、台帳チェーンのヘッドをフィールドごとの出所情報とともに確認できます。https://app.tascan.io/.well-known/tascan-receipt-keys.json を使ってオフラインで、または POST /api/v1/receipts/verify を使ってオンラインで検証できます。仕様：https://app.tascan.io/docs/protocol/TASCAN-PROTOCOL-v0.1.md
• tascan_get_task は、エージェントにディスパッチされたタスクについて agent ブロック（実行試行の状態、試行回数、ランナー、トレース ID、エラー）を報告します。エージェントの失敗が表示されるのはここだけです。
• tascan_dispatch_to_agent は指示の全文をタスクの説明に保持するようになりました。緊急マーカーによってルーティングが妨げられることはなくなりました。

v3.12.0 — 2026-09-12

• tascan_send_task_email と tascan_assess_condition は呼び出し元の API キーを送信するようになりました（S99 セキュリティ監査後、背後で動作する TaScan 関数が API キーを必要とするため）。ツールの追加はありません。引き続き69個のツールです。

v3.11.0 — 2026-09-11

• すべての完了ペイロードに署名付き写真 URL を追加。 写真による証拠は AI エージェントから確認できませんでした。photo_url はホストもトークンもない、プライベートバケットのパスだけでした。完了情報を返すすべての読み取りパスで、photo_signed_url も返すようになりました（有効期間は短く、デフォルトは 1 時間、TASCAN_PHOTO_URL_TTL で調整可能）。写真がない場合は null になります。対象：tascan_get_task（タスクとサブタスクの完了情報）、tascan_get_report（include_responses が true の場合の新しいタスクごとの photos[]。従来の写真を示すだけの [+photo] マーカーを置き換え）、tascan_list_subtasks、tascan_query_responses、tascan_list_issues／課題分析（課題と負傷の写真）、tascan_zone_compliance（PPE チェックポイントの写真）、tascan_condition_history（評価とベースラインの写真）。
• レスポンスごとにストレージの署名リクエストを 1 回にまとめて実行します（40 件のタスクリストでも、リクエストは 40 回ではなく 1 回です）。署名に失敗した場合はログに記録し、元のパスを保持したまま photo_signed_url: null にフォールバックします。ツール呼び出しが失敗することはありません。
• サーバー上の共通署名ヘルパー（photo-sign-lib）を API、Completion／Client／Project／Evidence Pack レポートで使われる写真プロキシ、およびすべての AI ビジョン取得処理で共有するようになりました。これにより、URL の構築方法に再び差異が生じることはありません。
• リモートエンドポイントの serverInfo.version は、古いハードコードされた文字列ではなく、このパッケージから取得するようになりました。

v3.10.0 — 2026-09-03

• 69 個のツール：請求書、P2P ワーカーへの支払い、AI 検証済み PPE チェックポイントを備えた危険区域、完全な RLS ロックダウン、エージェントのクレーム。

プライバシーポリシー

TaScan は、タスクの完了データ、作業者情報（氏名、電話番号、メールアドレス）、GPS 座標（同意がある場合）、およびタスク完了時にアップロードされた写真を収集・処理します。データは行レベルセキュリティポリシーが適用された Supabase に安全に保存されます。API へのアクセスは認証され、レート制限が適用されます。

プライバシーポリシー全文は、こちらをご覧ください：https://tascan.io/faq.html

データ削除の依頼やプライバシーに関するお問い合わせは、こちらまでご連絡ください：[email protected]

サポート

• メール： [email protected]
• ウェブサイト： https://tascan.io
• 課題： https://github.com/snowbikemike/tascan-mcp/issues

ライセンス

MIT ライセンス - Copyright (c) 2026 Michael Edward Love II / Love Productions LLC