{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"AIエージェントの使い方","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"aiエージェントの使い方","__idx":0},"children":["AIエージェントの使い方"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["このページでは、Codex、Claude Code、Cursor、Gemini CLIなどのAIコーディングアシスタントで ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ml-cli"]}," を使用する方法を説明します。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"エージェントにコピー","__idx":1},"children":["エージェントにコピー"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下のテキストをコピーしてAIアシスタントに貼り付けると、MoreLogin CLIが自動的にセットアップされます："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Set up MoreLogin CLI for me, then use it whenever I ask you to operate MoreLogin.\n\nOfficial docs:\nhttps://guide.morelogin.com/cli\n\nGoal:\n- Install or update `ml-cli`.\n- Verify MoreLogin Desktop local API access.\n- Read the built-in agent package and guide.\n- After setup, ask what MoreLogin task I want to automate first.\n\nFirst detect my OS and CPU architecture, then run the matching install command.\n\nWindows x64 PowerShell:\n\n```powershell\n$dir = \"$env:USERPROFILE\\.morelogin\\bin\"\nNew-Item -ItemType Directory -Force -Path $dir | Out-Null\nInvoke-WebRequest -Uri \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_window_x64_cli/2.6.3/MoreLogin_AirDrop_window_x64_cli_2.6.3.0.exe\" -OutFile \"$dir\\ml-cli.exe\"\n$userPath = [Environment]::GetEnvironmentVariable(\"Path\", \"User\")\nif ($userPath -notlike \"*$dir*\") { [Environment]::SetEnvironmentVariable(\"Path\", \"$userPath;$dir\", \"User\") }\n& \"$dir\\ml-cli.exe\" --version\n```\n\nmacOS Intel x64:\n\n```bash\nmkdir -p \"$HOME/.local/bin\"\ncurl -L \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_darwin_x64_cli/2.6.3/MoreLogin_AirDrop_darwin_x64_cli_2.6.3.0\" -o \"$HOME/.local/bin/ml-cli\"\nchmod +x \"$HOME/.local/bin/ml-cli\"\nexport PATH=\"$HOME/.local/bin:$PATH\"\nml-cli --version\n```\n\nmacOS Apple Silicon arm64:\n\n```bash\nmkdir -p \"$HOME/.local/bin\"\ncurl -L \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_darwin_arm64_cli/2.6.3/MoreLogin_AirDrop_darwin_arm64_cli_2.6.3.0\" -o \"$HOME/.local/bin/ml-cli\"\nchmod +x \"$HOME/.local/bin/ml-cli\"\nexport PATH=\"$HOME/.local/bin:$PATH\"\nml-cli --version\n```\n\nLinux x64:\n\n```bash\nmkdir -p \"$HOME/.local/bin\"\ncurl -L \"https://releases.morelogin.com/prod/MoreLogin_AirDrop_linux_x64_cli/2.6.3/MoreLogin_AirDrop_linux_x64_cli_2.6.3.0\" -o \"$HOME/.local/bin/ml-cli\"\nchmod +x \"$HOME/.local/bin/ml-cli\"\nexport PATH=\"$HOME/.local/bin:$PATH\"\nml-cli --version\n```\n\nAfter installation, run:\n\n```bash\nml-cli --help\nml-cli doctor --output-json\nml-cli agent-bootstrap\nml-cli agent-package\nml-cli agent-guide\n```\n\nFor long-term use, install persistent rules for my AI agent:\n\n```bash\nml-cli agent-list\nml-cli agent-init --agent <agent> --scope user --dry-run\nml-cli agent-init --agent <agent> --scope user --write\n```\n\nUse the correct `<agent>` value for my AI client. Supported values are listed by `ml-cli agent-list`, including `codex`, `claude-code`, `cursor`, `gemini`, `qwen-code`, `opencode`, `openclaw`, `trae`, `hermes`, `qclaw`, `easyclaw`, and `workbuddy`.\n\nUse `ml-cli` for MoreLogin browser profiles, environment lists, cloud phones, proxies, groups, tags, schedules, and local API status.\n\nDo not guess IDs, payload fields, or command formats. If unsure, inspect help first:\n\n```bash\nml-cli env --help\nml-cli cloudphone --help\nml-cli proxy --help\nml-cli schedule --help\n```\n\nOperation timing:\n- `env start` / `env open` takes 3-5 seconds; use `--timeout 30`.\n- `cloudphone power-on` / `cloudphone open` takes 30-90 seconds; always use `--timeout 120`.\n- All other commands complete within the default `--timeout 15`.\n\nNatural language routing rules:\n- \"How many browser profiles are on the first page?\" -> run `ml-cli env list --page-no 1 --page-size 20`, then count `data.dataList`.\n- \"Open P-1\" -> run `ml-cli --timeout 30 env open --name P-1`.\n- \"Find browser profiles by group, tag, name, or remark containing Amazon\" -> run `ml-cli env find --keyword Amazon`.\n- \"Open the profile whose group, tag, name, or remark contains Amazon\" -> run `ml-cli --timeout 30 env open --keyword Amazon`.\n- \"Open cloud phone CP-204 and show the window\" -> run `ml-cli --timeout 120 cloudphone open --keyword CP-204 --headless false`.\n- \"Close cloud phone CP-204\" -> run `ml-cli --timeout 30 cloudphone close --keyword CP-204`.\n- \"Create a new browser profile\" -> run `ml-cli env create-quick`.\n- \"Delete browser profile P-1\" -> find it first with `ml-cli env find --name P-1`, confirm with the user, then run `ml-cli env delete --env-ids <id>`.\n- \"Create a proxy\" -> run `ml-cli proxy create --proxy-ip <ip> --proxy-port <port> --proxy-provider 0`.\n- \"Show all tags\" -> run `ml-cli tag list`.\n- \"Create a group called test\" -> run `ml-cli group create --group-name test`.\n- \"Set proxy for profile P-1\" -> find the profile first, then run `ml-cli env set-proxy --env-ids <id> --proxy-ip <ip> --proxy-port <port> --proxy-type 0 --proxy-provider 0`.\n\nCandidate selection rule:\n- `env open`, `cloudphone open`, and `cloudphone close` may operate only when exactly one candidate matches.\n- If zero or multiple candidates match, show the candidates and ask me which one to operate.\n\nLocal access rule:\nMoreLogin CLI connects to `127.0.0.1:<port>`, usually `127.0.0.1:40000`. Started browser profiles may expose `127.0.0.1:<debugPort>`.\nIf Codex, Claude Code, Cursor, or another AI client reports `connect EPERM 127.0.0.1:40000`, `connect EPERM 127.0.0.1:<debugPort>`, `connection refused`, `request timeout`, or `Could not detect MoreLogin port`, treat it as local sandbox/permission first. Request local access approval or elevated execution and rerun the same command. Do not repeatedly start the same profile after an EPERM error; check status first.\n\nWhen a command fails, show the original MoreLogin response. Do not redact proxy passwords, phone numbers, device identifiers, or other fields unless I explicitly ask you to. For scripts, add `--fail-on-business-error` when a non-zero top-level JSON `code` should fail the command.\n\nFuture updates:\n- To update `ml-cli`, run `ml-cli self-update`. Or rerun this setup prompt and overwrite the existing binary with the newest official download.\n- To update persistent agent rules, rerun `ml-cli agent-init --agent <agent> --scope <scope> --write`.\n- Restart the AI agent if it only loads memory/rules files on startup.\n\nAfter verification, tell me:\n- install path\n- `ml-cli --version`\n- `ml-cli doctor --output-json` result\n- available top-level commands\n\nThen ask me what MoreLogin task I want to automate first.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["インストール済みのCLIから同じテキストを生成することもできます："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli install-prompt\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"agent-guide-コマンド","__idx":2},"children":["Agent Guide コマンド"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["インストール後、エージェントは組み込みガイドを読む必要があります："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli agent-guide\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ガイドはエージェントに以下を伝えます："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ml-cli"]}," をいつ使うか"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["コマンド形式を発見する方法"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["自然言語をコマンドにマッピングする方法"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["いつ確認を求めるか"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connect EPERM 127.0.0.1:40000"]}," などのローカルサンドボックスエラーの処理方法"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"doctor-コマンド","__idx":3},"children":["Doctor コマンド"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["doctor"]}," を使用してローカルAPI接続を確認します："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli doctor\nml-cli doctor --output-json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["doctor"]}," はポート検出を確認し、MoreLoginのローカルステータスエンドポイントを呼び出します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ブラウザプロファイルの便利コマンド","__idx":4},"children":["ブラウザプロファイルの便利コマンド"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ユーザーが名前でプロファイルを参照する場合、これらのコマンドを使用します："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli env find --name P-1\nml-cli env find --keyword Amazon\nml-cli env open --name P-1\nml-cli env open --keyword \"team-a\"\nml-cli env open --name P-1 --exact\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["env find --keyword"]}," は、MoreLoginローカルAPIを通じて環境名、グループ名、タグ名、備考を検索します。"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["env open"]}," は、正確に1つの候補が一致した場合にのみプロファイルを起動します。複数のプロファイルが一致する場合、候補リストを表示して何も起動せずに終了します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"クラウドフォンの便利コマンド","__idx":5},"children":["クラウドフォンの便利コマンド"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ユーザーが名前でクラウドフォンを参照する場合、これらのコマンドを使用します："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ml-cli cloudphone find --name CP-1\nml-cli cloudphone find --keyword \"android-test\"\nml-cli --timeout 120 cloudphone open --name CP-1\nml-cli --timeout 120 cloudphone open --keyword \"android-test\"\nml-cli --timeout 120 cloudphone open --name CP-1 --headless false\nml-cli --timeout 30 cloudphone close --name CP-1\nml-cli --timeout 30 cloudphone close --keyword \"android-test\"\nml-cli --timeout 120 cloudphone open --name CP-1 --exact\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudphone find --keyword"]}," は、MoreLoginローカルAPIを通じてクラウドフォン名、グループ名、タグ名、備考を検索します。"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudphone open"]}," と ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudphone close"]}," は、正確に1つの候補が一致した場合にのみ動作します。複数のクラウドフォンが一致する場合、候補リストを表示して状態を変更せずに終了します。"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--headless"]}," について：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," はクラウドフォンのウィンドウを表示し、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," は表示しません。APIのデフォルト値は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," です。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"自然言語の例","__idx":6},"children":["自然言語の例"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["セットアップ後、以下のように質問できます："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"MoreLoginの最初のページにブラウザプロファイルはいくつありますか？\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"MoreLoginブラウザプロファイルの最初のページを表示してください。プロファイル名、ID、ステータスを含めてください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"P-1プロファイルを開いてください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"P-1プロファイルがすでに実行中かどうか確認してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"P-1プロファイルを閉じてください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"名前にAmazonを含むブラウザプロファイルを検索してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"環境名、グループ名、タグ名、または備考にAmazonを含むプロファイルを検索してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"グループまたはタグにAmazonを含むブラウザ環境を開いてください。複数ある場合は、まず候補を表示してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"最初のブラウザプロファイルを起動して、デバッグポートを教えてください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"MoreLoginのすべてのグループを表示してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"MoreLoginのすべてのタグを表示してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"プロキシレコードの最初のページを表示してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"クラウドフォンリストを表示してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"CP-1クラウドフォンを開いてください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"グループ、タグ、または備考にAndroidを含むクラウドフォンを検索してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"名前、グループ、タグ、または備考にCP-204を含むクラウドフォンを開き、ウィンドウを表示してください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"CP-1クラウドフォンを閉じてください。\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"ml-cliのヘルプを読んで、一般的なブラウザプロファイルコマンドをまとめてください。\n","lang":"text"},"children":[]}]},"headings":[{"value":"AIエージェントの使い方","id":"aiエージェントの使い方","depth":1},{"value":"エージェントにコピー","id":"エージェントにコピー","depth":2},{"value":"Agent Guide コマンド","id":"agent-guide-コマンド","depth":2},{"value":"Doctor コマンド","id":"doctor-コマンド","depth":2},{"value":"ブラウザプロファイルの便利コマンド","id":"ブラウザプロファイルの便利コマンド","depth":2},{"value":"クラウドフォンの便利コマンド","id":"クラウドフォンの便利コマンド","depth":2},{"value":"自然言語の例","id":"自然言語の例","depth":2}],"frontmatter":{"seo":{"title":"AIエージェントの使い方"}},"lastModified":"2026-07-06T01:44:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/cli/agent","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}