Sequentum MCP

Sequentum MCP

Sequentum MCP 服务通过模型上下文协议（MCP）将你的 AI 编码助手连接到 Sequentum，使 AI 工具能够创建网页抓取 Agent、运行管理、安排计划、分析等。Sequentum 托管并管理带有 OAuth 身份验证的远程 MCP 服务，因此无需安装任何内容。

工具参考 | 提示词参考 | 资源参考 | 故障排除 | 更新日志

主要功能

• Agent 管理：构建、列出、搜索网页抓取 Agent，并获取其详细信息。
• 运行自动化：启动、停止和监控 Agent 执行，并实时跟踪状态。
• 计划管理：使用 cron 表达式创建和管理自动计划。
• 分析与诊断：获取运行统计信息、错误分析以及针对故障的修复建议。
• 空间组织：管理 Agent 工作区，并在多个空间中执行批量操作。

免责声明

sequentum-mcp 会向 MCP 客户端开放你的 Sequentum 账户数据，使其能够 查看、运行和管理你的网页抓取 Agent。请妥善保管凭据，避免分享你不希望 MCP 客户端访问的敏感信息。

入门

使用以下配置将 Sequentum MCP 服务添加到你的客户端：

{
  "mcpServers": {
    "sequentum": {
      "url": "https://mcp.sequentum.com/mcp"
    }
  }
}

大多数客户端都支持 OAuth 配置。 Claude.ai 和 Claude Desktop 的设置更简单——Sequentum MCP 已列入 Claude 的连接器目录，因此无需手动输入任何内容；请参阅下文的 Claude.ai 和 Claude Desktop。对于其他客户端，首次连接时，系统会提示你：

1. 使用 Sequentum 账户登录
2. 接受 OAuth 授权
3. 授予必要权限

完成身份验证后，所有工具都会在你的客户端中启用。有关客户端专属设置的详细信息，请参阅下文的设置客户端。

设置客户端

选择下方的客户端，查看相应的设置说明。除非另有说明，所有客户端都使用 https://mcp.sequentum.com/mcp 上的远程 OAuth 服务。

Cursor

前往 Cursor > Settings > Cursor Settings > MCP，并按照提示添加 Sequentum MCP 服务。Cursor 1.0+ 原生支持 OAuth 和 Streamable HTTP。

你也可以使用上述配置手动编辑 mcp.json 文件来添加服务。

Claude.ai 和 Claude Desktop

Sequentum MCP 已列入 Claude 的连接器目录，因此无需手动输入 URL，也无需创建自定义连接器。

1. 打开 Settings，然后前往 Connectors。
2. 浏览 Directory，选择 Connectors，并找到 Sequentum MCP。
3. 点击 Connect，然后使用 Sequentum 账户登录。

Team 和 Enterprise 工作区：连接器是否可用由组织级别控制，因此管理员可能需要先启用 Sequentum MCP，成员才能使用自己的账户连接。

**按对话启用：**连接后，可在单个对话中启用 Sequentum：点击消息输入框旁的 + 按钮，然后选择 Connectors。

ChatGPT

注意： Sequentum 应用正在等待目录审核期间，你可以通过开发者模式进行连接。Plus、Pro、Business、Enterprise 和 Education 方案目前可使用“应用和连接器”→“开发者模式”（Education 仅限网页版）。在 Business / Enterprise / Education 账户中，只有工作区所有者和管理员可以访问高级设置——普通成员看不到该选项。有关当前适用条件，请参阅 OpenAI 的开发者模式文档。

1. 在 ChatGPT 中，前往设置 > 应用和连接器 > 高级设置，并启用开发者模式。
2. 前往设置 > 应用和连接器，然后点击创建应用（启用开发者模式后，此选项才会显示）。
3. 输入连接器名称 Sequentum 和 URL：https://mcp.sequentum.com/mcp
4. 点击创建。系统会提示你通过 OAuth 使用 Sequentum 账户登录。

连接后，在对话中点击消息输入框旁边的 + 按钮启用 Sequentum，然后从列表中选择你的连接器。

Claude Code

从连接器目录连接一次 Sequentum MCP（参见上文 Claude.ai 和 Claude Desktop），之后便可在同一账户的 Claude Code 中使用。

也可以直接添加——这适用于按项目配置或在脚本中使用：

claude mcp add --transport http sequentum https://mcp.sequentum.com/mcp

然后使用 claude 启动 Claude Code，并输入 /mcp 以触发 OAuth 浏览器流程。

VS Code / GitHub Copilot

使用 Ctrl+Shift+P（macOS 上使用 Cmd+Shift+P）打开命令面板，然后选择 MCP: Add Server。输入 Sequentum MCP 服务 URL：

https://mcp.sequentum.com/mcp

Windsurf

通过 Cascade 中的 Configure MCP 选项进行配置（Cmd+L 或 Ctrl+L）。添加 Sequentum MCP 服务 URL：

https://mcp.sequentum.com/mcp

其他客户端

Sequentum MCP Server 遵循标准 MCP 协议，适用于任何支持以下功能的客户端：

• OAuth 身份验证（推荐）
• 支持自动回退到 SSE 的 Streamable HTTP

在客户端的 MCP 配置中使用服务 URL https://mcp.sequentum.com/mcp。

该服务支持 客户端 ID 元数据文档（CIMD）作为首选的客户端标识方法，并以 动态客户端注册（RFC 7591）作为回退方案。支持 CIMD 的 MCP 客户端（例如 Cursor）可以直接使用自己的 URL 作为 client_id，无需事先注册。

本地 stdio 模式（已移除）

使用 SEQUENTUM_API_KEY 通过 stdio 在本地运行服务（npx sequentum-mcp）的方式已在 3.0.0 中移除。 请改为连接 https://mcp.sequentum.com/mcp——参见设置客户端。Sequentum API 密钥仍可用于 REST API。

使用示例

连接后，试试这些提示词，开始在 AI 助手中使用 Sequentum 上下文：

What agents ran yesterday?
Run agent <agent name> now.
Is agent <agent name> still running?
What agents are scheduled to run today?
Download the extracted data from agent <agent name>.
How many records were found the last time <agent name> was run?
What is my current balance?
Which agents cost the most this month?
Schedule agent <agent name> to run every Monday at 9am.
Look at the run log for <agent name> run at 9:22am. What caused the agent to fail?
Show me the cost breakdown for agent <agent name> in January.
What were the most expensive runs for agent <agent name>?
How much did I spend on server time vs exports last week?

可用工具

Sequentum MCP 服务提供 43 个工具，分为 9 个类别，可用于与 Sequentum 平台交互。详细文档请参阅工具参考。

• Agent 管理（5 个工具）
  • list_agents
  • get_agent
  • search_agents
  • get_agent_search_count
  • get_personal_agent_count
• 运行管理（7 个工具）
  • get_agent_runs
  • get_agent_run_summary
  • get_run_status
  • start_agent
  • stop_agent
  • kill_agent
  • delete_run
• 文件管理（2 个工具）
  • get_run_files
  • get_file_download_url
• 版本管理（2 个工具）
  • get_agent_versions
  • restore_agent_version
• 计划管理（8 个工具）
  • list_agent_schedules
  • get_agent_schedule
  • create_agent_schedule
  • update_agent_schedule
  • enable_agent_schedule
  • disable_agent_schedule
  • delete_agent_schedule
  • get_scheduled_runs
• 账单与点数（6 个工具）
  • get_credits_balance
  • get_spending_summary
  • get_credit_history
  • get_agents_usage
  • get_agent_cost_breakdown
  • get_agent_runs_cost
• 空间管理（6 个工具）
  • list_spaces
  • get_space
  • get_space_agents
  • get_space_agent_count
  • search_space_by_name
  • run_space_agents
• 分析与诊断（4 个工具）
  • get_runs_summary
  • get_records_summary
  • get_run_diagnostics
  • get_latest_failure
• Agent 构建器（3 个工具）
  • start_agent_build
  • get_agent_build_status
  • stop_agent_build

结构化输出

43 个工具中有 36 个声明了 outputSchema，并会在通常的文本块旁返回 structuredContent（MCP 2026-07-28）。文本块保持不变，因此忽略结构化内容的客户端不会看到任何区别。仅返回确认信息的 7 个工具（stop_agent、kill_agent、delete_run、restore_agent_version、delete_agent_schedule、enable_agent_schedule、disable_agent_schedule）仅返回文本。

• start_agent 在异步模式下返回 { "run": … }，在同步模式下返回 { "data": … }。
• 返回列表的工具（list_spaces、get_space_agents、list_agent_schedules、get_scheduled_runs、get_agent_versions、get_run_files）使用数组架构。使用 2025 协议修订版的客户端会收到 { "result": [...] } 格式的包装结果，与 SDK 映射的格式一致。
• 类似状态的字段是数字代码，其含义见各自架构的说明。

可用提示词

该服务包含 9 个可复用的提示词模板，用于引导 AI 完成常见的多步骤工作流。详细文档请参阅提示词参考。

• 调试与诊断
  • debug-agent -- 诊断 Agent 运行失败的原因
  • compare-runs -- 比较最近一次成功运行与失败运行
• 健康状态与监控
  • agent-health-check -- 全面查看 Agent 的健康状况
  • daily-operations-report -- 汇总所有 Agent 的每日运维报告
  • space-overview -- 概览一个空间中的所有 Agent
• 执行
  • run-and-monitor -- 启动 Agent 并持续监控，直到运行完成
  • schedule-agent -- 引导完成创建计划任务的流程
• 账单与费用
  • spending-report -- 支出与额度报告
  • cost-analysis -- 分析各 Agent 的费用
• Agent 构建
  • build-agent-from-prompt -- 根据自然语言描述构建新的 Agent
  • inspect-agent-draft -- 检查构建会话，并决定保存还是丢弃

可用资源

该服务提供 18 个只读资源（7 个静态资源 + 11 个模板），AI 客户端可以浏览这些资源并将其加载到上下文中。详细文档请参阅资源参考。

• 静态资源（7 个）
  • sequentum://agents -- 所有 Agent 的第一页
  • sequentum://spaces -- 所有可访问的空间
  • sequentum://billing/balance -- 当前积分余额
  • sequentum://billing/spending -- 月度支出摘要
  • sequentum://billing/agents-usage -- 按成本排名的 Agent
  • sequentum://analytics/runs -- 过去 24 小时内的运行记录
  • sequentum://analytics/upcoming-schedules -- 未来 7 天的计划运行
• 资源模板（11 个）
  • sequentum://agents/{agentId} -- Agent 详情及其配置
  • sequentum://agents/{agentId}/versions -- Agent 版本历史
  • sequentum://agents/{agentId}/schedules -- Agent 计划任务
  • sequentum://agents/{agentId}/cost-breakdown -- 按使用类型划分的 Agent 成本
  • sequentum://agents/{agentId}/runs -- Agent 运行历史
  • sequentum://agents/{agentId}/runs/{runId} -- 特定运行的状态
  • sequentum://agents/{agentId}/runs/{runId}/files -- 运行输出文件
  • sequentum://agents/{agentId}/runs/{runId}/diagnostics -- 运行错误诊断信息
  • sequentum://agents/{agentId}/latest-failure -- 最近一次失败的诊断信息
  • sequentum://spaces/{spaceId} -- 空间详情
  • sequentum://spaces/{spaceId}/agents -- 空间中的 Agent

故障排除

端到端验证范围强制执行

pnpm run probe --env qa --mode log-only 会针对 QA 执行真实的 OAuth 流程（浏览器登录和授权、环回回调、PKCE），然后直接调用 V1 API，并通过此服务使用三种范围配置的令牌进行调用，同时检查 CloudWatch 中 Control Center 的范围检查日志行。请参阅 docs/oauth-scope-probe.md。

错误	解决方案
OAuth 登录页面未打开	确保客户端支持 OAuth 和 Streamable HTTP。尝试重启客户端。对于 Claude.ai 和 Claude Desktop，请从连接器目录进行连接，而不是使用配置文件。
连接被拒绝	确认 URL 为 https://mcp.sequentum.com/mcp，并检查网络连接。
API Error 401: Unauthorized	OAuth 会话无效或已撤销。断开并重新连接 Sequentum MCP 服务，以再次登录。
要求重新授权，或显示 Insufficient Scope: This action requires the "…" scope	此连接未获授工具所需的权限。服务器会对这类调用返回 HTTP 403 insufficient_scope 挑战，并指出所需范围；支持权限逐步提升的客户端会要求你批准这些权限。否则，如果看到 Insufficient Scope 消息，请断开并重新连接 Sequentum MCP 服务，然后批准所请求的权限。如果刚重新连接就再次出现此问题，客户端可能缓存了过期的范围列表——请检查连接器的 OAuth 设置。
API Error 404: Not Found	Agent、运行或文件不存在，或者你无权访问。
API Error 429: Too Many Requests	已超出速率限制。请稍等片刻后重试。

如需更多故障排除帮助，请参阅故障排除指南。

HTTP 模式配置

托管服务 mcp.sequentum.com 使用 Streamable HTTP 传输，这是 3.0.0 版本起唯一的传输方式，并采用独立的部署配置。以下环境变量用于调整该传输方式的缓存、速率限制和代理信任设置。本文档面向阅读此源代码的读者——不支持自托管部署，也未发布容器镜像。

自 2.0.0 版本起，HTTP 模式为无状态模式。 没有 Mcp-Session-Id 标头，服务器也不保存任何客户端会话状态：每个请求都由一个全新的 MCP 服务实例独立处理。GET /mcp 不再打开 SSE 流——现在会返回 405 Method Not Allowed（如果请求未经身份验证，则会先返回 401）。DELETE /mcp 是空操作，始终返回 200，因为已没有需要清理的会话。服务器不再读取 MAX_SESSIONS。

变量	默认值	描述
PORT	3000	HTTP 服务端口。
SEQUENTUM_API_URL	https://dashboard.sequentum.com	此服务代理到的 Sequentum API 基础 URL。
SEQUENTUM_OAUTH_ISSUER	SEQUENTUM_API_URL 的值	此部署的 OAuth 颁发者标识符，发布在 /.well-known/oauth-protected-resource 中。必须是绝对 https URL，且不能包含查询、片段或用户信息，并且必须与授权服务器的 issuer 完全一致。仅当 API 基础 URL 与公开的 OAuth 颁发者不同时才设置此变量；值格式错误会导致服务拒绝启动。
MCP_CANONICAL_ORIGIN	根据请求的 Host 标头推导	此服务的资源标识符，用于检查传入 OAuth 令牌的 aud 声明。将其设置为公开源，例如 https://mcp.sequentum.com。只使用源——该值会通过 new URL(...).origin 规范化，因此末尾斜杠或路径不会造成影响，并且接受 aud 中指向此源上任意路径的值。未设置此变量，或设置的值无法由 new URL 解析时，服务会在启动时警告一次，并回退到调用方提供的 Host。来自其他源的 aud 会记录日志，但不会被拒绝。
HOST	0.0.0.0	HTTP 服务绑定地址。
LIST_CACHE_TTL_MS	3600000（1 小时）	附加到可缓存列表类结果（tools/list、prompts/list、resources/list、resources/templates/list、server/discover）上的新鲜度提示（ttlMs）。必须是非负整数字符串；值格式错误会导致服务在启动时立即失败，而不是静默截断。
MCP_RATE_LIMIT_WINDOW_MS	60000（1 分钟）	应用于 /mcp 端点的速率限制窗口。
MCP_RATE_LIMIT_MAX	100	每个进程、每个 IP 在每个窗口内允许的 /mcp 请求数上限。水平扩展前，请参阅下文“跨副本的速率限制”。
TRUST_PROXY	true	传递给 Express 的 trust proxy 设置。接受 true、false、跳数（例如 1）或以逗号分隔的 CIDR/IP 允许列表。请参阅下文“TRUST_PROXY 与速率限制规避”——默认设置存在已知弱点。
REQUIRE_AUTH	true	设置为 false 可绕过 /mcp 上的 OAuth Bearer 令牌要求。仅用于本地测试：连接会成功，但没有有效的后端令牌时，工具仍会失败。

跨副本的速率限制

速率限制器按进程运行，并以 req.ip 为键；它不会在副本之间共享状态。无状态传输不需要会话亲和性，因此特定客户端的请求不会固定到某个副本——在负载均衡器后有 N 个副本的水平扩展部署中，整个集群的有效上限会变为每个窗口 N × MCP_RATE_LIMIT_MAX，而不是 MCP_RATE_LIMIT_MAX。如需保持特定的全局速率，请将 MCP_RATE_LIMIT_MAX 除以副本数量。

TRUST_PROXY 和速率限制规避

默认设置 TRUST_PROXY=true 时，Express 会信任所有代理跳点，并从客户端提供的 X-Forwarded-For 标头中最左侧的条目解析 req.ip。 由于速率限制器以 req.ip 为键，客户端只需轮换该标头值，就能完全规避速率限制。仅在反向代理后运行并不能解决问题：cloudflared 和 ngrok 等隧道会追加到 X-Forwarded-For，而不会覆盖它，因此除非正确配置 TRUST_PROXY，攻击者控制的最左侧条目仍会保留。

解决方法是将 TRUST_PROXY 设置为服务器前方受信任的反向代理跳点的准确数量（例如 1），或者设置为受信任代理的逗号分隔 CIDR/IP 允许列表，以便 Express 从正确的跳点解析 req.ip，而不是信任客户端提供的标头。本仓库不了解你的部署拓扑，因此不会擅自为你选择更安全的默认值。

**严重程度：**这是对滥用/DoS 防护的绕过，不是身份验证或数据泄露问题——不会暴露任何账户数据，也不会使原本会被拒绝的工具调用成功。它只能让客户端规避速率限制。

CORS Origin 允许列表

从浏览器访问 MCP 服务时（例如通过 Claude 网页应用或 ChatGPT 连接器），服务会将 Origin 标头与允许列表进行比对。默认情况下，允许以下来源：

• https://claude.ai、https://claude.com 及其所有子域名（例如 team.claude.ai）
• https://chatgpt.com、https://platform.openai.com，以及 chatgpt.com 下的所有子域名（例如 connector.chatgpt.com）
• https://glama.ai 及其所有子域名（用于 Glama 基于浏览器的 MCP 检查器）
• https://dashboard.sequentum.com
• https://mcp.sequentum.com
• 当 DEBUG=1 时，允许 http://localhost:<port>、http://127.0.0.1:<port> 和 http://[::1]:<port>

若要添加自己的来源（例如内部仪表板），请将 ALLOWED_ORIGINS 环境变量设为由逗号分隔的精确来源列表：

ALLOWED_ORIGINS="https://my-dashboard.example.com,https://other.example.com"

这些来源会在默认来源的基础上追加，不会影响 Claude、ChatGPT 和 Sequentum 的访问。环境变量不支持通配符和正则表达式；如需子域名通配符，请直接在 src/server/cors.ts 中添加 RegExp 条目。

注意：Origin 匹配区分大小写，且不包含路径或查询字符串。原生 MCP 客户端（Cursor、Claude Desktop、Claude Code）不会发送 Origin 标头，因此不会受此允许列表影响。

开发

本仓库使用 pnpm，而非 npm。出于特意设置，npm install 会被拒绝。 你需要使用 Node 22 或更高版本（.nvmrc 指定了 24，Docker 镜像也使用该版本）。Corepack 会安装 package.json 中指定的 pnpm 版本。Node 22 和 24 自带 Corepack；在 Node 25 或更高版本上，请先通过 npm install -g corepack 安装：

corepack enable
pnpm install
pnpm test
pnpm run build

除非某个依赖包列在 pnpm-workspace.yaml 的 allowBuilds 下，否则 pnpm 不会运行任何依赖安装脚本。如果更改依赖后，pnpm install 报告有被忽略的构建脚本，请在该文件中添加相应依赖包：如果运行所需脚本才能正常工作，则设为 true，否则设为 false。

参数直接放在脚本名称之后，无需使用 npm 的 --（pnpm run probe --env qa --mode log-only）。pnpm 会将 -- 传递给脚本。

隐私政策

Sequentum MCP 服务仅为响应您通过 AI 助手提出的请求而访问您的 Sequentum 账户数据，包括 Agent 元数据、运行历史、计划任务、账单信息和输出文件。默认情况下，MCP 服务充当 MCP 客户端与 Sequentum API 之间经过身份验证的代理：请求数据会转发至 API，响应则返回给您的客户端，不会被持久化或与第三方共享。

运营者可以通过 DEBUG=1 环境变量启用详细请求日志，以便排查问题。在此模式下，服务会对 Authorization、Cookie 和 x-api-key 标头进行脱敏处理，但会将请求正文（其中可能包含工具参数）写入 stderr。托管于 mcp.sequentum.com 的服务不会以 DEBUG=1 运行。

如需查看 Sequentum 完整隐私政策，请访问 https://www.sequentum.com/privacy-policy。

链接

• Sequentum MCP 服务
• Sequentum 控制面板
• Sequentum API 文档
• 模型上下文协议

许可证

MIT © Sequentum