n naroドキュメント

AI エージェントでデプロイ

naro はターミナルから操作されることを前提に作られていて、そこにはエージェントのターミナルも含まれます。URL ひとつでエージェントはデプロイの仕方を覚え、MCP サーバーを足せばライフサイクル全体をツールとして握れます。

URL ひとつをエージェントに渡す

naro.sh/llms.txt は機械のために書かれたプレーンテキストです。取得したエージェントは、何もインストールせず naro の予備知識もないまま、コマンドと JSON の契約とエラーコードを覚えます。

naro.sh/llms.txt

またはこのプロンプトを貼る

ターミナルを扱えるエージェントにそのまま渡してください。このドキュメントがどの言語でもプロンプトは英語のままです — 読み物ではなく、モデルへの入力だからです。

Help me deploy this project to naro. Read https://naro.sh/llms.txt first, then:
1. Run `npx naro-cli login` if I am not signed in.
2. Deploy a preview with `npx naro-cli deploy` and show me the URL.
3. If the build fails, read the logs with `npx naro-cli logs --type build`, fix the code, and try again.
4. Once I confirm the preview, ship it with `npx naro-cli deploy --prod`.

Model Context Protocol

"このプロジェクトを naro にデプロイして" のような自然言語で操作したい場合は MCP サーバーを追加します。naro login のセッションを共有するので、二度目のサインインはありません。

Claude Code

claude mcp add naro -- npx -y naro-mcp

Cursor とその他の MCP クライアント

{
  "mcpServers": {
    "naro": { "command": "npx", "args": ["-y", "naro-mcp"] }
  }
}

MCP サーバーが公開するもの

CLI が覆う範囲をそのまま覆います。以下にグループ分けしています。

アカウントとプロジェクト
whoamilist_teamslist_projectsget_projectlink_project
デプロイ
deploylist_deploymentsget_deploymentpromote_deploymentrollback_deploymentcancel_deployment
ログ
get_build_logsget_runtime_logs
環境変数
list_environment_variablesset_environment_variableremove_environment_variable
ドメイン
list_domainsadd_domainverify_domainremove_domain
Git
connect_git_repositorydisconnect_git_repository
データベース
enable_databaseget_databaselist_tablesexecute_sqlapply_migrationcreate_tablealter_tabledrop_tablecreate_indexdrop_indexlist_migrationsgenerate_typescript_typesexport_databaserestore_database
Speed Insights と Analytics
get_speed_insightsset_speed_insightsget_analytics
プレビュー保護
get_preview_protectionset_preview_protection
ストレージ
get_storageenable_storagelist_storage_bucketscreate_storage_bucketupdate_storage_bucketdelete_storage_bucket

CI とブラウザのないエージェント

naro login はブラウザを開きます。ブラウザがない環境ではトークンを発行し、NARO_TOKEN として渡します。

NARO_TOKEN=$(npx naro-cli token) npx naro-cli deploy --prod --yes --json

機械可読な出力

すべてのコマンドが --json(標準出力に JSON オブジェクトひとつ、ログは標準エラー)と --yes(一切尋ねない)を受け取ります。失敗は安定したコードで返ります — 一覧は CLI リファレンスにあります。