mcpField
C
crontap-quickstart

crontap-quickstart

github.com/crontap云与 DevOps1938 次安装6 周前更新
代码仓库

关于 crontap-quickstart

crontap-quickstart 是用于了解和管理 Crontap 定时任务、可用性监控与心跳的 Agent 技能，面向需要选择合适资源并检查账户容量的用户。它提供 MCP 入门流程、时区查询及资源创建前的容量核对。

主要功能

  1. 01区分定时任务、监控与心跳
  2. 02查询账户用量和资源上限
  3. 03搜索可用时区名称
  4. 04按用途选择资源类型
  5. 05检查计划限制与功能标志

适用场景

  1. 01创建资源前检查账户容量
  2. 02为本地时间任务确认 IANA 时区
  3. 03根据需求选择调度、监控或心跳

MCP 相关

该技能通过 Crontap MCP 管理资源，并提供连接远程服务、查询账户用量及时区的示例。REST API 仅作为 Ultra 账户的备用方式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crontap/skills --skill crontap-quickstart

安装后在 Claude Code 中输入/crontap-quickstart确认已加载。

详细介绍

Crontap 快速入门

Crontap 提供三种相关资源：

  • 计划任务会按 cron 表达式或自然语言指定的频率发送 HTTP 请求。
  • 运行时间监控器会探测 URL 并记录其可用性。
  • 心跳会要求现有作业在运行后发送 ping。

MCP 允许当前 Agent 管理这些资源。Crontap 负责 HTTP 调度和可观测性，不负责 MCP 客户端的生命周期。

前提条件

使用所需工具前，请先检查这些工具是否可用。如果有任何工具不可用，请停止并向用户提供且仅提供以下两个选项：

  1. 在 https://mcp.crontap.com/mcp 连接 Crontap MCP。所有 Crontap 套餐均支持 MCP 访问。
  2. 配置 $CRONTAP_CLIENT_ID 和 $CRONTAP_API_KEY 以使用原始 API。原始 API 访问需要 Ultra 套餐。

在用户选择之前，不要擅自选择路径或继续操作。

  • 在 https://mcp.crontap.com/mcp 连接远程 MCP 服务，并在目标 Crontap 账户中完成 OAuth。
  • 确认预期端点、本地时区以及所需的失败信号。
  • 将端点授权值和心跳 ping URL 视为机密信息。

工作流

  1. 容量不确定时，创建资源前调用 get_account_usage。
  2. 比较 usage.combined 与 caps.combined，并检查功能标志。
  3. 出站执行选择计划任务，端点可用性选择监控器，遗漏签到选择心跳。
  4. IANA 时区不确定时，调用 list_timezones。
  5. 转交给专门的技能进行创建和验证。

MCP 示例

查看当前套餐、用量、上限、功能和套餐选项：

{
  "tool": "get_account_usage",
  "arguments": {}
}

查找可用的时区名称：

{
  "tool": "list_timezones",
  "arguments": {
    "query": "Copenhagen"
  }
}

使用返回的确切时区，例如 Europe/Copenhagen。针对本地时间的业务计划，不要用固定 UTC 时差替代。

REST 回退方案

公共 API 仅作为拥有 Ultra API 访问权限账户的回退方案。MCP 并非仅限 Ultra 套餐。

curl --fail-with-body https://api.crontap.com/v1/account \
  -H "ClientId: $CRONTAP_CLIENT_ID" \
  -H "ApiKey: $CRONTAP_API_KEY"

将这两个值保存在环境变量或机密管理器中。切勿将其放入代码仓库、Agent 对话记录、URL 或示例输出中。

安全性和套餐限制

  • Starter、Pro 和 Ultra 对计划任务、监控器和心跳使用同一个总上限。部分资源还受各自的上限和频率下限约束。
  • 将返回的账户对象视为权威信息。不要硬编码价格，也不要仅凭套餐名称推断功能。
  • 如果工具返回结构化的套餐限制错误，请按顺序展示其四个选项，并指出满足需求的最小选项。不要杜撰第五个选项，也不要隐藏适用于所有套餐的 URL。
  • 任何写入操作前，先确认目标账户。

故障排除

  • 如果 OAuth 失败，请在客户端中重新连接 MCP 服务，然后重试一次。
  • 如果时区搜索没有匹配结果，请尝试搜索城市或地区的部分名称。
  • 如果 REST 返回 API_REQUIRES_ULTRA，请改用 MCP，或让用户选择 Ultra 选项。
  • 如果出现 MAX_ITEMS_REACHED，不要原样重试同一个创建调用。

参考资料

评论

支持 Markdown