mcpField
C
crontap-quickstart

crontap-quickstart

github.com/crontapクラウド・DevOps1938 回インストール6 週間前に更新
リポジトリ

crontap-quickstart について

crontap-quickstartは、Crontapのスケジュール、稼働監視、ハートビートを把握・管理するエージェントスキルです。用途に合うリソースの選択やアカウント容量の確認を行うユーザー向けで、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 には、関連する次の 3 種類のリソースがあります。

  • スケジュールは、cron または平易な英語で指定した間隔で HTTP リクエストを送信します。
  • 稼働状況モニターは URL にアクセスし、可用性を記録します。
  • ハートビートは、既存のジョブが実行後に ping を送信することを想定しています。

MCP を使うと、現在のエージェントがこれらのリソースを管理できます。Crontap が管理するのは HTTP スケジューリングと可観測性であり、MCP クライアントのライフサイクルではありません。

前提条件

必須のツールを使用する前に、利用可能かどうか確認してください。ツールが不足している場合は、作業を中止し、ユーザーに次の 2 つの選択肢だけを提示してください。

  1. https://mcp.crontap.com/mcp で Crontap MCP に接続します。MCP は Crontap のすべてのプランで利用できます。
  2. 生の API を利用するには、$CRONTAP_CLIENT_ID と $CRONTAP_API_KEY を設定します。生の 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"

どちらの値も環境変数またはシークレットマネージャーに保管してください。リポジトリ、エージェントのトランスクリプト、URL、出力例には絶対に記載しないでください。

安全性とプランの上限

  • Starter、Pro、Ultra では、スケジュール、モニター、ハートビートに共通の上限が適用されます。また、リソースごとの上限や実行間隔の下限が適用される場合もあります。
  • 返されたアカウントオブジェクトを信頼できる情報源として扱います。料金をハードコードしたり、プラン名から機能を推測したりしないでください。
  • ツールが構造化されたプラン上限エラーを返した場合は、提示された順序どおりに 4 つの選択肢を示し、実行可能な最小の選択肢を明示してください。5 つ目の選択肢をでっち上げたり、すべてのプランを確認できる URL を隠したりしないでください。
  • 書き込み操作の前に、対象のアカウントを確認してください。

トラブルシューティング

  • OAuth に失敗した場合は、クライアントで MCP サーバーに再接続し、一度だけ再試行します。
  • タイムゾーン検索で一致するものが見つからない場合は、都市名または地域名の一部で検索します。
  • REST が API_REQUIRES_ULTRA を返した場合は、MCP を利用するか、Ultra の選択肢を選ぶかをユーザーに委ねます。
  • MAX_ITEMS_REACHED が表示された場合は、同じ内容で作成呼び出しを再試行しないでください。

参考資料

コメント

Markdown 対応