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

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으로 넘긴다.

기계가 읽는 출력

모든 명령이 --json(표준출력에 JSON 객체 하나, 로그는 표준에러)과 --yes(절대 묻지 않음)를 받는다. 실패는 안정된 코드로 돌아온다 — 목록은 CLI 레퍼런스에 있다.