GitHub Copilot 사용자용

GitHub Copilot으로 만든 앱을 우리 팀하고만 공유하기

VS Code에서 Copilot 에이전트로 사내 툴을 만들었죠. TeamOnly는 그 툴을 동료만 열 수 있는 비공개 링크로 올려요. 동료들은 회사 Google 또는 Microsoft 계정이나 회사 이메일로 받은 코드로 들어와요. 배포는 Copilot이 대신 실행해요.

VS Code~/stock-counter
이거 TeamOnly에 배포해 줘터미널에서 npx teamonly deploy를 실행할까요? 허용 / 건너뛰기Live at https://stock.acme.teamonly.appOnly @acme.com accounts can sign in.

01짧은 답

VS Code의 Copilot은 AGENTS.md를 읽어요. TeamOnly가 그 파일을 써요.

프로젝트에서 npx teamonly init을 실행하세요. TeamOnly 규칙이 담긴 AGENTS.md가 추가되고, VS Code는 기본적으로 루트의 AGENTS.md를 에이전트 요청에 붙여요.

그다음 Copilot에게 툴을 요청하고 배포해 달라고 하세요. Copilot이 VS Code 터미널에서 npx teamonly deploy를 실행하면, 회사 밖 사람은 아무도 열 수 없는 stock.acme.teamonly.app 같은 링크가 생겨요.

02단계

VS Code에서 팀이 로그인하는 링크까지

  1. 규칙 추가하기

    VS Code에서 앱 폴더를 열고 터미널에서 npx teamonly init을 실행하세요. 빈 폴더라면 시작용 앱을 만들고, 이미 있는 앱이라면 TeamOnly 파일만 추가하고 내 코드는 건드리지 않아요.

  2. 툴 요청하기

    Chat 보기에서 에이전트를 선택하고: “현장에 있는 누구나 휴대폰으로 수량을 기록하는 재고 집계 툴.” Copilot이 TeamOnly에서 돌아가는 단 하나의 형태인 React 화면과 작은 API로 만들어요.

  3. 배포하기

    “이거 TeamOnly에 배포해 줘”라고 말하세요. Copilot이 npx teamonly deploy를 실행하는데, 자동 승인으로 설정하지 않았다면 먼저 명령어 허용을 요청해요.

  4. 한 번만 로그인하기

    처음에는 Copilot이 회사 이메일과 저희가 보내는 6자리 코드를 물어요. 회사가 TeamOnly를 처음 쓴다면 14일 무료 체험을 제안해요.

  5. 링크 공유하기

    팀에 보내세요. 나중에 앱을 고치고 다시 배포해도 링크는 그대로예요.

터미널~/stock-counter
npx teamonly initAdded the TeamOnly instructions for Claude Code, Cursor and other AI tools npx teamonly deployLive at https://stock.acme.teamonly.app

03Copilot이 읽는 것

이 프로젝트에서 Copilot이 따르는 규칙

init은 프로젝트 최상위의 AGENTS.md에 표시된 블록을 쓰고, 이미 파일이 있다면 나머지 내용은 그대로 둬요. 이 블록은 앱 형태, 로그인한 사람을 가져오는 방법, 데이터베이스와 파일, 배포 방법을 설명해요.

VS Code 문서에 따르면 기본으로 켜져 있는 chat.useAgentsMdFile 설정이 루트의 AGENTS.md를 채팅 요청에 붙여요. GitHub 문서는 VS Code의 Copilot Chat, Copilot 클라우드 에이전트, Copilot CLI에서 AGENTS.md를 지원한다고 적고 있어요. 이것들은 이걸로 해결돼요.

Visual Studio나 JetBrains에서 Copilot을 쓰나요? GitHub 문서에 따르면 거기서 Copilot Chat은 AGENTS.md가 아니라 .github/copilot-instructions.md를 읽어요. 그래서 npx teamonly init은 Copilot이 AGENTS.md를 보도록 안내하는 짧은 .github/copilot-instructions.md도 써요.

04명령어 실행

배포는 Copilot이, 승인은 내가

VS Code에서 에이전트는 파일을 고치고, 터미널 명령어를 실행하고, 툴을 호출할 수 있어요. 기본 권한에서는 자동 승인되지 않은 명령어를 실행하기 전에 물어봐요. npx teamonly deploy를 한 번 허용하거나 chat.tools.terminal.autoApprove에 추가하세요.

Copilot 클라우드 에이전트는 달라요. 방화벽 뒤의 GitHub Actions 환경에서 GitHub 위에서 작업하고 풀 리퀘스트를 열어요. 내 TeamOnly 로그인 정보가 없어서 변경 사항은 쓸 수 있지만 배포는 못 해요. 변경 사항을 병합하거나 가져온 다음, 내 컴퓨터의 VS Code에서 배포하세요.

05MCP 옵션

VS Code에 TeamOnly를 툴로 추가하기

teamonly 패키지는 MCP 서버이기도 해서, Copilot이 명령어 대신 툴로 배포하고, 로그를 읽고, 앱을 열 수 있는 사람을 바꿀 수 있어요. 터미널에서 이걸 한 번 실행하세요:

code --add-mcp '{"name":"teamonly","type":"stdio","command":"npx","args":["-y","teamonly","mcp"]}'

아니면 명령 팔레트에서 MCP: Add Server를 실행하고 Command (stdio)를 고른 다음 npx -y teamonly mcp를 입력하세요. 프로젝트에 같이 두려면 servers를 쓰는 .vscode/mcp.json에 추가하세요:

{ "servers": { "teamonly": { "type": "stdio", "command": "npx", "args": ["-y", "teamonly", "mcp"] } } }

TeamOnly MCP 서버

06동료에게 보이는 화면

로그인 화면, 그다음 내 앱

동료들은 Copilot도, GitHub 계정도 필요 없고 아무것도 설치하지 않아도 돼요.

링크를 열고 회사 Google 또는 Microsoft 계정이나 회사 이메일로 받은 코드로 로그인해요. TeamOnly가 내 코드가 실행되기 전에 이걸 확인하고, 앱은 그 사람의 이름과 이메일을 받아요. 회사 밖 사람은 로그인 화면에서 멈춰요. 앱을 쓰기만 하는 사람은 무료예요. 회사 로그인 작동 방식.

경비 앱 앞에 관계자 외 출입금지라고 적힌 문이 있어요. sam@acme.com으로 로그인한 Sam은 문에서 확인을 받고 들어가요. 이어서 randomperson@gmail.com과 봇이 같은 문에서 확인을 받고 돌려보내져요. 확인이 앱보다 먼저, 문에서 이뤄지기 때문에 이들은 앱에 닿지도 못해요.

@acme.com 계정이 있는 동료는 들어와요. 그 외의 사람은 문 앞에서 멈춰요.

FAQ

자주 묻는 질문

모든 질문과 답변

GitHub Copilot은 AGENTS.md를 읽나요?

VS Code에서는 네, 루트의 AGENTS.md가 기본적으로 에이전트 요청에 붙어요. GitHub 문서는 Copilot 클라우드 에이전트와 Copilot CLI에서도 지원한다고 적고 있어요. Visual Studio와 JetBrains의 Copilot Chat은 대신 .github/copilot-instructions.md를 읽어요.

.github/copilot-instructions.md가 필요한가요?

직접 쓸 필요는 없어요. npx teamonly init이 VS Code의 Copilot이 읽는 AGENTS.md에 규칙을 넣고, Visual Studio와 JetBrains의 Copilot을 위해 그 파일을 가리키는 짧은 .github/copilot-instructions.md도 추가해요. 그 파일이 이미 있다면 init은 블록만 추가하고 나머지는 그대로 둬요.

Copilot이 npx teamonly deploy를 실행할 수 있나요?

네, VS Code의 에이전트는 터미널 명령어를 실행해요. 설정에서 자동 승인하지 않았다면 명령어 허용을 요청해요.

Copilot 클라우드 에이전트가 배포할 수 있나요?

아니요. GitHub 위에서 방화벽 뒤에 내 TeamOnly 로그인 정보 없이 실행되고, TeamOnly 규칙은 AI에게 로그인을 우회하지 말라고 해요. 클라우드 에이전트가 풀 리퀘스트를 열게 하고, 내 컴퓨터에서 배포하세요.

앱이 GitHub에 있어야 하나요?

아니요. 배포는 내 컴퓨터의 폴더에서 앱을 보내요. 그래도 GitHub에 두는 건 좋은 생각이고, 클라우드 에이전트가 작업하게 하려면 거기 있어야 해요.

비용은 얼마인가요?

처음 14일은 무료이고 카드도 필요 없어요. 그다음 Builder는 제작자 1명, 앱 3개에 월 $19, Team은 모든 제작자와 앱에 월 $249예요. 앱을 쓰기만 하는 동료는 무료예요. Copilot 요금제는 그대로예요.

출처

Copilot에 관한 내용은 2026년 10월 26일에 GitHub와 Microsoft 문서에서 확인했어요: Copilot 기능별로 읽는 지시 파일, VS Code의 사용자 지정 지시, 승인과 터미널 명령어, MCP 설정, 클라우드 에이전트 방화벽. Copilot은 자주 바뀌니, 다르게 보이는 게 있으면 문서를 확인하세요.

얼리 액세스

이번 주에 첫 툴을 올려 보세요.

TeamOnly는 얼리 액세스 중이고, 지금 모든 요금제에 가입할 수 있어요. 카드 없이 14일 동안 무료로 써 보거나, 구독하세요. 어느 쪽이든 회사 설정이 바로 끝나고, 명령어 세 개면 첫 앱이 온라인에 올라가요.

14일 무료 체험하기아니면 지금 구독하기

무료 체험에는 카드가 필요 없어요. 그 뒤로 월 $19부터, 언제든 해지할 수 있어요.

아직 준비가 안 됐나요? 소식 받기

회사 이메일을 써 주세요. 메일은 가끔, 보낼 만한 소식이 있을 때만 보내요.

질문은 hello@teamonly.dev로 보내 주세요. 사람이 직접 답해요.