Claude Code・Codex からデプロイ:MCP の設定
Agent Lab MCP を Claude Code、Codex、Claude Desktop などの MCP クライアントに接続し、プロジェクトの作成、アップロード、公開を任せます。サインインは 1 回だけです。
1. Agent Lab MCP に接続する#
使っているツールに接続を追加します。Claude Code と Codex はターミナルでコマンドを実行し、Claude Desktop は設定画面で追加します。acme は組織名に置き換えてください。コンソールの「MCP」ページには組織名入りのコマンドと接続名 agentlab-<組織名> が表示されます。
claude mcp add --transport http --scope user agentlab-acme https://mcp.agentlab.cresclab.com/mcpClaude Desktop(または Web 版の claude.ai)でカスタムコネクタを追加します。Team または Enterprise プランでは、組織の owner が先に Organization settings › Connectors(Add › Custom › Web)で追加し、メンバーは Customize › Connectors で Connect を選び、ブラウザでサインインして組織を選んでから手順 4 に進みます。Free プランで追加できるカスタムコネクタは 1 つです。
- Customize › Connectors(古いバージョンでは Settings › Connectors)を開き、+ Add › Add custom connector を選びます。
- 名前に
agentlab-acme、URL にhttps://mcp.agentlab.cresclab.com/mcpを入力し、Continue を選びます。次の画面には検出された認証設定が表示されるので、もう一度 Continue を選びます。 - Authentication で Sign in now を選び、OAuth client は Use Claude's published identity (Recommended) のまま Add を選びます(Register automatically は Agent Lab がまだ対応していないため選ばないでください)。開いたブラウザでサインインして組織を選びます。
- 新しい会話を始め、入力欄の左下の + › Connectors で
agentlab-acmeをオンにします。 - その会話で「Agent Lab のプロジェクトを一覧表示して」と聞きます。Claude が
sites_listを呼び出してプロジェクトを表示すれば接続完了です。ツールが表示されない場合は、Claude Desktop を完全終了して再起動し、もう一度試してください。
Claude Desktop の通常の会話(Chat)からはパソコン上のフォルダーを読めません。状態の確認、設定の変更、バージョンの公開はできます。ローカルのプロジェクトをアップロードするには Claude Code(ターミナル、または Claude Desktop の Code タブ)を、GitHub からデプロイするにはコンソールでリポジトリを連携してください。
codex mcp add agentlab-acme --url https://mcp.agentlab.cresclab.com/mcp
codex mcp login agentlab-acme~/.codex/config.toml に書いてから codex mcp login agentlab-acme を実行しても接続できます。
[mcp_servers.agentlab-acme]
url = "https://mcp.agentlab.cresclab.com/mcp"次の URL を HTTP タイプの MCP サーバーとして追加します。
https://mcp.agentlab.cresclab.com/mcpOAuth 2.1(PKCE)に対応し、Client ID Metadata Documents または動的クライアント登録で自身を示すクライアントが必要です。Cursor、VS Code、Windsurf、Gemini CLI、Qwen Code なども接続できます。サインインはブラウザーで開きます。OAuth を使わず固定のヘッダーしか送れないクライアントは、現時点では接続できません。
ブラウザでサインインページが開きます。サインインして組織を選ぶと接続が完了します。
パスワード、トークン、API キーは不要です
認可はブラウザで行います。この接続でできることは、あなたがコンソールでできることと同じで、それ以上はありません。
上のように Claude Code を開く前に接続を追加しておけば、/mcp からサインインを終えた時点でツールを使えます。再起動は不要です。すでに開いていた Claude Code のセッション内で追加した接続だけは、そのセッションの /mcp に表示されません。終了して同じフォルダで claude --continue を実行すると、会話を引き継げます。Claude Desktop のコネクタは、新しい会話でオンにすれば使えます。ツールが表示されないときだけ、Claude Desktop を完全に終了して再起動してください。Codex では、セッションを始める前にサインインするか、サインイン後に新しいセッションを始めます。あとでツール一覧が古いと感じたら、サーバーに再接続してください(Claude Code では /mcp › サーバー › Reconnect)。サインインし直す必要はありません。
このサインインでは、プロジェクト、データベース、キャッシュをまとめて許可します。どれも、組織でのあなたのロールで可能な範囲までです。ツールがそれより少なく求めれば、許可も少なくなります。
組織 owner/admin と当該 DB 管理者には既に writer 権限があり、追加の grant は不要です。他のメンバーのみ reader/writer grant が必要です。SQL 承認後はツールを呼び、実際に拒否された場合だけ権限変更を依頼してください。製品の DB テーブルは databases_apply_migration で作成し、databases_connect_app でプロジェクトの接続を設定できます。UI での手動建表は不要です。
2. デプロイを依頼する#
プロジェクトのフォルダで、デプロイガイドを読んで手順どおりに進めるよう依頼します。
https://app.agentlab.cresclab.com/agent/deploy.md を読み、その手順に従って、このフォルダを Agent Lab の組織 acme にデプロイしてください。AI ツールがこのアドレスを読めないときは、同じガイドが https://agentlab.cresclab.com/agent/deploy.md にもあります。Agent Lab MCP の接続後は、docs_read でもこのドキュメントを読めます。
このドキュメントを調べてもらうときは、ページの Markdown アドレスか、目次 https://agentlab.cresclab.com/docs/ja/llms.txt を渡します。MCP サーバーの docs_read ツールでも同じページを読めます。
毎回この方法でデプロイさせるには、同じ文をプロジェクトの AGENTS.md(Codex)または CLAUDE.md(Claude Code)に書きます。
デプロイを頼まれたら https://app.agentlab.cresclab.com/agent/deploy.md を読み、その手順で Agent Lab の組織 acme にデプロイする。読めないときは https://agentlab.cresclab.com/agent/deploy.md を読むか、docs_read を呼ぶ。ChatGPT や Web 版の Claude を使っていますか?
これらのツールはお使いのコンピューター上のファイルを読めません。プロジェクトを zip に保存してコンソールのプロジェクトのページでアップロードするか、GitHub からデプロイしてください。
3. AI ツールが行うこと#
- プロジェクトを探す、または作成する ラベルは再利用できないため、作成前にアドレスラベルを確認します。
- アップロードする プラットフォームが指定した宛先に zip を直接アップロードします。ファイルは会話を経由しません。
- ビルドを待つ ビルドが成功するか失敗するまで、バージョンの状態を確認します。
- 公開の前に確認する どのバージョンを公開するかを伝え、あなたの同意を待ちます。
シークレットは自分で入力します
AI ツールは入力場所を案内しますが、シークレットを会話に貼るよう求めることはありません。
ツールの一覧は MCP ツールをご覧ください。コードが PostgreSQL、MySQL、Redis を使う場合は、AI ツールがそれも作成して接続します。データベースと Redis キャッシュをご覧ください。
4. 接続でコンピューター上の何が変わるか#
接続で書き込まれるのは、ツールの MCP 設定に追加されるサーバー 1 件と、保存されるサインイン情報 1 件だけです。
| ツール | 追加されるもの | 場所 |
|---|---|---|
| Claude Code | mcpServers の下の agentlab-acme 1 件 | ~/.claude.json。手順 1 のとおり --scope user なら、どのフォルダでも使えます。--scope を付けないと同じファイルに、いまのフォルダ専用として書かれます。--scope project はプロジェクトに .mcp.json を作り git で共有されるため、おすすめしません。 |
| Claude Code | サインイン情報 | macOS のキーチェーン。Linux と Windows では ~/.claude/.credentials.json |
| Codex | [mcp_servers.agentlab-acme] テーブル | ~/.codex/config.toml |
| Codex | サインイン情報 | Codex が MCP のサインインを保存する場所(mcp_oauth_credentials_store の設定により、システムのキーリングまたはファイル) |
| Claude Desktop、claude.ai | カスタムコネクタ | Claude のアカウント。コンピューター上のファイルではなく、claude_desktop_config.json も変わりません。 |
| その他のクライアント | サーバー設定 1 件 | クライアントの MCP 設定 |
変わらないもの
- スキル、スラッシュコマンド、フック、プラグイン、サブエージェント、他の MCP サーバー。Agent Lab はどれもインストールしません。
settings.json、権限設定、使うモデル。ツールの確認で「今後確認しない」を選んだ場合は、他のツールと同じくツール側が記録します。CLAUDE.mdとAGENTS.md。手順 2 の 1 文は任意で、入れるかどうかはあなたが決め、あなたが追加します。- コンピューターには何もインストールされず、何も動きません。サーバーはリモートにあるので、パッケージも
npxコマンドも常駐プロセスもありません。
ツール名には接続名が付きます(Claude Code では mcp__agentlab-acme__sites_list など)。そのため、同じ名前のスキルや他のサーバーのツールを置き換えることはありません。エージェントがこれらを使うのは、Agent Lab のことを頼んだときです。
元に戻すには: Claude Code では claude mcp remove --scope user agentlab-acme を実行します。保存されたサインイン情報も消すなら、先に /mcp で Clear authentication を選びます。Codex では codex mcp remove agentlab-acme を実行します。Claude Desktop では Customize › Connectors でコネクタを削除します。Agent Lab 側でも接続を終えるには、コンソールの「AI ツールでデプロイ」ページで、この接続を削除します。