bridgeapp

BridgeApp プラグイン

コーディングエージェントを MCP 経由で BridgeApp ワークスペースに接続する公式プラグインです。サインインしたアカウント自身の権限の範囲で、タスク、チャット、スレッド、ページ、プロジェクトを読み取り、操作できます。

Claude と Claude Code

BridgeApp は Claude ディレクトリにあります。 BridgeApp プラグイン を開いてインストールします。または、Web 版 Claude、デスクトップ、Cowork で Settings → Plugins → Discover を開き、BridgeApp を検索してインストールします。その後、プラグインの Connectors タブを開き、BridgeApp を選択して Connect をクリックし、サインインします。

Claude アカウントに追加したプラグインは、Claude Code が同じアカウントでサインインすると、自動的に bridgeapp@synced として Claude Code でも利用できます（Claude Code 2.1.273 以降）。Claude Code を再起動するか、/reload-plugins と入力して読み込みます。BridgeApp から求められた場合は、/mcp からサインインします。

Claude アカウントを使わない Claude Code（API キー、Amazon Bedrock、Google Vertex AI）は、代わりにこのリポジトリのマーケットプレイスからプラグインをインストールします。Claude アカウントでも使う場合は、この方法を使わないでください。ディレクトリ版はすでに同期されており、2 つ目のコピーをインストールすると、そちらが置き換わりになります。

claude plugin marketplace add MathAndMagic/bridgeapp-plugin
claude plugin install bridgeapp@bridgeapp

続いてサインインします。これには対話型ターミナルが必要なため、エージェントに依頼せず、ご自身で実行してください。Claude Code では、手動で bridgeapp サーバーがすでに登録されていない限り、プラグインが提供するサーバーを plugin:<plugin>:<server> として扱います。手動で登録済みの場合はそのエントリが維持され、プラグイン版は追加されません。その場合、サインインにはベア名を使います。

claude mcp login plugin:bridgeapp:bridgeapp || claude mcp login bridgeapp

Codex と ChatGPT

同じプラグインを Codex にインストールできます。MCP サーバーとスキルが一緒にインストールされます。

codex plugin marketplace add MathAndMagic/bridgeapp-plugin
codex plugin add bridgeapp@bridgeapp

Codex では、初めてツールを使うときに BridgeApp へのサインインを求められます。ChatGPT デスクトップアプリは Codex と ~/.codex を共有するため、上記のインストールで両方に対応できます。アプリからインストールする場合は、Plugins を開き、Add marketplace、次に Add from a repository を選択し、MathAndMagic/bridgeapp-plugin と入力して、そのマーケットプレイスから BridgeApp をインストールします。

マニフェストは .codex-plugin/plugin.json に、マーケットプレイスは .agents/plugins/marketplace.json にあります。どちらも Claude Code と Cursor のマニフェストと同じ skills/ および .mcp.json を参照します。マニフェストには、OpenAI ディレクトリの掲載情報と審査メタデータ（テストケース、コマースに関する申告、リリースノート）も extensions["com.openai"] 内に含まれています。審査用の認証情報とデモ動画の URL は OpenAI ポータルに入力し、このリポジトリには記載しません。

その他のエージェント

ストリーミング可能な HTTP と OAuth に対応する任意の MCP クライアントは、次の URL を指定します。

https://mcp.bridgeapp.ai/mcp

認可サーバーと bridgeapp:mcp スコープは、https://mcp.bridgeapp.ai/.well-known/oauth-protected-resource から自動的に検出されます。

各クライアント向けの手順（エージェントが自分で実行できる手順を含む）は、agent-setup.md にあります。これは https://bridgeapp.ai/agent-setup.md および各ワークスペースホストの /agent-setup.md で公開されています。

このファイルがマスターコピーです。同じファイルは bridgeapp-web（すべてのワークスペースホストで提供する public/agent-setup.md）と bridge-website（エイペックスドメインで提供する public/agent-setup.md）にも含まれています。このファイルをここで編集し、同じ作業の中で両方にコピーしてください。内容はバイト単位で一致させてください。

セルフホスト型ワークスペース

上記の URL はすべてホステッドサービスのものです。BridgeApp はお客様自身のインフラストラクチャ上でも、お客様が選んだドメインで動作します。プラグインにはホステッドエンドポイントが .mcp.json に含まれています。意図的に単なる値として記述しています。Claude Code はバージョンによってプラグインの設定を安定して置換できず、サーバーがひそかに登録に失敗するより、固定 URL のほうが望ましいためです。セルフホスト型ワークスペースでは、まずプラグインをインストールしてください。スキルはどのワークスペースにも適用できます。その後、ワークスペースの Agents → Connect Apps ページに表示されている、独自のエンドポイントを登録してください。

Claude アカウントを使う場合：Settings → Connectors を開き、+ をクリックして、Add custom connector を選び、ワークスペースのエンドポイントを貼り付けて接続します。プラグインに付属する BridgeApp コネクターは接続しないでください。同じアカウントでサインインした Claude Code は、両方を認識します。

Claude アカウントを使わない Claude Code：

claude mcp add --scope user --transport http bridgeapp https://mcp.example.com/mcp
claude mcp login bridgeapp

Codex と ChatGPT デスクトップアプリでは、プラグインの bridgeapp エントリーを置き換えないよう、独自の名前を指定します（add を実行するとサインインが開始されます）。

codex mcp add bridgeapp-workspace --url https://mcp.example.com/mcp

プラグイン独自のホステッドサーバーは認証されていない状態のままにしてください。サインインはせず、無視するか削除できます。ワークスペースへのリンクはサーバーの build_bridgeapp_link ツールから取得するため、セルフホスト型ドメインが自動的に含まれます。

ここに含まれるもの

plugins/bridgeapp/
  .claude-plugin/plugin.json   Claude Code manifest
  .cursor-plugin/plugin.json   Cursor manifest
  .codex-plugin/plugin.json    Codex / ChatGPT manifest (OpenAI directory listing and review metadata)
  .mcp.json                    the hosted BridgeApp MCP server
  skills/                      how to work with a BridgeApp workspace

1 つのプラグインですべてのクライアントに対応します。マニフェストは異なりますが、MCP サーバーとスキルは共通です。

スキル

• bridgeapp-task — タスクのプラン、コメント、サブタスク、ブロッカーに加え、リポジトリとチームのワークフローが記録されている唯一の場所であるプロジェクト概要を参照しながら、タスクに取り組みます。
• bridgeapp-thread — 共有メッセージやスレッドを、内部のエージェントのトランスクリプトも含めて最後まで読みます。BridgeApp からエージェントにメッセージが共有されたときに実行されます。
• bridgeapp-context — タスク、メッセージ、ページから、それらに関連するすべての情報をたどり、どこで止めるべきかを判断します。
• bridgeapp-investigation — リポジトリと BridgeApp の両方にまたがる手がかりをたどってバグを診断したり、何について誰が決定したのかを調べたりします。設計上、読み取り専用です。
• bridgeapp-task-creation — 重複チェックを最初に行い、依頼を適切な形式のタスクにします。
• bridgeapp-spec — すでに下された決定から仕様書を作成し、矛盾や不足について作成者に確認します。

スキルに手順が含まれているため、共有リンクには内容だけを含めれば十分です。BridgeApp の共有アクションは、会話のコピーや指示の一覧ではなく、メッセージへの参照を送信します。

接続の確認

list_projects を呼び出します。リストが空でも問題ありません。接続が機能しており、アカウントにまだプロジェクトがないことを意味します。