time

Clockchain 開発者向けツール

Clockchain のツール（コンセンサス時刻、ノータリゼーション、スマートコントラクトのスケジューリング、監査証跡、エージェントの ID 検証）を、あらゆる MCP クライアント（Claude Code、Cursor、Claude Desktop、Codex、Hermes、OpenClaw、…）やターミナルで使えるようにする CLI と MCP サーバーです。稼働中の D4 ノードゲートウェイ node.clockchain.network をラップしており、ブロックチェーンのプロトコルは変更しません。

最速の方法 — アカウント不要、ワンコマンドで検証済み時刻のアラームを設定（エージェントと人間向け）：

curl -fsSL https://raw.githubusercontent.com/thetangstr/clockchain-developer-tools/main/packages/clock-sdk/examples/try-alarm-mcp.sh | bash

（jq が必要です。無料のデモトークンを発行します。登録は不要です — アラームを記録し、ホスト済み MCP を通じてキー不要で検証します。） 無人実行も安全です： アカウント、API キー、シークレットは不要です — 共有デモアカウントのログクレジットを 1 つだけ消費します（あなたのものは何も消費しません）。エージェントは承認なしで直接実行できます。通常の実行時間は約 30 秒（アラームの待機時間）です。短縮するには CC_WAIT_S=5 を設定してください。

MCP クライアントにインストールする： INSTALL.md — ホスト済みエンドポイント（あらゆるクライアントに対応。推奨）またはセルフホスト（ローカル stdio）。 エンジニア以外の方へ：約 10 分で試す： TRY-IT.md · エンジニア向け： QUICKSTART.md エージェント向け：プレイブックを読み込む： skills/clockchain-verified-alarm/SKILL.md — 検証済み時刻に関する不変条件を把握し、最初から正しくツールを使えます。 ロードマップと現在の制限事項： roadmap.md

クイックインストール — ホスト済みエンドポイント（あらゆる MCP クライアントに対応）

あらゆる MCP クライアント（Claude Code、Cursor、Claude Desktop、Codex、Hermes、OpenClaw）で動作します。テストネットの トークン（x-api-key）はすぐに取得できます — curl -X POST https://mcp.clockchain.network/token（登録不要）— その後、クライアントの MCP 設定に以下を追加します。

{
  "mcpServers": {
    "clockchain": {
      "type": "http",
      "url": "https://mcp.clockchain.network/mcp",
      "headers": { "x-api-key": "<YOUR_TOKEN>" }
    }
  }
}

認証情報不要のアラームデモ（アカウント不要、ビルド不要 — jq が必要です）：curl -fsSL https://raw.githubusercontent.com/thetangstr/clockchain-developer-tools/main/packages/clock-sdk/examples/try-alarm-mcp.sh | bash

mcp add コマンドを使った CLI（Claude Code の例）：

claude mcp add clockchain --transport http https://mcp.clockchain.network/mcp \
  --header "x-api-key: <YOUR_TOKEN>"

次に /mcp（またはクライアントの同等のコマンド）を実行し、clockchain（50 個のツール）が接続されていることを確認してから、*「clockchain を使って現在のコンセンサス時刻を取得してください。」*と尋ねます。セルフホスト（ローカル stdio）、BYOK、およびチャットコネクターの設定については、INSTALL.md を参照してください。

インストールせずにエージェントに接続を依頼する

セットアップするマシンがありませんか？MCP に対応したエージェント（Claude Code、Cursor、Codex、Hermes、OpenClaw、Claude Desktop）に以下のプロンプトを渡してください — サーバーはすでにホストされているため、クローンやビルドは不要です。

Clockchain MCP サーバーを使いたいです。サーバーはすでにホストされているため、リポジトリをクローンしたりビルドしたりしないでください — HTTP 経由でリモートサーバーに接続するだけです。次の設定で clockchain という名前の MCP サーバーを追加してください（私のトークンに置き換えてください）。

{ "mcpServers": { "clockchain": { "type": "http", "url": "https://mcp.clockchain.network/mcp", "headers": { "x-api-key": "<YOUR_TOKEN>" } } } }

次に、MCP サーバーの一覧を表示して clockchain が接続されていることを確認し、get_time ツールを呼び出して現在の Clockchain コンセンサス時刻を教えてください。

ユーザーごとのトークンについては、チームに問い合わせてください。Clockchain のキーはサーバー上に保持されます。同じホスト済みエンドポイント（https://mcp.clockchain.network/mcp）を、あらゆる MCP クライアントから利用できます。チャットコネクタークライアント（claude.ai chat、Cowork）は異なります — INSTALL.md を参照してください。

利用できる機能

7 つのモジュールにまたがる 50 個のツール：

• 時刻： get_time、get_timestamp、get_block、get_validation。
• ログ記録（公証）： log_action、get_log_entry、search_actions、 verify_asset。
• 検証済み時刻ツール（登録不要で60秒以内にお試しいただけます：curl -fsSL https://raw.githubusercontent.com/thetangstr/clockchain-developer-tools/main/packages/clock-sdk/examples/try-clock-tools-mcp.sh | bash）：stopwatch_start、stopwatch_stop、stopwatch_verify — 2つのアンカーマーカー間の経過時間を改ざん検知可能な形で記録します。stopwatch_verify は、2つの不変ブロック時刻から所要時間を秘密鍵なしで再計算します。 timer_set、alarm_set、timer_status、timer_cancel、timer_list — 合意時刻に基づくホスト型 ワンショットタイマー（および繰り返しアラーム）で、クライアントがオフラインでも作動します。作動とそのレシートを timer_status でポーリングするか、許可リストに登録されたホストの webhook_url を指定して、署名付きのDNSピン留め済みPOSTを受け取れます（登録時にオーナーごとの検証シークレットが返されます）。 レシートにはアンカーの保存先（attestation.substrate）が記載されます。 同じプリミティブは @clockchain/clock-sdk を使ってクライアント側でも実行できます。
• スケジューラー（スマートコントラクト）： get_contract_types、estimate_schedule、 create_schedule、list_schedules。型、見積もり、一覧は利用可能です。 create_schedule はプレビュー機能です。バックエンドの署名メッセージ仕様が未確定のため、 まだ実行できません。スケジュール設定は非カストディアルです。呼び出し元自身のEVMウォレットが署名し、 サーバーが署名を捏造することはありません。
• 監査（派生機能 — 時刻＋ログ記録＋IDを組み合わせたもので、新しいプリミティブはありません）： generate_audit_trail、generate_compliance_report（EU AI Act Art. 12 / SEC 17a-4 / ISO 27001 のプリセット）、build_evidence_package、verify_package。
• エージェントID（検証用、有効時点T — 認証用ではありません）： resolve_agent、attest_action、complete_attestation、verify_receipt、 mint_identity、revoke_identity、delegate_authority、 get_identity_history、verify_identity_at、verify_cross_party。 attest_action に wait=false を指定すると、ブロックせずに送信できます。complete_attestation は、ブロックが確定した後に確認済みレシートを返すポーリング機能です。
• コミットメント（TSA）： tsa_issue、tsa_checkpoint、tsa_attest、 tsa_settle、tsa_status。アンカープリミティブ上でコミットメントのライフサイクルを管理します — 発行 → チェックポイント → 証明（遵守／違反）→ 決済、およびステータス確認。tsa_attest はオンチェーンのアンカー時刻と期限を照合し、遵守／broken-late／ broken の判定を行います。結果は記録されますが、強制はされません（MVP）。

当事者間の検証は利用可能で、秘密鍵は不要です： GET /searchAssetFromChain?blockHeight={h} は、APIキーなしで不変のオンチェーンブロックを読み取ります。そのブロックは、変更可能な /ledger/{id} キャッシュではなく、権威ある記録です。検証はチェーン上の記録を参照します。

パッケージ（このモノレポ）：

パッケージ	内容
@clockchain/mcp-server	MCP サーバー — clockchain-mcp（dist/stdio.js）、stdioおよびHTTPトランスポート。
@clockchain/core	共有クライアント、型、ハッシュ／レシート、およびERC-8004ヘルパー（Node専用、追加依存関係なし）。
@clockchain/web-demo	ブラウザーチャットのデモ — MCP経由でツールを操作するLLMエージェント。
@clockchain/clock-sdk	クライアント側の検証済み時刻プリミティブ — 高精度時計＋アラーム／タイマーのスケジューラー＋ストップウォッチ。アラーム／タイマーを動作させるには必須です（下のコールアウトをご覧ください）。

⏰ アラームとタイマーはクライアント側コンポーネントで動作します — これは設計によるものです

MCP サーバーは、コンセンサス時刻、改ざん検知可能な公証、attest_action、キー不要のオンチェーン検証といった信頼の基盤を提供します。ストップウォッチ（証明可能な経過時間）は、これらのツールだけで直接動作します。アラームとタイマー、つまり「将来の時刻に自動的に発火する」機能には、クライアント側のコンパニオンである @clockchain/clock-sdk も必要です。

この分担は**意図的なものであり、制限ではなく信頼性を確保するための特性です。**スケジュールと発火させるアクションは、お客様の環境内にとどまります。Clockchain はスケジュールも鍵も保持せず、お客様に代わって動作することもありません。提供するのは、中立で検証可能な時刻と、発火ごとの不変で独立して検証可能な記録だけです。ブロックチェーンからシステムを起動することはできません。また、中立性を保つためにも、そうすべきではありません。コンパニオンはローカルクロックを Clockchain に同期させ（NTP 方式）、お客様の信頼境界内で発火させ、キー不要で検証可能な受領証を記録します。

SDK も認証情報も不要で、動作を見てみたいだけですか？アラームのフローデモを実行してください：bash packages/clock-sdk/examples/try-alarm-mcp.sh（または冒頭にある curl のワンライナー）。無料のデモトークンを発行し、アンカー記録からキー不要の検証までを一通り実行します（ホストされた MCP で log_action をポーリングします。SDK のビルドは不要です）。これは信頼の基盤が動作する様子を示すものであり、クライアント側のスケジューラーではありません。実際にクライアント側のアラームを動作させるには、以下の SDK を使うことで、同期されたクロックと ClockScheduler クラスを利用できます。これが、お客様の信頼境界内で実際に自動発火するアラームです。つまり、MCP フローは認証情報なしでアンカーされた発火を「確認」する方法であり、SDK は実際のアラームを「運用」する方法です。

インストールと運用：packages/clock-sdk — クイックスタート、信頼性とセキュリティのモデル、本番環境向けデーモンの設定例（pm2 で実行）。

マネージドオプション（ロードマップ）：コンパニオンを実行せずに済ませたいチーム向けに、MCP の schedule_trigger ツールから利用できるオプションのホスト型キーパーが、同じ検証可能な受領証とともにサーバー側で発火します。roadmap.md を参照してください。

ターミナル向けの @clockchain/cli を予定しています。roadmap.md を参照してください。

検証可能な時刻アラーム（clock-sdk）

Clockchain の中立で検証可能なクロックに基づいて発火させ、発火のたびに証明を残します。 @clockchain/clock-sdk は、クライアント側の同期クロックとスケジューラーです。アラーム、タイマー、ストップウォッチを利用できます。チェーンは純粋なクロック兼公証機関のままです。スケジューリングはお客様のプロセスで実行され、発火ごとにキー不要で検証可能な受領証がアンカーされます。

**仕組み：**Clockchain に NTP 方式で同期します（オフセットと不確実性を取得します。ポーリングでもビーコンでもありません）→ clockchain_now ≥ T になったらローカルで発火します → 発火をアンカー記録します（attest_action）→ 不変のオンチェーンブロックに対してキー不要で検証します。将来の署名付き時刻ビーコンがある場合もない場合も動作します（時刻ソースは差し替え可能です）。T の時刻に発火させるには実行中のプロセスが必要なため、クライアント側（常時稼働するホストなど）に配置されます。ブロックチェーンからクライアントを起動することはできません。

状況 — PoC、ライブ環境で検証済み。構築・マージ済みです（ユニットテスト 35 件、2026-06 にスケジューラーのバグを 4 件修正）。エンドツーエンドの実測値は、クロック読み取りが約 0.12 秒、発火からオンチェーンへのアンカー記録までが約 1.4 秒（3 秒の予算を大きく下回る）、その後の verify_cross_party の結果が verifiedAgainst: "on-chain block", keyless: true です。（この 1.4 秒は発火からアンカー記録までの時間です。発火までの待機時間はスケジュールした遅延、つまり fireAt / CC_WAIT_S であり、SDK のオーバーヘッドではありません。したがって、合計経過時間 = 待機時間 + 約 1.4 秒です。）監査／SLA／エージェントの期限を想定した用途であり、**マイクロ秒／HFT 向けではありません。**バリデーターが 1 つのテストネットであるため、「法廷で通用する品質」は目標であり、現時点での保証ではありません。

お試しください：

# Zero creds (MCP flow, self-serve demo token; needs jq) — start here, no account:
curl -fsSL https://raw.githubusercontent.com/thetangstr/clockchain-developer-tools/main/packages/clock-sdk/examples/try-alarm-mcp.sh | bash

# Full SDK (disciplined-clock loop) — once you have testnet gateway creds:
export CLOCKCHAIN_API_KEY=… CLOCKCHAIN_CLIENT_ID=… CLOCKCHAIN_WALLET_ID=…
curl -fsSL https://raw.githubusercontent.com/thetangstr/clockchain-developer-tools/main/packages/clock-sdk/examples/try-alarm.sh | bash

API、信頼性とセキュリティのモデル、Clark Slack ボットのデーモン設定例については、packages/clock-sdk を参照してください。

アプリで使用する（npm は不要です）

@clockchain/* パッケージはまだ npm で公開されていません。そのため、npm install @clockchain/clock-sdk は動作しません。今すぐ使用する方法は 2 つあります。

A — 依存関係ゼロのホスト型 MCP（Node 18+ の組み込み fetch と、セルフサービスのデモトークンを使用します）。 以下をコーディングエージェントに貼り付けてください。

Add a verified-time alarm to my project — NO npm packages, Node 18+ only (built-in fetch),
against Clockchain's hosted MCP (https://mcp.clockchain.network/mcp — JSON-RPC over HTTP, SSE replies).

1. Key:  curl -X POST https://mcp.clockchain.network/token  -> demo token (no signup); use as
   header x-api-key. Mint ONCE and cache — it's IP-rate-limited.
2. call(name,args) helper: POST {jsonrpc:"2.0",id:1,method:"tools/call",params:{name,arguments:args}}
   with headers x-api-key + accept "application/json, text/event-stream". Reply is SSE — take the
   last `data:` line, JSON-parse, read result.content[0].text (itself a JSON string).
3. Alarm: poll get_timestamp (madMarzulloTime, ISO 8601 since 2026-09; older gateways used
   DD-MM-YYYY_HH:MM:SS:mmm — parse both) until consensus
   time >= your target T (never fire early), then log_action {action, asset_reference_id, content,
   wait:true, wait_ms:30000} to fire + anchor. Content is SHA-256-hashed, never stored.
4. Assert it anchored: if blockHeight is null the validator pool was degraded — treat as FAILURE,
   don't claim success.
5. Verify keylessly: verify_cross_party {ledger_id, block_height:<number>} — result nests under
   .onChain; expect verifiedAgainst "on-chain block", keyless true.

Report the fired time, blockHeight, and verify result.

B — SDK クラス（規律あるクロックとスケジューラー）— モノレポをクローンしてビルドし、ワークスペースパッケージをインポートします（npm のリンクを使用し、レジストリは不要です）。

git clone --depth 1 https://github.com/thetangstr/clockchain-developer-tools.git
cd clockchain-developer-tools && npm install && npm run build
# then import @clockchain/clock-sdk / @clockchain/core from within the workspace,
# or copy packages/clock-sdk/examples/alarm-live.mjs as a starting point.

npm install @clockchain/clock-sdk @clockchain/core はパッケージ公開後に動作します。roadmap.md をご覧ください。

ロードマップ

フェーズ	範囲	ステータス
0 · 名称の変更＋ドキュメント	create_schedule がアラームではなく、コントラクトのデプロイであることを明確化し、ドキュメントを公開	✅ 完了
1 · クライアント SDK	規律あるクロック＋スケジューラー（アラーム／タイマー／ストップウォッチ）＋サンプル	✅ 実装・マージ済み。PoC のライブ検証済み
2 · ホスト型キーパー	MCP の schedule_trigger ツールを介したオフチェーンのディスパッチ — インストール不要、オフライン中も実行。信頼性の高い配信（再試行／冪等性／DLQ）	◻ 次の予定（要望に応じて）
3 · マルチバリデーター	法廷水準の証拠という主張を可能にします	◻ 条件付き（プロトコルのロードマップ次第）

信頼性のゲート： 実行結果は実際にアンカーされる必要があります。バリデータープールの性能が低下すると、レシートがキャッシュにのみ保存される場合があります（blockHeight が null）。P0 として追跡中です（アンカーされるまで成功を報告しないでください）。マルチバリデーター（フェーズ 3）によって、プールへの参加に関する問題に対処します。try-alarm-mcp.sh スクリプトがこれを自動検出して処理するため、手動の手順は不要です。

ステータス

ライブゲートウェイに対して動作します。MCP サーバーが動作することを検証済みです。initialize と tools/list は 50 個のツールを返し、ライブ呼び出しも成功します。検証済みの範囲（2026-06-11 更新）：

• 時刻： 公開されている /getTime からコンセンサス時刻を読み取ります（キーのスコープは不要です）。/api/time/* 系列は、ロギングスコープのキーでは 401 を返します。
• ノータリゼーション： /log、/ledger/{id}、/searchAsset、/getValidationBlock がすべて動作することを確認済みです — ログへの記録、オンチェーンでの確認、取得、検証が可能です。
• 当事者間の検証：****ライブで利用でき、キーも不要です — GET /searchAssetFromChain?blockHeight={h} は API キーなしで不変のオンチェーンブロックを読み取り、そのブロックが権威ある記録となります。
• スマートコントラクトのスケジューリング： コントラクトの種類、見積もり、一覧はライブで利用可能です。create_schedule はプレビューであり、バックエンドの署名メッセージ仕様の策定待ちです。 署名ベースで、カストディを伴いません（呼び出し元の EVM ウォレットが署名します）。
• エージェントの ID： 認証ではなく、検証（時点 T で有効かどうか）です。ERC-8004 レジストリはライブで利用でき、解決も行われます。ID グラフへの書き込み（mint／revoke／delegate）は、まだプレビュー段階のディレクトリを参照します。
• 法廷水準の証拠を想定して設計されています。単一バリデーターのテストネットで、レート制限は厳格です。

現在の制限事項とロードマップの全容：roadmap.md。

ホスティング、CI/CD、運用

https://mcp.clockchain.network/mcp で GCP Cloud Run にホストされています（トークンによるアクセス制限付き＋独自のキーを使用）。main へのプッシュ時に、テストゲートを通過すると自動デプロイされます。

ファイル	内容
CLOUD-RUN.md	デプロイと運用の手順書：キー不要の WIF CI/CD、Cloud Armor、モニタリング、シークレット／トークンのローテーション、ロールバック。ホスティングに関する正式なドキュメントです。
cicd-plan.md	CI/CD パイプライン、必須ルール、今後の計画です。
AGENTS.md	コントリビューター／エージェント向けガイド — プッシュ前にテストを実行すること、デプロイゲートを決して迂回しないこと、ワークツリーごとにエージェントを 1 つにすること。
auth-and-traffic-decision.md	単一 ID の入口、委任アクセスと BYO、Cowork と Claude Code、チャネル／トラフィックとコストのモデル。
agentdash-mcp-integration-brief.md	ホストされた MCP を統合する AgentDash チーム向けの引き継ぎ資料です。
eval/	実行スコアに基づく評価ハーネス — Layer-A のパフォーマンス評価と Layer-B のエージェントタスクスイート（オンチェーン検証、LLM による判定なし）。
RETRO-2026-06-13.md	06-11 ～ 06-13 の構築作業（Cloud Run、CI/CD、TSA、評価）の振り返りです。

以下の DELEGATED-ACCESS.md では、廃止された Mac mini の構成について説明しています。現在は CLOUD-RUN.md に置き換えられています。

仕様書と計画ドキュメント

背景、設計上の決定、展開計画（このリポジトリは当初、作業の計画をまとめる場として始まり、これらのドキュメントは現在もここにあります）：

ファイル	内容	対象読者
mcp-deployment-brief.md	承認を得るには、まずこちらをご覧ください。 要件、デプロイの依存関係、ネットワーク公開モデルを 1 ページにまとめた資料です。ステークホルダー、ネットワークチーム、バックエンド向けの承認欄もあります。	ステークホルダー／ネットワーク／バックエンド
DELEGATED-ACCESS.md	API キーや VPN なしでテスターにアクセスを提供する方法：Web デモと MCP エンドポイントの前段に Cloudflare Access を配置し、トークン／レート／予算の上限を設定します。	エンジニアリング／運用
implementation-plan.md	技術仕様と構築計画の全容です。正式な情報源です。	エンジニアリング
implementation-plan-technical.html	設計の詳細を含む、仕様書のスライド版です。	エンジニアリングレビュー
implementation-plan.html	簡潔な概要をまとめたスライド資料です。	ビジネス／ステークホルダー
product-findings.md	実際のネットワークとダッシュボードを使って得た調査結果です。	プロダクト／エンジニアリング
industry-landscape.md	主要なタイムスタンプ／来歴プラットフォームの取り組みと、Clockchain が差別化できる領域に関する根拠です。	プロダクト／戦略
mcp-readiness.md	実環境でのテストに基づき、製品 A と B の API のうち、どれを MCP ツールとして利用できるかをツールごとに評価しています。	エンジニアリング／プロダクト
journeys.md	開発者とエージェントのエンドツーエンドの利用フローを示し、現在の API フローが自律型エージェントの利用に対応している箇所と、妨げになる箇所を記しています。	エンジニアリング／プロダクト
product-a-identity-decision.md	エージェント ID に独自の DID を使うか、ERC-8004 と SIWA を使うかについての決定メモです。標準を採用し、時間と検証で差別化するハイブリッド方式を推奨します。	プロダクト／リーダーシップ
deployment.md	ホスティング計画：ローカルの stdio（開発者向け）、Mac mini のテスト用ホスト（ビジネスユーザーと AgentDash 向け）、AWS の本番環境計画と情報チェックリスト。	エンジニアリング／運用
poc-build-plan.md	Mac mini で MCP サーバーを稼働させる目標と段階的な計画、および Clockchain との接続方法です。	エンジニアリング／リーダーシップ
roadmap.md	現在のロードマップ、動作する機能、既知の制限事項です。	プロダクト／エンジニアリング

どちらかの .html ファイルをブラウザーで開くと、プレゼンテーションできます（矢印キーで移動、Esc キーでスライドの一覧を表示）。