AI連携(MCP)へ

OSAHOU / 接続ガイド

いつものAIを、
案内づくりのパートナーに。

ChatGPT・Claudeから、OSAHOUの下書きを読み込み、整える。
接続の準備から最初の会話まで、順番に説明します。

公式手順の確認日:

Before you start

接続前の準備

このページは、自分の案内を編集するStudio MCPの手順です。次の準備を済ませてから、使いたいAIの手順に進みます。

  • OSAHOUの事業者アカウントでログインできること。
  • 対象の組織に所属していること。下書きを変更する場合は編集権限が必要です。
  • ChatGPTまたはClaudeで、カスタムMCP接続を利用できるアカウント・権限があること。
  • 使うAIのOAuth Client IDと戻り先URL(Callback / Redirect URI)がOSAHOUに事前登録されていること。

初回はOSAHOUの運用担当者による登録が必要です

現在は、接続URLを入力するだけで全員が接続できる状態ではありません。使うAIとその設定画面に表示される戻り先URLを伝え、登録済みのClient IDを受け取ってください。戻り先URLが表示されない場合も、推測せず運用担当者に確認します。

一般の利用者がOSAHOUの画面からClient IDを発行する機能や、自動クライアント登録はありません。パスワード・APIキー・アクセストークンを会話に貼り付ける必要はありません。

Studio MCP

共通の接続URL

https://mcp.osahou.pro/studio

Connect / 01

ChatGPTに接続する

Web版の開発者モードを使います。公式案内の対象はPlus・Pro・Business・Enterprise・Educationです。組織で利用する場合は、管理者の利用設定も確認してください。

  1. Web版ChatGPTで開発者モードを有効にする

    ChatGPTを開きSettings → Security and login → Developer mode をオンにします。日本語表示では「設定」「セキュリティとログイン」「開発者モード」に相当する項目を探します。

  2. MCPアプリを新規作成する

    ChatGPT Pluginsを開き、から開発者モードのアプリを作成します。作成ボタンが見えないときは、開発者モードとワークスペースの権限を確認します。

  3. OSAHOUの接続情報を入力する

    名前・サーバーURL・認証方式を次のように設定します。OAuthのクライアント情報には、事前登録したClient IDを指定します。

    接続画面に入力する内容
    名前OSAHOU Studio
    MCPサーバーURLhttps://mcp.osahou.pro/studio
    認証OAuth(認可コード + PKCE)
    OAuth Client IDOSAHOUの運用担当者から案内された、登録済みのID
    Client Secret空欄。現在のOSAHOUは、シークレットを使わない公開クライアント方式です。

    OSAHOUは現在、クライアントの自動登録に対応していません。Client IDを空欄にして自動登録を進めず、接続前の準備を済ませてください。シークレットが必須で先へ進めない場合も、任意の文字列は入力せず運用担当者に確認します。

  4. OSAHOUにログインして接続を許可する

    作成・接続を進めるとOSAHOUの認可画面が開きます。事業者アカウントでログインし、表示された操作の範囲を確認して「接続を許可」を選びます。一般利用者アカウントの場合は、事業者利用の有効化が表示されることがあります。

  5. 会話でOSAHOU Studioを選ぶ

    作成したアプリは設定のDraftsで確認できます。新しい会話を開き、入力欄の+ → Developer modeからOSAHOU Studioを選択します。アプリを作成した後も、会話で使用するアプリの選択が必要です。

  6. 一覧取得で接続を確認する

    下の確認用メッセージを送ります。書き込みの確認が表示されたら、対象の案内と変更内容を確認してから許可します。利用できるツールが古い場合は、アプリの詳細画面で更新してください。

手順の出典:OpenAI公式 — ChatGPT Developer mode ↗

Connect / 02

Claudeに接続する

Web版・デスクトップ版のカスタムコネクタを使います。公式案内ではFree・Pro・Max・Team・Enterpriseに対応し、Freeはカスタムコネクタ1件までです。

Team・Enterpriseの方へ

先にOwner / Primary OwnerがOrganization settings → Connectors → Add → Custom → Webからサーバーを追加します。その後、各メンバーが自分のConnectorsから接続・認可します。全員で同じOSAHOUのログイン情報を共有する必要はありません。

  1. コネクタの設定を開く

    Web版またはデスクトップ版のClaudeで、Customize → Connectorsを開きます。日本語表示では「カスタマイズ」「コネクタ」に相当します。+ → Add custom connectorを選択します。

  2. 名前とMCPサーバーURLを入力する

    名前にOSAHOU Studio、URLにhttps://mcp.osahou.pro/studioを入力します。OSAHOU Studioはインターネット経由のコネクタです。ローカルサーバー用の設定ファイルの編集やコマンドの実行は必要ありません。

  3. Advanced settingsにClient IDを設定する

    Advanced settingsを開き、OSAHOUに事前登録したClient IDを入力します。現在の接続方式ではClient Secretを空欄にします。

    接続画面に入力する内容
    名前OSAHOU Studio
    MCPサーバーURLhttps://mcp.osahou.pro/studio
    認証OAuth(認可コード + PKCE)
    OAuth Client IDOSAHOUの運用担当者から案内された、登録済みのID
    Client Secret空欄。現在のOSAHOUは、シークレットを使わない公開クライアント方式です。

    Client IDの登録がまだの場合は、接続前の準備を先に完了してください。

  4. 追加して、OSAHOUとの接続を許可する

    Addで保存し、コネクタのConnectを選びます。開いたOSAHOUの認可画面で事業者アカウントにログインし、許可する操作を確認して「接続を許可」を選びます。

  5. 会話でコネクタを有効にする

    新しい会話の入力欄で+ → Connectorsを開き、OSAHOU Studioをオンにします。続けて確認用メッセージを送って、案内の一覧を取得できることを確認します。

手順の出典:Claude公式 — カスタムコネクタの接続 ↗ / 利用プランとコネクタ管理 ↗

First conversation

接続できたか確認する

最初は一覧を読むだけの操作で確認します。AIの会話でOSAHOU Studioを選んでから、次のメッセージを送ってください。

OSAHOU Studioのlist_my_osahouで、私がアクセスできる案内の一覧を確認してください。この段階では作成・更新はしないでください。

list_my_osahouの実行結果として案内の一覧が返れば接続成功です。「0件」も正常な結果の場合があります。認証エラーや権限エラーは、下の対処を確認します。

次に、下書きの改善を相談する

OSAHOU Studioを使って、先ほど選んだ案内の下書きを読み込んでください。来店から退店までの流れをわかりやすくする改善案を、変更前に説明してください。

対象の案内名・IDを確認してから変更を依頼し、最後にOSAHOUの管理画面で下書きと検証結果を確認してください。

公開は、管理画面で人が確認して行います

Studio MCPでできるのは、許可された下書きの作成・更新・検証と、公開前確認への依頼までです。AIに接続しただけで案内が公開されたり、マップに掲載されたりすることはありません。

Troubleshooting

困ったときは

開発者モードやコネクタの追加が見つからない

対応プランと、現在選択している個人用・組織用のワークスペースを確認してください。組織では管理者の設定によって利用できない場合があります。画面名は更新されるため、ページ末尾の公式手順も参照してください。

「OAuthクライアントまたはRedirect URIが不正」と表示される

OSAHOUに登録したClient IDと、AI側のOAuth Client IDが一致しているか運用担当者に確認してください。戻り先URLも完全一致が必要です。ChatGPT用とClaude用の情報を取り違えていないか確認します。利用者側で戻り先URLを書き換えて回避することはできません。

「認可コードが無効」や「PKCE検証に失敗」と表示される

認可コードは1回限り・10分間有効です。古い認可画面や戻るボタンから再送せず、AI側のコネクタ設定から接続をやり直してください。繰り返す場合は、AI側のPKCE S256対応を運用担当者に確認します。

接続URLをブラウザで開くと認証エラーになる

Studio MCPのURLはAIクライアント用です。ブラウザで直接開いたときに認証を求められるのは通常の動作です。ChatGPT・Claudeのコネクタ設定からOAuth認証を進めてください。DNSや証明書のエラーの場合は公開設定の問題なので、運用担当者に連絡します。

一度使えたのに、しばらくすると認証エラーになる

現在のアクセストークンは1時間で期限切れになります。自動更新には対応していないため、AI側の設定から再接続してOSAHOUの認可をやり直してください。必要に応じて切断してから接続します。

接続できたが、案内が空・編集できない

OSAHOUでログインしたアカウントと所属組織を確認します。一覧が空でも接続自体は成功している場合があります。編集には対象組織の編集権限と、認可画面で許可した下書き操作の範囲が必要です。OSAHOUの管理画面でも同じ案内を開けるか確認してください。

公開案内の検索しかできない

接続先がGuide MCPの /guide になっていないか確認してください。自分の下書きの作成・更新にはStudio MCPの /studio とOAuth認証が必要です。

接続を解除したい

ChatGPTのアプリ設定、またはClaudeのConnectorsでOSAHOU Studioを切断します。これによりAI側での利用を停止できます。OSAHOU側の発行済みトークンを直ちに失効させる必要がある場合は運用担当者に依頼してください。現在、OSAHOUの設定画面には個別のMCP接続を失効する操作はありません。

Guide MCP

公開されている案内をAIから使う場合

案内の検索や、共有URLの公開手順を読みたい場合は、Guide MCPを別のコネクタとして追加します。名前をOSAHOU Guide、URLを次の値にし、認証方式を選べる場合は認証なし(No Authentication)にします。公開案内の検索・取得にはStudio用のClient IDは不要です。

Guide MCPhttps://mcp.osahou.pro/guide

Guide MCPでは自分の下書きや組織の非公開情報にはアクセスできません。検索対象はマップ掲載済みの案内です。

接続できたら、案内づくりを始めましょう。

AI連携の管理画面へ