Runhooks

@runhooks/mcp

Runhooks 用の Model Context Protocol（MCP）サーバーです。信頼性の高い HTTP スケジューリングインフラストラクチャを提供します。AI エージェント（Claude Desktop、Cursor、あらゆる MCP クライアント）から、定期的な HTTP ジョブや単発の HTTP ジョブを直接スケジュールし、管理できます。

サーバーはマシン上でローカルに実行されます。MCP クライアントが npx で起動し、HTTPS 経由で Runhooks REST API と通信します。ホスト型サービスはありません。このパッケージのみで動作します。

インストール

MCP クライアントの設定に追加します。Claude Desktop の場合（claude_desktop_config.json）：

{
  "mcpServers": {
    "runhooks": {
      "command": "npx",
      "args": ["-y", "@runhooks/mcp"],
      "env": { "RUNHOOKS_API_KEY": "rh_live_..." }
    }
  }
}

まだ API キーをお持ちでない場合は、env を省略し、エージェントに provision_account ツールを一度だけ実行するよう依頼してください。これにより、すぐにアカウントが作成され（メールアドレス不要）、rh_live_... キーが返されて、~/.runhooks/mcp.json にローカル保存されます。以降はキーが自動的に再利用されるため、再起動や再度のプロビジョニングは不要で、ほかのツールもすぐに使えます。（RUNHOOKS_API_KEY の設定はマシン間で最も移植性の高い方法であり、保存済みのキーより常に優先されます。）

確認

サーバーが起動し、ツールを公開することを確認します（キーを置き換えるか、env を省略してクライアント内から provision_account を使用してください）：

RUNHOOKS_API_KEY=rh_live_... npx -y @runhooks/mcp

環境変数

変数	説明	デフォルト
RUNHOOKS_API_KEY	API キー（rh_live_...）です。省略可能です。未設定の場合、provision_account がキーをローカルに保存します。保存済みのキーより優先されます。	—
RUNHOOKS_API_URL	API のオリジンです。	https://api.runhooks.app

ツール

ツール	説明
provision_account	匿名アカウントを作成し、API キーを取得します（メールアドレス不要）。
whoami	現在のアカウントを表示します。
rotate_key	API キーをローテーションします。
create_job	スケジュール済みジョブ（cron または間隔）を作成します。
list_jobs	フィルターとページネーションを使ってジョブを一覧表示します。
get_job	ID を指定してジョブを取得します。
update_job	ジョブを更新します。
delete_job	ジョブを削除します。
pause_job / resume_job	ジョブを一時停止または再開します。
list_executions	ジョブの実行履歴を一覧表示します。
replay_execution	過去の実行を再実行します。
get_usage	プランの使用状況と上限を表示します。
list_alerts / create_alert / get_alert / update_alert / delete_alert	失敗アラート（メール、Webhook、Slack）を管理します。

リンク

• ドキュメント：https://runhooks.app/docs/mcp
• API リファレンス：https://runhooks.app/docs/api
• CLI：https://www.npmjs.com/package/@runhooks/cli

ライセンス

MIT