TaScan

TaScan MCP 服务

面向 TaScan 的 AI Agent 集成——这是一种闭环自主运营协议。通过 Claude、GitHub Copilot 或任何兼容 MCP 的 AI 客户端，管理项目、事件、任务、工作人员、二维码、模板、完成报告，以及由 AI 驱动的问题解决流程。

任务。扫描。完成。

什么是 TaScan？

TaScan 是一个无需下载即可使用的任务分配与验证平台，面向现实世界的工作。工作人员扫描二维码、通过照片验证完成任务，管理者则可实时获取完成报告——无需下载应用、登录或培训。

发生故障时，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 密钥（在管理门户 > 团队 > API 密钥中生成）
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	删除任务及其完成记录	删除

Workers

工具	描述	类型
tascan_list_workers	列出组织中的所有工作人员	Read
tascan_create_worker	创建新的工作人员档案	Create
tascan_update_worker	更新工作人员姓名、电话和电子邮件	Update

Operations

工具	描述	类型
tascan_generate_qr	为活动生成二维码	Create
tascan_apply_template	将预构建的模板应用于活动	Create
tascan_list_templates	列出可用的任务模板	Read
tascan_get_report	获取活动的完成报告（可选的 include_responses 会返回已提交的响应数据，以及每项任务的 photos[] 列表，其中包含 { path, signed_url, completed_at, worker_name }）	Read
tascan_generate_report	创建可分享的完成报告 / 服务报告（带客户品牌、可确认）/ 项目报告 / 证据包链接；还可选择发送短信	Write
tascan_list_reports	列出某个清单或项目的现有报告链接及确认状态	Read
tascan_invite_worker	向市场中的工作人员发送征得同意的引荐：TaScan 会向其发送短信，回复 YES 会将其添加到你的组织并发送清单，回复 NO 则保留其匿名身份	Write
tascan_list_invites	列出你的市场邀请及其状态；已接受的邀请会附带工作人员的联系方式	Read
tascan_zone_compliance	危险区域审计：交叉比对区域穿越记录、AI 验证的 PPE 检查点判定、违规事件和受伤事件（并与最近一次 PPE 检查记录交叉比对；区域现在包含 kind、required_ppe、task_list_on_enter 和工作人员短信规则）	Read
tascan_create_invoice	根据明确的明细项或经验证的工作（项目 / 清单 × 小时费率或固定费率）创建客户发票；返回分享链接，单清单发票还会关联一份客户服务报告	Write
tascan_list_invoices	列出发票及其状态、总额、到期日、链接和未结余额	Read
tascan_update_invoice	将发票标记为已支付 / 逾期 / 已取消，编辑客户信息、备注和到期日	Write
tascan_query_responses	查询项目中所有清单里某项任务的响应，形成按时间顺序排列的进展序列	Read

闭环自主运营（专利申请中）

工具	描述	类型
tascan_list_issues	列出现场报告的问题，可按状态、类别和严重程度筛选	Read
tascan_analyze_issue	AI 对问题严重程度进行分类、识别根本原因并评估紧急程度	AI
tascan_recommend_fix	AI 生成按优先级排序的整改任务，并提供分步说明	AI
tascan_auto_resolve	通过一次调用实现完整闭环——输入问题，AI 进行分析、派发整改任务并闭环	AI

Communications

工具	描述	类型
tascan_dispatch_instruction	通过多种渠道向工作人员发送指示（短信、电子邮件、二维码）	Create
tascan_send_task_email	通过电子邮件发送任务链接和通知	Create
tascan_complete_task	将任务标记为已完成，可选择附带响应数据	Update

AI Agent 协调（专利 #10）

工具	描述	类型
tascan_list_agents	列出系统中已注册的 AI Agent	Read
tascan_register_agent	注册具有相应能力的新 AI Agent	Create
tascan_dispatch_to_agent	将任务分配给指定的 AI Agent 执行	Create

使用示例

示例 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 密钥仅适用于你的组织，并支持速率限制（每分钟 60 个请求）。

故障排除

“连接失败”或 OAuth 重定向问题

• 确认你使用的是正确的 URL：https://app.tascan.io/mcp
• 清除浏览器缓存，然后尝试重新连接
• 如果使用 Claude Desktop，请在添加连接器后重启应用

本地 npm 安装出现“未授权”或 401 错误

• 在 Admin Portal > Team > API Keys 中重新生成 API 密钥
• 确认已在环境中设置 TASCAN_API_KEY（而不只是设置在配置文件中）
• 密钥仅适用于所属组织——请确保使用的是正确组织的密钥

Claude 中未显示工具

• 断开 TaScan 连接器，然后重新连接
• 对于 Claude Code：运行 claude mcp list，确认服务已注册
• 检查你的 TaScan 账号是否已加入一个活跃组织（免费层级即可）

出现“速率受限”错误

• 默认限制为每个 API 密钥每分钟 60 个请求
• Pro 和 Business 层级的限制更高
• 批量操作（例如 tascan_add_tasks）比单独调用更高效

未显示任务完成情况

• 工作人员必须通过任务链接提交（扫描二维码或访问直接 URL）
• 在照片上传完成前，必须上传照片的任务不会显示为已完成
• 检查事件的响应模式（单次响应或多次响应）

照片证据链接

• photo_url 是原始存储对象路径（稳定不变）。photo_signed_url 是可获取的 HTTPS 链接，约 1 小时后过期（服务端默认值为 TASCAN_PHOTO_URL_TTL=3600）。重新运行读取工具以获取新链接；切勿保存签名 URL。
• photo_signed_url: null 且 photo_url 非空，表示读取时无法生成签名（存储暂时异常）。读取仍会成功——重试以获取链接。

更新日志

v3.15.0 — 2026-09-19

• tascan_create_cycle 新增可选的 reviews[] 数组——多视角评审面板（设计项 14a）：包含 1–8 个视角，每个视角格式为 {lens, brief, provider: openai|anthropic|gemini, model?, blocking? (default true), max_tool_calls? (openai only)}，并转发至 POST /coord/cycles；至少一个视角必须为阻塞式。若要进行单次 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 现在基于已发布的架构运行——构建 → 独立审查 → 一次人工决策 → 集成，每一步都有签名回执。
• 定时 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-profile 回执，供协议页面展示构建记录。
• 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 中，Agent 任务不会运行任何策略（no_policy_run），因此在将 Agent 任务完成视为成功前，请先阅读已记录的响应（协议 §8.3 C11）。回执说明还列出了 11 步验证器（65,536 字节大小限制、真实日历日期时间、GPS 范围、无令牌定位符、verifier.identity 词汇）。没有新增工具——仍为 70 个工具。

v3.13.0 — 2026-09-14

• 授权范围。 每个密钥和 OAuth 授权现在都带有一个层级——read、write 或 full——以及两项附加权限：agent:dispatch（将 PLAN/RESEARCH/WRITE/REVIEW/DEFAULT 任务交给 AI Agent 收件箱）和 agent:dispatch:code（CODE/SHELL 任务，这些任务在组织自己的机器上运行）。工具在 scopes.cjs 中分类；超出授权范围的调用会返回 isError 结果，并指出需要重新连接时使用的范围。现有 OAuth 连接必须重新连接，并在同意页面勾选派发选项，才能再次派发任务。
• tascan_get_receipt（新增，共 70 个工具）。 获取某项完成记录的签名操作回执（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 的任务报告一个 agent 区块（执行尝试信息：状态、尝试次数、运行器、跟踪 ID、错误）——这是显示 Agent 失败情况的唯一位置。
• tascan_dispatch_to_agent 会在任务描述中保留完整指令；紧急标记不再导致路由中断。

v3.12.0 — 2026-09-12

• tascan_send_task_email 和 tascan_assess_condition 现在会发送调用方的 API 密钥（S99 安全审查后，其背后的 TaScan 函数要求提供该密钥）。没有新增工具——仍为 69 个工具。

v3.11.0 — 2026-09-11

• 每个完成记录载荷都包含已签名的照片 URL。 AI Agent 无法查看照片证据：photo_url 只是一个不带主机名或令牌的私有存储桶路径。现在，所有返回完成记录的读取路径都会同时返回 photo_signed_url（有效期较短，默认 1h，可通过 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（评估和基准照片）。
• 每个响应只进行一次批量存储签名调用（包含 40 个任务的列表只会发送一个请求，而非 40 个）。签名失败时会记录日志，并降级为 photo_signed_url: null，同时保留原始路径；工具调用不会失败。
• 服务器上的单一共享签名辅助程序（photo-sign-lib）现在为 API、完成情况 / 客户 / 项目 / 证据包报告使用的照片代理，以及所有 AI 视觉获取器提供支持，避免 URL 构造再次出现偏差。
• 远程端点的 serverInfo.version 现在从此软件包读取，不再使用过时的硬编码字符串。

v3.10.0 — 2026-09-03

• 69 个工具：发票、P2P 工人付款、带 AI 验证 PPE 检查点的危险区域、完整的 RLS 锁定、Agent 申领。

隐私政策

TaScan 会收集和处理任务完成数据、工人信息（姓名、电话、电子邮件）、GPS 坐标（经同意后）以及任务完成期间上传的照片。数据通过行级安全策略安全地存储在 Supabase 中。API 访问需要身份验证，并受速率限制。

如需查看完整隐私政策，请访问：https://tascan.io/faq.html

如需申请删除数据或咨询隐私问题，请联系：[email protected]

支持

• 电子邮件： [email protected]
• 网站： https://tascan.io
• 问题： https://github.com/snowbikemike/tascan-mcp/issues

许可证

MIT 许可证 - 版权所有 (c) 2026 Michael Edward Love II / Love Productions LLC