メインコンテンツまでスキップ

接続方法

CoBrain は MCP ツール を通じて、お使いの AI エージェントから操作できます。Webアプリを開かなくても、チャットで「企画書からシステム境界を作って」のようにお願いするだけで、要求仕様書の作成を進められます。

MCP ツールとは​

MCP（Model Context Protocol） は、AI エージェントが外部サービスの機能を呼び出すための共通の仕組みです。CoBrain は要求仕様書づくりの機能を MCP ツールとして提供しており、Claude Code や GitHub Copilot など、MCP に対応した AI エージェントから利用できます。

必要なもの​

  • CoBrain アカウント - 普段ログインしているもの（ログイン方法）
  • 対応する AI エージェント - Claude Code や GitHub Copilot（VS Code）など、MCP に対応した AI エージェント
  • 接続先 URL - CoBrain の管理者からご案内します
注記

本ドキュメントでは代表例として Claude Code と GitHub Copilot（VS Code） の接続方法を案内します。MCP に対応した他の AI エージェントからもご利用いただけます。

接続手順​

接続は、お使いの AI エージェントに ①接続先を登録する → ②ログインする の 2 段階です。登録は最初に一度だけ行えば、次回以降はそのまま使えます。以下の <接続先 URL> は、管理者からお渡しするものに置き換えてください。

Claude Code​

Claude Code はターミナル（CLI）でも、VS Code などの拡張機能でも使えますが、接続方法は共通です。

① 接続先を登録する​

プロジェクトのルート直下に、接続設定ファイル .mcp.json を作成します（ファイルが無ければ新規作成します）。

{
  "mcpServers": {
    "cobrain-studio": { "type": "http", "url": "<接続先 URL>/mcp" }
  }
}

この .mcp.json を置いたフォルダーで Claude Code を起動すると、CoBrain が使えるようになります。リポジトリにコミットすれば、同じリポジトリを共有するメンバーにも接続先を配れます（ログインは各自で行います）。

どのフォルダーからでも使いたいとき

.mcp.json は、それを置いたフォルダーで起動したときだけ有効です。フォルダーごとに置かずに、自分のどのフォルダーからでも使いたい場合は、claude コマンドが使える環境で次のように登録します。登録は最初に一度だけで済みます。

claude mcp add --transport http --scope user cobrain-studio <接続先 URL>/mcp

--scope user を付けると、登録内容がホームディレクトリの ~/.claude.json に保存され、自分ならどのフォルダーから Claude Code を開いても使えるようになります。

② ログインする​

  1. Claude Code を起動し、/mcp と入力します。cobrain-studio が認証待ち（ログインが必要な状態）で表示されるので、選んで Authenticate に進みます。
  2. ブラウザでログイン画面が開いたら、普段の CoBrain アカウント でログインします。画面の指示に従ってアクセスを許可すると、接続が完了します。

GitHub Copilot（VS Code）​

① 接続先を登録する​

ワークスペースの .vscode/mcp.json に次を追加します（ファイルが無ければ新規作成します）。コマンドパレットの 「MCP: Add Server」 から追加することもできます。

{
  "servers": {
    "cobrain-studio": { "type": "http", "url": "<接続先 URL>/mcp" }
  }
}

設定を保存すると、cobrain-studio の定義の上に 「起動」 が表示されます。これをクリックしてサーバーを起動します（コマンドパレットの 「MCP: List Servers」 からも起動できます）。初回はログイン（次の手順）を求められます。

② ログインする​

  1. ログインを求められたら、ブラウザで 普段の CoBrain アカウント でログインし、アクセスを許可します。
  2. Copilot Chat を エージェントモード に切り替えると、cobrain-studio のツールが使えるようになります。
備考

GitHub Copilot からご利用いただくには、対応バージョンの VS Code と Copilot、そしてお勤め先の組織で外部ツールの利用が許可されている必要があります。組織の設定で制限されている場合は、CoBrain の機能が表示されません。

接続確認​

AI エージェントが使える機能の一覧に、cobrain_ で始まる項目（例: cobrain_create_system_boundary）が表示されれば接続できています。あとはチャットでお願いするだけです。

  • Claude Code … ターミナルで claude mcp list を実行すると接続状態を確認できます。セッション中は /mcp で各サーバーのツール数が見られます。
  • GitHub Copilot（VS Code） … コマンドパレットの 「MCP: List Servers」 で状態を確認できます。Chat の 「Configure Tools」 に cobrain_ 系のツールが並びます。

うまく表示されないときはトラブルシューティング — MCP ツール連携を参照してください。

注意事項​

  • スタジオ（作業のまとまり）の有効期限は作成から 7 日間 です。期限前に必要な成果物を手元に保存してください
  • 一日あたりのツール使用量とトークン消費量に上限があります（翌日にリセットされます）

詳しくはスタジオ機能 — 制約事項を参照してください。