MCP 서버
TeamOnly MCP 서버
AI 툴이 직접 만든 앱을 회사 로그인 뒤에 배포하고, 실시간 로그를 읽고, 고장 난 곳을 고치게 하세요. Claude Code, Cursor, VS Code, Claude Desktop, Windsurf에서 한 줄이면 설정돼요.
claude mcp add teamonly -- npx -y teamonly mcpclaude이 앱을 TeamOnly에 배포해 줘01하는 일
채팅에서 바로 배포
MCP 서버는 TeamOnly 기능을 AI 툴이 호출할 수 있는 도구로 제공해요. 프로젝트 설정, 배포, 앱을 열 수 있는 사람 확인, 로그 읽기, 시크릿 저장, 로그인까지요.
그래서 대화를 벗어나지 않아도 돼요. “이 앱을 TeamOnly에 배포해 줘”라고 말하면 에이전트가 해요. 앱에 오류가 나면 실시간 로그를 보고, 문제를 찾고, 코드를 고친 다음 스스로 다시 배포할 수 있어요.
npx teamonly init이 추가하는 규칙 파일(Claude Code 스킬, AGENTS.md, Cursor 규칙)이 여전히 AI가 스택을 배우는 주된 방법이에요. MCP 서버는 Claude Desktop이나 터미널 없는 Cursor 에이전트처럼 터미널 명령어보다 도구 호출을 선호하는 툴을 위한 거예요. CLI는 전과 똑같이 동작해요.
02설치
AI 툴에 추가하기
어떤 툴이든 내 컴퓨터에서 같은 명령어를 실행해요: npx -y teamonly mcp. Node.js 20 이상이 필요해요.
Claude Code
터미널에서 한 번 실행하세요:
claude mcp add teamonly -- npx -y teamonly mcpCursor
버튼을 눌러 Cursor에 설치하거나, 프로젝트의 .cursor/mcp.json(모든 프로젝트에 쓰려면 ~/.cursor/mcp.json)에 다음을 추가하세요:
{
"mcpServers": {
"teamonly": {
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}VS Code
터미널에서 한 번 실행하세요:
code --add-mcp '{"name":"teamonly","command":"npx","args":["-y","teamonly","mcp"]}'또는 프로젝트의 .vscode/mcp.json에 다음을 추가하세요. VS Code는 servers와 "type": "stdio"를 써요:
{
"servers": {
"teamonly": {
"type": "stdio",
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}Claude Desktop
Settings, Developer, Edit Config 순서로 열고 claude_desktop_config.json에 다음을 추가하세요. 그다음 Claude Desktop을 다시 시작하세요.
{
"mcpServers": {
"teamonly": {
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}Windsurf
Windsurf의 MCP 설정 파일 mcp_config.json에 다음을 추가하세요:
{
"mcpServers": {
"teamonly": {
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}다른 툴
로컬 서버를 실행하는 MCP 클라이언트라면 어디서든 쓸 수 있어요. 명령어는 npx, 인자는 -y teamonly mcp이고 stdio로 통신해요. 공식 MCP Registry에도 dev.teamonly/teamonly로 올라가 있어요.
npx -y teamonly mcp03도구
AI가 할 수 있는 일
도구는 12개예요. AI 툴은 호출할 때마다 보여 주고, 대부분은 실행하기 전에 물어봐요.
get_app_rules- TeamOnly 앱 규칙이에요. 지원하는 스택, 로그인한 사람 정보 읽기, 데이터베이스, 파일, 시크릿, 이메일, 예약 작업, 역할까지요. AI는 코드를 쓰기 전에 이 규칙을 읽어요.
init- 빈 폴더에 스타터 앱이나 템플릿을 만들거나, 이미 있는 앱에 TeamOnly를 추가해요.
deploy- 앱을 빌드해서 회사 로그인 뒤의 비공개 주소에 배포해요.
status- 로그인한 사람, 회사 요금제, 그리고 모든 앱의 주소와 열 수 있는 사람을 보여 줘요.
logs- 운영 중인 앱을 5~60초 동안 지켜보고 요청,
console.log출력, 오류를 돌려줘요. access- 앱을 열 수 있는 사람을 보여 주거나 바꿔요. 회사 사람 모두, 또는 목록에 있는 사람만이요.
roles- 앱 안에서 사람들이 가진 역할(approver, finance 등)을 보여 주거나 바꿔요.
set_secret- 앱의 API 키나 비밀번호를 저장해서 코드에 들어가지 않게 해요.
sign_in- 회사 이메일과 이메일로 받은 6자리 코드로 로그인해요.
start_trial- 회사의 14일 무료 체험을 카드 없이 시작해요.
subscribe- Builder, Team, Business 요금제 결제 링크를 돌려줘요.
delete_app- 운영 중인 앱을 데이터와 함께 삭제해요. 확인을 위해 앱 이름이 필요해요.
이 앱을 TeamOnly에 배포해 줘teamonly · get_app_rulesteamonly · deployLive at https://expenses.acme.teamonly.app배포했어요. @acme.com 계정이 있는 사람만 열 수 있어요.04써 보기
이렇게 말하세요
평소 말로 충분해요. 예를 들면: 이 앱을 TeamOnly에 배포해 줘
이런 것도 부탁할 수 있어요:
- 저장할 때 오류가 나. 로그 보고 고쳐 줘.
- 이건 Priya와 Sam만 열 수 있게 해 줘.
- Dana를 approver로 지정해 줘.
- 내 Slack 웹훅을 시크릿으로 저장해 줘.
05로그인
에이전트에서 로그인하는 방법
채팅을 떠날 필요도, 비밀번호를 붙여 넣을 필요도 없어요.
회사 이메일
에이전트가 회사 이메일을 묻고
sign_in을 호출해요. 6자리 코드를 이메일로 보내 드려요.코드
에이전트에게 코드를 알려 주세요.
sign_in을 다시 호출하면 이 컴퓨터에서 로그인돼요.새 회사
회사에 아직 TeamOnly가 없으면 에이전트가
start_trial로 카드 없는 14일 무료 체험을 시작하거나,subscribe로 열어 볼 결제 링크를 드릴 수 있어요.
MCP 서버가 CLI를 대신하나요?
아니요. CLI는 전과 똑같이 동작하고, npx teamonly init이 추가하는 규칙 파일이 여전히 AI가 TeamOnly 앱 작성법을 배우는 주된 방법이에요. MCP 서버는 터미널 명령어보다 도구 호출을 선호하는 AI 툴에 같은 기능을 제공해요.
MCP 서버는 어디에서 실행되나요?
내 컴퓨터에서요. AI 툴이 npx -y teamonly mcp로 서버를 실행하고 stdio로 통신해요. 배포할 때 프로젝트 파일을 읽어야 해서 로컬에서 실행돼요.
무료인가요?
어떤 AI 툴에서 쓸 수 있나요?
로컬 MCP 서버를 실행할 수 있는 툴이면 다 돼요. Claude Code, Cursor, VS Code, Claude Desktop, Windsurf와 그 밖의 에이전트에서요. 공식 MCP Registry에도 dev.teamonly/teamonly로 올라가 있어요.
얼리 액세스
이번 주에 첫 툴을 올려 보세요.
TeamOnly는 얼리 액세스 중이고, 지금 모든 요금제에 가입할 수 있어요. 카드 없이 14일 동안 무료로 써 보거나, 구독하세요. 어느 쪽이든 회사 설정이 바로 끝나고, 명령어 세 개면 첫 앱이 온라인에 올라가요.
아직 준비가 안 됐나요? 소식 받기
질문은 hello@teamonly.dev로 보내 주세요. 사람이 직접 답해요.