Claude または ChatGPT を接続する
Claude または ChatGPT を接続する
Claude または ChatGPT を接続して、保存済みの旅行、ルート、お気に入りの場所を読み取れるようにできます。接続後は、日ごとの地図を含む旅行ドキュメントの作成をアシスタントに依頼できます。ドキュメント自体はアシスタント側のドキュメント作成機能で作成され、WaypointGuru は保存済みデータとブランド付きの地図画像を提供します。
開始前に
WaypointGuru のアカウント、保存済みデータ、そしてカスタムのリモート MCP 接続を許可するアシスタントのアカウントが必要です。管理対象ワークスペースでは、管理者が接続を有効化または追加する必要がある場合があります。ドキュメントの作成には、そのアシスタントで適切なドキュメントツールと画像ツールも必要です。
この MCP サーバー URL を使用します:
https://waypoint.guru/mcp
認証方式は OAuth を選び、automatic registration（dynamic client registration または DCR とも呼ばれます）を使用してください。WaypointGuru では API キー、パーソナルアクセストークン、クライアントシークレット、カスタム認可ヘッダーは不要です。Client ID Metadata Documents (CIMD) ではなく、自動登録を使用してください。
Web 版 Claude の設定
- Customize > Connectors を開き、+ Add > Add custom connector を選びます。管理対象ワークスペースでは、まず所有者が Organization settings > Connectors で Web コネクタを追加する必要がある場合があります。
- 名前を WaypointGuru にし、MCP サーバー URL として
https://waypoint.guru/mcpを入力します。 - 認証設定を続けます。OAuth クライアントでは Sign in now と Register automatically を選びます。Claude の公開済み ID ではなく、自動登録を使用してください。
- コネクタの追加を完了し、表示された場合は Connect を選びます。その後、以下の WaypointGuru のサインインと権限設定を完了してください。
- 会話画面で + > Connectors を開き、WaypointGuru を有効にします。
メニュー名や利用可否は変更されることがあります。アカウントで表示が異なる場合は、Claude のカスタムコネクタ手順を参照してください。
Web 版 ChatGPT の設定
ChatGPT では現在、2 つの設定レイアウトが案内されています。ご利用のアカウントで使える方を使用してください。
Plugins レイアウトの場合:
- Plugins を開き、+ > Add custom MCP server を選択して、名前を WaypointGuru にします。
- Connection で
https://waypoint.guru/mcpを入力します。OAuth を選び、DCR を設定し、静的なクライアント認証情報は空のままにします。 - 警告を確認し、Create as a plugin を選んで、作成されたプラグインをインストールします。求められたら WaypointGuru へのサインインと同意を完了してください。
- チャットでデータの読み取りを依頼するときは、@ を入力して WaypointGuru を選びます。
OpenAI のカスタム MCP サーバー手順も参照してください。
Apps / developer mode レイアウトの場合は、許可されていれば Settings > Apps > Advanced settings > Developer mode を有効にします。同じ URL と OAuth/DCR 設定でアプリを作成し、そのツールをスキャンしてサインインを完了し、作成を完了してください。データを要求するときはチャット内でそのアプリを選択し、必要に応じて追加の要求時にも再度選択してください。これらの設定へのアクセスはワークスペース管理者が管理します。OpenAI の developer mode 手順も参照してください。
権限を選ぶ
アシスタントが開いたブラウザーウィンドウで WaypointGuru にサインインします。承認する前に、表示されているアカウントとアシスタントを確認してください。モバイルアプリですでにサインインしていても、再度サインインが必要な場合があります。
同意画面では、以下の読み取りカテゴリを選べます:
| カテゴリ | アシスタントが読み取れる内容 |
|---|---|
| 旅行 | 保存済みの旅行の詳細と、その中に含まれる各日ごとのルート。地図に必要な日ごとのデータも含まれます。無関係な単独の保存済みルートや、お気に入り全体へのアクセスは含まれません。 |
| ルート | アカウントで利用可能な保存済みルート。名前による検索、完全なルートデータ、地図を含みます。 |
| お気に入り | タグ検索、近接検索、完全な詳細を含むお気に入りの場所。 |
旅行ドキュメントを作成する場合は、まず 旅行 だけで開始してください。アシスタントにそれらを使わせたいときだけ、他のカテゴリを追加してください。不要なカテゴリのチェックを外して 選択項目を承認 を選ぶか、要求されたカテゴリをすべて承認します。キャンセルするには キャンセル を選びます。
権限は、後で保存された項目や、通常そのアカウントでアクセスできる共有項目も含め、承認した各カテゴリ全体に適用されます。1 つの旅行や 1 つの会話に限定されるものではありません。既存の共有設定、プライバシー設定、サブスクリプション制限は引き続き適用されます。リンクを渡しても、それらを回避することはできません。
アクセスは読み取り専用です。アシスタントは WaypointGuru のデータを編集、削除、公開できません。ただし、読み取りアクセスによってデータはアシスタント提供元に送信され、その提供元の保存設定やプライバシー設定が適用されます。接続が有効な間はアクセスは自動更新されるため、通常は繰り返し承認する必要はありません。長期間使用しなかった場合は、再接続が必要になることがあります。
旅行ドキュメントを依頼する
会話で WaypointGuru を有効にした状態で、次のように試してください:
WaypointGuru を使って、「Coastal holiday」という名前の保存済み旅行を見つけてください。旅行の詳細と各日ごとのセクションを含むドキュメントを作成してください。利用可能な各日について WaypointGuru の地図を含め、保存済みのウェイポイント詳細から立ち寄り地点の凡例を作成してください。休養日と利用できないルートを明記してください。保存済みの統計と再計算した統計は分けて示し、取得できなかったデータや画像があれば知らせてください。
アカウントでアクセス可能な、保存済み旅行または保存済みルートへの完全なリンクを渡すこともできます。エクスポートされたルートを含む短縮リンクや、未保存のルートはサポートされません。
ドキュメントが完成したと判断する前に、すべてのページ送りとスナップショットチャンクの取得を完了するようアシスタントに依頼してください。旅行とルートは保存済みデータから最大 24 時間有効なスナップショットとして取得されます。その後の編集はその取得内容には反映されず、未保存の編集も含まれません。新しく保存した変更を含める場合や、有効期限切れの取得を復旧する場合は、新しいスナップショットと新しい地図を依頼してください。
地図は、デフォルトで WebP、フルサイズ、標準スタイル、日ごとの色で提供されます。JPEG と PNG もサポートされており、プレビューサイズ、衛星スタイル、夜間色も利用できます。ドキュメントツールが WebP を埋め込めない場合は、PNG を指定してください。WaypointGuru のブランド表示と地図提供元の帰属表示は見える状態に保ってください。周辺の文章と立ち寄り地点の凡例はアシスタントが作成します。
WaypointGuru は、保存済み推定値がないインポート済みルートも含め、取得されたルートと旅行の各日について走行距離と所要時間を自動計算します。利用可能な場合は一致する Google 推定値が使われ、Valhalla 推定値が代替として使われた場合はその旨が示されます。走行時間には立ち寄り先での滞在時間は含まれません。保存済みの推定値は別扱いのまま維持されます。ルートと日ごとの詳細には、ルーティングで提供される場合、簡略化したルートの輪郭と主要道路名も含まれます。特定区間を確認する必要がある場合、アシスタントは区間単位または距離範囲単位で詳細なジオメトリを要求できます。
地図は通常、MCP 画像と保護されたリソース参照として届きます。画像 URL が必要なドキュメントツールの場合は、アシスタントに delivery: "url" を要求するよう伝えてください。Google ドキュメントの場合は、さらに format: "png" または "jpeg" も要求してください。形式を指定しない場合、デフォルトは WebP のままです。
ダウンロードリンクは 15 分間有効です。ただし、保存済みスナップショットの有効期限がそれより早い場合は、その時点までです。リンクを持っている人は、アシスタントの接続とあなたのアクセス権が有効な間、その画像を取得できます。リンクは秘密情報として扱ってください。アシスタントを接続解除したりリソースへのアクセスを失ったりすると、それ以降のダウンロードはできなくなりますが、すでにドキュメントに挿入されたコピーを削除することはできません。挿入前にリンクの有効期限が切れた場合は、新しいリンクをアシスタントに要求してください。それでも埋め込みに失敗する場合は、成功したと主張せず、不足している地図を報告するよう依頼してください。
接続解除またはアクセス変更
- WaypointGuru の Web アプリで、WaypointGuru の設定 > ユーザーアカウント > 接続済みアプリ を開きます。
- アシスタント名、承認済みカテゴリ、最終使用情報を確認します。
- 1 つの接続だけを解除するには 接続解除 を、アカウントのすべてのアシスタント接続を取り消すには すべて接続解除 を選びます。
ブラウザーへの引き継ぎに対応したモバイル版では、アカウントメニューの 接続済みアプリ を選ぶと、これらの設定がブラウザーで開きます。求められた場合はそこでサインインしてください。
接続解除すると、それ以降のデータ読み取り、地図取得、自動更新が停止します。まだ有効期限が切れていない認証情報を使った要求も含まれます。ただし、アシスタントがすでにダウンロードしたテキスト、画像、ドキュメントを取り消すことはできません。そのコンテンツは提供元側で別途管理してください。
承認済みカテゴリを変更するには、既存の接続を解除してから、新しい同意で再接続してください。Claude または ChatGPT 側でコネクタ、アプリ、プラグインを削除することもできます。1 つの会話でオフにするだけでは WaypointGuru 側の権限は取り消されません。アクセスを取り消すには、WaypointGuru の接続解除機能を使用してください。
トラブルシューティング
| 問題 | 試すこと |
|---|---|
| 接続を追加する項目がない | 上記の提供元手順を参照して、アカウントの利用条件とワークスペース管理者の権限を確認してください。 |
| 接続設定または登録に失敗する | サーバー URL が https://waypoint.guru/mcp であることを確認してください。自動登録/DCR を使う OAuth を選択してください。CIMD や Claude の公開済み ID は選ばないでください。 |
| ログインは完了するが同意画面が表示されない | 保留中の接続ウィンドウに戻ってください。一時的なエラーであれば再試行操作を使ってください。要求の有効期限が切れたかキャンセルされた場合は、アシスタント側から新しい接続を開始してください。 |
| 間違ったアカウントが表示される | 同意をキャンセルしてください。そのブラウザーで意図した WaypointGuru アカウントにサインインして、最初からやり直してください。 |
| ツールが見つからない、または権限が拒否される | 接続済みアプリ のカテゴリと、アシスタントで有効なツールを確認してください。必要なら、必要なカテゴリを付けて再接続してください。旅行 だけでは、無関係なルートやお気に入り全体へのアクセスは意図的に含まれません。 |
| 旅行、ルート、または共有リンクが利用できない | まず変更を保存し、同じアカウントで WaypointGuru 内のその項目を開けることを確認してください。共有設定とサブスクリプションアクセスも確認してください。非公開、削除済み、またはアクセス不能な項目は、どれも利用不可として表示される場合があります。 |
| 結果が不完全に見える | ページ送りを続けて、すべてのスナップショットチャンクを読むようアシスタントに依頼してください。空の検索ページでも、さらにページが残っている場合があります。 |
| スナップショットの有効期限が切れた | 新しい取得を要求してください。古い取得は 24 時間で期限切れになり、アクセスが取り消されると使用不能にもなります。 |
| 地図が保留中、または一時的に失敗する | 返された再試行待機時間に従い、同じ取得を再利用してください。何度も新しい取得を開始しないでください。 |
| 地図が上限またはサイズ制限に達する | 表示された上限の再試行時刻まで待ってください。再接続しても上限はリセットされません。サイズ制限の結果は、同じ取得を何度も再試行しても解決しません。報告するか、より小さい保存済みルートを使ってください。 |
| 地図を埋め込めない | URL が必要なドキュメントツールでは delivery: "url" を、Google ドキュメントでは PNG または JPEG を要求してください。15 分の有効期限が過ぎた場合は新しいリンクを要求してください。ダウンロードリンクは秘密情報として扱い、それでも埋め込みに失敗する場合は不足している地図を報告してください。 |
| アシスタントが何度もサインインを求めてくる | 接続済みアプリ を確認してから再接続してください。接続解除後や長期間未使用のあとでは更新に失敗することがあります。有効な接続中に繰り返し表示される場合は報告してください。 |
サポートが必要な場合は、日付、アシスタント名、アカウントプラン/ワークスペース種別、設定手順のどの段階か、表示されているエラーを添えて support@waypoint.guru までメールしてください。パスワード、トークン、認可リンク、旅行の非公開内容は送らないでください。