AIアシスタントとAPIキーの連携

すべてのAIアシスタントが、あなたに代わってFitnessSyncer MCP Serverにログインできるわけではありません。 多くのアシスタントは、サーバーアドレスとトークンを入力する場所しか提供しておらず、中には設定のすべてをディスク上のファイルから読み込むものもあります。そのような場合、FitnessSyncerはAPIキーを発行します。これは、ログイン全体に代わる単一の長期有効なトークンです。

これが Mistral Vibe の接続方法であり、これはセルフホスト型アシスタント、コマンドラインクライアント、エージェントフレームワーク、あるいは OAuth 画面ではなくヘッダーを提供する ChatGPT に対する解決策でもあります。 Claude、ChatGPT、Perplexity、Home Assistantにはそれぞれ独自のサインイン方法がありますので、該当する場合はそれぞれの説明に従ってください。

始める前に

• ソースが連携されたFitnessSyncerアカウントです。MCP Serverはすべてのアカウントに標準で含まれているため、追加で購入する必要はありません。初めてご利用の方は、「はじめに」をご覧ください。無料アカウントの場合、当サイトの他の場所と同様、閲覧できる履歴の範囲が限られています。
• Authorizationヘッダーを送信できるアシスタント、あるいはこれを「Bearerトークン」や「APIトークン」と呼ぶアシスタントです。もしお使いのアシスタントが代わりにOAuthでログインできるなら、そちらの方が望ましい方法です。なぜなら、権限を一度だけ設定するのではなく、その都度選択できるからです。

手順 1: FitnessSyncer で API キーを作成する

1. 「開発者アカウント」ページに移動してください。
2. ページの下部で、リストから「MCP: API キー」を選択し、「作成」をクリックします。
3. FitnessSyncer では、このキーにどの権限を付与すべきかを尋ねられます。アシスタントに実行させたい操作のみを選択してください。質問への回答については、読み取り権限だけで十分です。また、チェックを入れなかった権限は、新しいキーを作成しない限り、後で使用することはできません。
4. 「APIキーの作成」を選択し、次のページに表示されるAPIキーをメモしておいてください。このAPIキーが表示されるのはこの1回限りです。もし失くしてしまった場合は、再発行できますが、その場合はアシスタントに再度入力する必要があります。

  Step 2: Mistral Vibe

APIキーを用意したら：

1. 左側のメニューから「コンテキスト」を選択し、続いて「コネクタ」を選択します。
2. 画面の右上にある「コネクタの追加」を選択します。
3. 「カスタム MCP コネクタ」を選択します。
4. 「FitnessSyncer」を「名前」の欄に入力してください
5. サーバーには「https://www.fitnesssyncer.com/services/mcp」と入力してください
6. 「APIトークン認証」を選択し、APIキーを「Bearerトークン」に貼り付けてください。

ステップ 2：設定画面が表示されるその他のアシスタント

フィールド名はアシスタントごとに異なりますが、その数は常に3つだけです：

1. 「FitnessSyncer」を「名前」の欄に入力してください
2. 「https://www.fitnesssyncer.com/services/mcp」をサーバー欄に入力してください。一部のアシスタントでは、これを「リモート MCP サーバーのURL」と呼ぶ場合があります。
3. 「Bearer Token」フィールドにAPIキーを入力してください。アシスタントが代わりにヘッダーの入力を求めた場合は、ヘッダー名は「Authorization」、その値は「Bearer」、スペース、そしてAPIキーの順で指定してください。

アシスタントからトランスポートの選択を求められた場合は、「Streamable HTTP」を選択してください。FitnessSyncerでは、旧式のSSEトランスポートは提供されていません。

ステップ 2: ファイルから設定されたアシスタント

多くのコマンドラインクライアントやデスクトップクライアントは、JSONファイルからサーバー情報を読み込みます。形式は様々ですので、お使いのアシスタントのドキュメントに合わせて調整してください。ただし、通常は次のような形式になっています：

{
 "mcpServers": {
   "FitnessSyncer": {
     "transport": "http",
     "url": "https://www.fitnesssyncer.com/services/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_TOKEN_HERE"
     }
   }
 }
}

「YOUR_TOKEN_HERE」を、APIキーに置き換えてください。その際、「Bearer」という文字列と、その直前のスペースはそのまま残してください。

試してみてください

新しいチャットを開始し、以下のいずれかを貼り付けて、すべてが正常に動作しているか確認してください：

• 私のアカウントでFitnessSyncerが現在接続しているすべてのアプリとデバイスを一覧表示し、最後に同期された日時を表示してください。
• 今週の睡眠は、先週と比べてどうだったかな？
• この1か月間、私の安静時心拍数はどのように変化したのでしょうか？

MCP Serverのページには、他にもたくさんのアイデアが掲載されています。