Archboard のサインインページが開かない
上のセットアップにサインイン用のコマンドがあれば、それを使ってください。ない場合は、アプリから Archboard を削除して、もう一度追加してください。アプリは接続時にサインインページを開きます。
連携 · MCP
Codex を Archboard に接続
Archboard の MCP サーバーを使うと、Codex はあなたの図の一覧表示、読み取り、作成、編集ができます。変更はキャンバスにライブで表示され、そのそばには、あなたの名前のラベルが付いた専用のカーソルが表示されます。
MCP サーバーの URL
https://getarchboard.app/mcpCodex について
Codex は OpenAI のコーディングエージェントです。MCP サーバーはコマンドラインから追加します。
Codex をセットアップ
Codex に Archboard を追加
ターミナルで次のコマンドを実行してください：
codex mcp add archboard --url https://getarchboard.app/mcpバージョン 0.147.0 以降が必要です。
ブラウザが開いたら、Archboard にサインインしてアプリを承認してください。
ブラウザが開かない場合は、次を実行してください：
codex mcp login archboardこのコマンドは、このコンピューター上の Codex の設定に Archboard を追加し、Codex がサインイン用にブラウザを開きます。
サインインしてアクセスを選ぶ
アプリが Archboard を開きます。Google または GitHub でサインインし、使える組織とワークスペースを選び、それぞれに閲覧・編集・削除のいずれかを設定して、名前を付けます。
図を頼む
エージェントに図の作成や更新を頼み、Archboard で図を開くと、変更がライブで届く様子を確認できます。
AI アプリが、OAuth でサインインするリモート MCP サーバーに対応している必要があります。
これらのプロンプトを試す
接続したら、Codex に普段の言葉で頼めます。たとえば：
- “Postgres と Redis を使った checkout サービスを Kubernetes 上に描いて。”
- “「決済」の図で checkout-api の隣にキャッシュを追加して。”
- “直前の変更を元に戻して。”
プラン上限
MCP は Free を含むすべてのプランで、エディタと同じプラン上限で動作します。エージェントのツール呼び出しには、さらに 1 分あたりのレート制限があります。Free では AI エージェントとライブで編集でき、チームメイトとのライブ編集には Pro または Enterprise のシートが必要です。
- Free：3 ダイアグラム、ダイアグラムあたり 15 ノード＋メモ・テキスト・描画・ステッカー・マインドマップのトピック 150 件。
- Pro と Enterprise：無制限のダイアグラムとノード、さらにチームメイトとライブで編集するためのシート。
トラブルシューティング
エージェントが図を読み取れるのに変更できない
接続時に読み取り専用のアクセスを承認した場合は、アプリをもう一度接続して編集を許可してください。そのワークスペースでのアプリの権限が「閲覧」の場合は、設定 → 連携アプリ で「編集」に変更してください。変更はアプリの次の呼び出しから適用されます。
エージェントがワークスペースや図を見つけられない
アプリが使えるのは、接続時に許可した組織とワークスペースです。設定 → 連携アプリ で変更でき、再接続は必要ありません。
エージェントがプラン上限に達したと伝える
MCP にはエディタと同じプラン上限があります。上限に達すると、エージェントはアップグレード用のリンクが付いた Archboard のメッセージを表示します。不要になったダイアグラムやノードを削除するか、Pro にアップグレードしてください。
呼び出しがレート制限で失敗する
エージェントのツール呼び出しには 1 分あたりのレート制限があります。少し待ってから、もう一度お試しください。小さな変更を何度も頼むより、まとめて少ない回数で頼むと効果があります。
アプリにカスタム MCP サーバーのオプションがない
アプリによっては、カスタム MCP サーバーを使えるのが特定のプランのみ、または管理者が有効にした後のみの場合があります。