Paceva

開発者向け Paceva

Paceva は、持久系アスリートのウォッチデータを、実績に基づいた率直なレース予測に変換します。予測は幅を持たせ、本人の過去の記録と照合します。このリポジトリでは、公開されているインターフェースである Paceva MCP サーバー、その前段にある OAuth 2.1 サインイン、および Paceva と Intervals.icu の接続方法について説明します。

Paceva アプリ自体はクローズドソースです。このリポジトリに含まれるのはドキュメントとサンプルのみです。

1 分で接続

サーバー URL： https://paceva.app/api/mcp

アプリ	方法
Claude（claude.ai、デスクトップ、モバイル）	［設定］→［コネクター］→［カスタムコネクターを追加］を選び、URL を貼り付けて Paceva にサインインし、承認します。
ChatGPT	［設定］→［アプリとコネクター］から、URL を使ってカスタムコネクターを追加します（一部のプランでは開発者モードが必要です）。
Claude Code	claude mcp add --transport http paceva https://paceva.app/api/mcp を実行し、続けて /mcp でサインインします。
Cursor / VS Code	paceva.app/dashboard/ai のワンクリックボタンを使うか、Streamable HTTP サーバーとして追加します。
その他	Streamable HTTP と PKCE を使った OAuth 2.1 に対応する MCP クライアントなら、どれでも利用できます。

接続したら、「今日は追い込んでもいいですか？」「今なら 1500 をどれくらいのタイムで泳げますか？」「直近のライド期間の調子はどうでしたか？」といった質問をしてみましょう。

詳しい手順：docs/connect.md。

内容

ドキュメント	対象
docs/connect.md	各 AI アプリへの接続方法と、利用時にできること
docs/tools.md	すべての MCP ツール、その引数と返される内容
docs/oauth.md	OAuth 2.1 サーバー：ディスカバリー、PKCE、クライアント登録、トークン
docs/intervals-icu.md	ウォッチデータの取り込み方法：Intervals.icu へのサインイン手順
docs/data-and-privacy.md	AI アプリが参照できるデータと、できないデータ
docs/listing.md	MCP Registry のエントリー（server.json）と登録先のディレクトリ
examples/	curl によるディスカバリー、JSON-RPC の生呼び出し、クライアント設定のスニペット

基本方針

• 読み取り専用です。 スコープは paceva:read の 1 つです。ツールがデータを書き込むことはありません。
• 参照できるのは本人のデータのみです。 トークンは 1 つの Paceva アカウントに紐付けられ、他の人のデータを読み取ることはできません。
• すべての数値にラベルが付いています。 device の値はウォッチ独自の値（例：Garmin の HRV）で、paceva の値は Paceva が計算したものです。
• 予測には幅があります。 ツールは低い値から高い値までの範囲と、その範囲が本人に当てはまる頻度を返します。単一のタイムではなく、範囲を伝えてください。
• いつでも取り消せます。 Paceva の［AI で利用］からアプリの接続を解除すると、次の呼び出し以降、そのトークンは使えなくなります。

ステータス

項目	状態
MCP サーバー + OAuth	利用可能
Intervals.icu 同期（Garmin、Coros、Wahoo、Polar、Suunto）	利用可能
Paceva ウェブダッシュボード	近日公開、ウェイトリストに登録
iPhone アプリ（Apple Health）	近日公開

セキュリティ

問題を見つけた場合は、公開 issue を作成せず、[email protected] までメールでご連絡ください。SECURITY.md をご覧ください。

ライセンス

このリポジトリのドキュメントとサンプルは MIT ライセンスです。Paceva の名称とロゴは対象外です。