この記事では、ChatGPT のデスクトップアプリ(ChatGPT Desktop)から Strap のボードを読み書きできるようにする方法を説明します。
ブラウザ版の ChatGPT から接続する場合はブラウザ版の ChatGPT と Strap を連携するを、ターミナルで使う Codex CLI から接続する場合はCodex CLI と Strap を連携するを参照してください。
はじめる前に
ChatGPT Desktop にログインしておきます。
ブラウザで Strap にログインできる状態にしておきます。接続の許可はブラウザで行います。
ワークスペースで外部アプリ連携(リモートMCP)の利用が許可されている必要があります。許可されていない場合は、ワークスペースのアドミンに確認してください(外部アプリ連携(リモートMCP)の管理・利用を許可する)。
API キーの発行は必要ありません。
ブラウザ版の ChatGPT で Strap を追加している場合、この手順は不要です。設定 > プラグイン の一覧に Strap が表示されていれば、そのまま使えます(ブラウザ版の ChatGPT と Strap を連携する)。この場合、MCP タブには表示されません。
ChatGPT Desktop から接続する
設定を開き、
プラグインを選びます。-
右上の
Addを押し、Add MCP serverを選びます。 -
カスタム MCP に接続するの画面で、次のように入力します。項目 入力する内容 名前 Strap(任意の名前で構いません)タイプ ストリーミング可能な HTTPを選びます。URL https://strap.app/mcpBearer トークン環境変数、ヘッダー、環境変数からのヘッダーは空のままで構いません。タイプの初期値は
STDIOです。ストリーミング可能な HTTPを選ぶまで URL の入力欄は表示されません。 保存するを押します。-
サーバーの一覧に追加した名前の行が表示されます。行の
認証するを押します。 ブラウザが開きます。Strap にログインしていない場合は、ログインから進めてください。
アクセスするワークスペースを選択で接続するワークスペースを選び、続けるを押します。選んだワークスペースのデータだけが連携の対象になります。-
許可する権限を確認し、
許可を押します。権限 内容 ボード・スペースの閲覧 アクセス権のあるスペース・ボードの一覧と、ボード内のエレメント・ページの読み取り ボードの作成と内容の編集・削除 ボードの新規作成、ページの追加・変更、図形やテキストなどボード内エレメントの作成・変更・削除 -
設定の一覧に戻り、追加した行から
認証するが消えていれば接続は完了です。
ChatGPT から操作できる範囲は、接続を許可したユーザー自身の閲覧・編集権限と同じです。アクセス権のないスペースやボードは操作できません。
許可の画面に Codex と表示されます
ChatGPT Desktop は、Strap への接続に Codex の仕組みを使います。そのため、許可の画面のアプリ名は ChatGPT ではなく Codex と表示されます。
あわせて、このカードには 未検証 と表示され、次の注意が出ます。
Strap で検証されていない動的登録クライアントです。リダイレクト先が正しいことを確認してください。
これは、お使いの端末で動くアプリが自分の身元を Strap に証明できないためで、接続の失敗ではありません。自分で始めた接続であれば、そのまま 許可 を押して問題ありません。
リダイレクト先が http://127.0.0.1: または http://localhost: で始まっていることを確認してください。身に覚えのない接続要求や、リダイレクト先が自分の端末以外を指している場合は 拒否 を押してください。
承認待ちになる場合
ワークスペースが承認制の場合、メンバーの接続はその場では成立せず、次のように表示されます。
ワークスペース管理者の承認待ちです。承認された後に (アプリ名) から再度接続してください。
アドミンが承認したあと、もう一度接続してください。承認の状況はワークスペースのアドミンに確認してください。
接続を確認する
設定 > プラグイン > MCP を開き、追加した行に 認証する が表示されていないことを確認します。表示されている場合は、認証がまだ済んでいません。
チャットで「Strap のスペース一覧を出して」と指示し、応答が返ることでも確認できます。
ターミナルの Codex CLI でも使う場合
ここで追加した接続先は、ターミナルの codex mcp list にも表示されます。Codex CLI からも Strap を使うときは、先に一覧を確認してください。すでに表示されていれば、改めて追加する必要はありません(Codex CLI と Strap を連携する)。
ブラウザ版の ChatGPT でも使う場合
ここで追加した接続先は、ブラウザ版の ChatGPT には引き継がれません。ブラウザ版からも使うときは、ブラウザ版であらためて追加と認証を行ってください。ブラウザ版は ChatGPT 側で開発者モードを有効にする必要があるなど、条件と手順が異なります(ブラウザ版の ChatGPT と Strap を連携する)。
うまくいかない場合
| 状況 | 確認すること |
|---|---|
| URL の入力欄が表示されない |
タイプ が STDIO のままになっています。ストリーミング可能な HTTP を選んでください。 |
| 保存しても認証が始まらない | 保存だけでは認証は始まりません。一覧の行にある 認証する を押してください。 |
| ブラウザが開かない | 一覧の 認証する をもう一度押します。 |
許可の画面で このワークスペースでは連携が停止されています と表示される |
ワークスペースで外部アプリ連携(リモートMCP)の利用が許可されていません。アドミンに確認してください。 |
許可の画面で このワークスペースで連携する権限がありません と表示される |
メンバーの利用が許可されていないか、そのワークスペースのメンバーではありません。アドミンに確認してください。 |
許可の画面で このリクエストは無効か期限切れです と表示される |
接続の要求から時間が経ちすぎています。接続元のアプリから接続をやり直してください。 |
許可の画面で セッションが切れました と表示される |
Strap に再度ログインしてから、接続をやり直してください。 |
| 承認待ちのまま使えない | アドミンが承認するまで利用できません。用途を伝えて承認を依頼してください。 |
接続していたのに Remote MCP is suspended for this workspace というエラーが返る |
ワークスペースで外部アプリ連携(リモートMCP)の利用が停止されています。アドミンに再開を依頼してください。再開されると、接続し直さずにそのまま使えるようになります。 |
| 接続していたのに急に使えなくなった | 接続が取り消されたか、ワークスペースの設定が変更された可能性があります(外部アプリ連携(リモートMCP)の管理・利用を許可する)。 |
ChatGPT 側の MCP の設定については、Model Context Protocol(OpenAI の公式ドキュメント)も参照してください。
接続を解除するとき
ChatGPT の設定から MCP サーバーを削除しても、Strap 側の接続許可は残ります。接続を確実に解除するには、ワークスペース設定の 外部アプリ連携 から取り消してください(外部アプリ連携(リモートMCP)の管理・利用を許可する)。