AppleヘルスケアをClaude CodeにMCPで連携

Claude CodeにMCPを追加する前に必要なもの

最新のClaude Code、iPhoneのteloアプリ、そして完了した同期。Claude Codeが読むのは、iPhoneがすでにteloアカウントに送ったものです。下のコマンドだけでは、何もアップロードされません。

ウェブ版のClaudeでteloをコネクタとして追加済みで、同じClaudeアカウントでClaude Codeにサインインしているなら、/mcpにteloがすでに表示されているかもしれません。その場合はコマンドを飛ばして、サインインに進んでください。

リモートMCPサーバーを追加する

--scope userを付けると、このコンピュータのすべてのプロジェクトでteloが使えます。個人のデータソースにはこれが合っています。付けなければ、現在のプロジェクトにだけ追加されます。--scope projectは避けてください。コミットして共有するための.mcp.jsonにサーバーが書き込まれます。

このコマンドが保存するのはアドレスだけです。ログインのコードやトークンは設定ファイルに入らず、健康のデータもまだ何も読み取られません。

claude mcp add --transport http --scope user telo https://telo.health/mcp

Claude Codeの中からサインインする

1. Claude Codeを起動し、/mcpと入力します。
2. teloを選び、認証のオプションを選びます。ブラウザでteloのサインインページが開きます。
3. teloアプリと同じメールアドレスでサインインし、求められているアクセスを確認して承認します。
4. ターミナルに戻ります。/mcpで、teloが接続済みと表示されるはずです。

接続が使えるか確かめる

1. 別のターミナルでclaude mcp listを実行し、teloが設定されているか確認します。
2. Claude Codeに、teloを使って、利用できる指標と期間を一覧にするよう頼みます。
3. 実際にteloのツールを呼び出し、本当のカバー範囲を返しているか確認します。サーバーが使えないと言われたり、ツールを呼び出さずに答えたりした場合は、そこで止めてください。

記録についての最初のプロンプト

Claude Codeはスクリプトを書き、実行し、グラフを見せてくれます。ここが、チャットの画面ではできない部分です。傾向を信用する前に、どの日付を読んだか示してもらいましょう。

teloを使って、直近90日間の睡眠を読み取ってください。1晩1行のCSVを保存し、合計睡眠時間を7日間の移動平均とあわせてグラフにしてください。データのない夜は埋めずに、一覧にしてください。

健康の記録をリポジトリに入れない

Claude Codeが保存するものは、開いたフォルダに置かれます。健康の分析は仕事のリポジトリではなく個人用のフォルダで行い、コミットの前にgit statusを確認してください。

teloが返した記録は、ほかのツールの結果と同じく、会話の一部としてAnthropicでも処理されます。

トラブルシューティング

/mcpでteloが失敗、または認証が必要と表示されたら、/mcpからもう一度サインインしてください。ブラウザが開かなければ、Claude Codeが表示するリンクをコピーします。URLが正確にhttps://telo.health/mcpになっているか確認してください。

接続はできているのに記録がない場合は、teloアプリでアカウントと最後の同期を確認してください。サインインに成功しても、iPhoneでヘルスケアの権限が許可され、履歴の送信が終わったとは限りません。

よくある質問