개발 도구에서 연결하기

Claude Code, Codex, Cursor 같은 개발 도구에 앱박스 주소를 등록해 연결합니다. 주소는 모두 https://mcp.appboxapp.com/mcp입니다.
API 키나 토큰은 필요 없습니다. 등록한 뒤 브라우저에서 앱박스 계정으로 로그인하면 됩니다.

Claude Code
먼저 확인하세요
Claude 웹이나 데스크톱 앱에서 이미 앱박스를 연결했고, Claude Code에 같은 Claude 계정으로 로그인했다면 따로 할 일이 없습니다. Claude Code에서 /mcp를 입력해 claude.ai AppBox가 보이면 바로 쓸 수 있습니다.
추가하기
터미널에서 아래 명령을 실행합니다. 모든 폴더에서 쓸 수 있게 추가됩니다.
Bash
1 claude mcp add --transport http --scope user appbox https://mcp.appboxapp.com/mcp
로그인하기
  1. Claude Code를 실행합니다. 이미 켜져 있었다면 종료하고 다시 실행합니다. 다시 실행하지 않으면 로그인해도 연결되지 않습니다.
  2. /mcp를 입력하고 appbox를 고릅니다.
  3. Authenticate를 누릅니다.
  4. 브라우저에서 앱박스 계정으로 로그인하고, AI 앱이 볼 앱을 골라 연결을 누릅니다.
연결됐는지 확인하기
/mcp 목록에서 appbox 앞에 체크 표시(✔)가 보이면 됩니다. “내 앱박스 앱 목록 보여 줘”라고 물어보세요.
자주 막히는 곳
/mcp 목록에 appbox가 없어요
Claude Code를 종료하고 다시 실행하세요. 실행 중에 추가한 서버는 다시 실행해야 보입니다.
로그인했는데 연결이 안 돼요
Claude Code를 다시 실행한 뒤 /mcp에서 다시 Authenticate를 누르세요.
appbox가 계속 Needs authentication이에요
아직 로그인하지 않은 상태입니다. /mcp에서 Authenticate를 누르세요.
Codex
터미널에서 아래 명령을 실행합니다.
Bash
1 codex mcp add appbox --url https://mcp.appboxapp.com/mcp
  1. 명령을 실행하면 브라우저에 앱박스 로그인 화면이 바로 열립니다.
  2. 로그인하고 AI 앱이 볼 앱을 골라 연결을 누릅니다.
  • 나중에 다시 로그인하려면 codex mcp login appbox를 실행합니다.
  • ChatGPT 데스크톱 앱의 Codex도 같은 설정을 씁니다.
Cursor
아래 내용을 설정 파일에 추가합니다.
  • 모든 프로젝트에서 쓰려면 ~/.cursor/mcp.json
  • 이 프로젝트에서만 쓰려면 프로젝트 폴더의 .cursor/mcp.json
JSON
1 {
2 "mcpServers": {
3 "appbox": {
4 "url": "https://mcp.appboxapp.com/mcp"
5 }
6 }
7 }
  1. 처음 앱박스 도구를 쓸 때 앱박스 로그인 화면이 열립니다.
  2. 로그인하고 AI 앱이 볼 앱을 골라 연결을 누릅니다.
Cursor는 연결 화면에 확인되지 않은 앱으로 표시됩니다. 내가 직접 시작한 연결이면 그대로 허용하면 됩니다.
그 밖의 AI 앱
다음 두 가지를 지원하는 AI 앱이면 연결할 수 있습니다.
  • 원격 MCP 서버 추가. 주소를 넣어 서버를 추가하는 기능입니다.
  • 브라우저 로그인(OAuth)
  1. AI 앱의 MCP 서버 추가 화면에 https://mcp.appboxapp.com/mcp를 넣습니다. 키나 토큰을 넣는 칸은 비워 둡니다.
  2. 앱박스 로그인 화면이 열리면 로그인하고, AI 앱이 볼 앱을 골라 연결을 누릅니다.
내 컴퓨터에서 프로그램을 실행하는 방식만 지원하는 앱이나, 키를 직접 넣는 방식만 지원하는 앱은 연결할 수 없습니다.
앱박스에서 연결을 확인한 앱은 Claude, Claude Code, Codex, Cursor입니다.
로그인 없이 문서만 쓰기
앱박스 계정이 없어도 공개 가이드, 예제 코드, 서버 API 명세를 AI 앱에서 찾아볼 수 있습니다. 로그인 화면은 뜨지 않습니다. 주소는 https://mcp.appboxapp.com/docs입니다.
Claude Code라면 이렇게 추가합니다.
Bash
1 claude mcp add --transport http --scope user appbox-docs https://mcp.appboxapp.com/docs
  • 1분에 60번까지 쓸 수 있습니다. IP마다 따로 셉니다.
  • 이미 로그인 연결(https://mcp.appboxapp.com/mcp)을 쓰고 있다면 같은 기능이 들어 있어 따로 추가하지 않아도 됩니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.