--- title: 모델 컨텍스트 프로토콜 (MCP) slug: docs-kr/UrfwCG4-a1iOG9WdMvwsU description: 이 포괄적인 가이드에서 모델 컨텍스트 프로토콜 (MCP)을 통해 대형 언어 모델 (LLM)의 잠재력을 최대한 활용하세요. Cursor, Windsurf, Visual Studio Code와 같은 AI 도구를 Back4App과 원활하게 통합하는 방법을 배우세요. 단계별 지침을 발견하세요. createdAt: 2025-04-29T20:19:47.638Z --- 모델 컨텍스트 프로토콜(MCP)은 대형 언어 모델(LLM)을 Back4App과 같은 플랫폼에 연결하기 위한 표준입니다. 이 가이드는 MCP를 사용하여 Back4App을 다음 AI 도구에 연결하는 방법을 다룹니다: - 커서 - 윈드서핑 (Codium) - 비주얼 스튜디오 코드 (Copilot) - Cline (VS 코드 확장) - Claude 데스크탑 - Claude 코드 연결되면, AI 어시스턴트는 귀하를 대신하여 Back4App 프로젝트와 상호작용하고 쿼리할 수 있습니다. :::hint{type="warning"} MCP를 사용하는 AI 에이전트는 귀하의 Back4App 앱에 대한 전체 액세스 권한을 갖도록 구성되어 있으며, 여기에는 리소스를 생성, 수정 및 삭제할 수 있는 기능이 포함됩니다. 프로덕션 환경에서 사용하기 전에 기능과 잠재적 영향을 이해하기 위해 먼저 테스트 계정과 앱에서 시도해 보기를 강력히 권장합니다. ::: ## 전제 조건 1. back4app.com에서 생성된 계정입니다. (각 새 계정은 기본적으로 앱의 제한이 있으며, 더 필요하시면 저희에게 연락해 주세요); 2. 최근에 설치된 NodeJs 버전 (16^); 3. 더 나은 결과를 위해 가장 진보된 LLM 모델과 코딩 에이전트를 사용하는 것을 추천합니다; 4. [웹 호스팅 활성화](https://www.back4app.com/docs/platform/activating-web-hosting)하여 서브 도메인에서 배포를 시각화합니다; ## 1 - 계정 키 생성하기 먼저, Back4App 대시보드로 가서 개인 액세스 토큰을 생성하세요: 1. Back4App 계정에 로그인하세요 2. "안녕하세요, \[사용자 이름]" 메뉴 위에 마우스를 올리세요 3. 이동하여 **계정 키**를 생성하세요 4. 목적을 설명하는 이름을 부여하세요, 예: "AI 어시스턴트 MCP" 5. 토큰을 안전하게 복사하세요 - 다시는 볼 수 없습니다 ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/Vtf9h_neBfwWz0MOTYGb8_screenshot-2024-11-28-at-164118.png" size="56" width="622" height="488" position="center" showCaption="false"} 그런 다음 계정 키 토큰에 이름을 지정하고 +를 클릭하세요. ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/8PVJ3_IeA8HBRTy-uIO3y_image.png" size="66" width="626" height="251" position="center" showCaption="false"} 이 토큰은 MCP 서버를 Back4app 계정으로 인증하는 데 사용됩니다. ## 2 - MCP 설치 - 자동 선호하는 IDE/LLM에 Back4app MCP를 설치하려면 다음 단계를 따르세요: ### 2.1- 설치 명령 실행 터미널에서 이 명령을 실행하고 ``를 선호하는 환경으로, YOUR\_ACCOUNT\_KEY를 **1단계**에서 복사한 계정 키로 대체하세요. ```bash npx @back4app/mcp-installer install --account-key YOUR_ACCOUNT_KEY ``` 각 IDE에 대한 특정 명령은 아래에 나열되어 있습니다: **커서 ** ```bash npx @back4app/mcp-installer install cursor --account-key YOUR_ACCOUNT_KEY ``` **윈드서프 ** ```bash npx @back4app/mcp-installer install windsurf --account-key YOUR_ACCOUNT_KEY ``` **비주얼 스튜디오 ** ```bash npx @back4app/mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY ``` **** **클라인** ```bash npx @back4app/mcp-installer install cline --account-key YOUR_ACCOUNT_KEY ``` ### 2.2- 연결 확인 **커서** : 설정 -> 커서 설정 -> MCP로 이동 ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/T0J8l4WXPTFY5NvECNNyE_image.png" size="66" width="1108" height="530" position="center" showCaption="false"} **윈드서프:** Cascade 입력 위의 도구 모음을 찾아 새로 고침을 클릭하세요. ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/ZDSDM3KpJvUjHSUOXWZNS_image.png" size="84" width="746" height="144" position="center" showCaption="false"} **비주얼 스튜디오:** 에이전트 모드(코파일럿)에서 도구 구성 클릭 후 back4app MCP 도구를 찾으세요. ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/K1JQ7h0Akw9R4vkwDLgxT_image.png" size="68" width="998" height="268" position="center" showCaption="false"} ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/XBOptYUJCZrJHYWp51Aij_image.png" size="80" width="1224" height="622" position="center" showCaption="false"} ## 3 - AI 도구에서 구성하기 - 수동 MCP 호환 도구는 Back4App MCP 서버를 사용하여 Back4App에 연결할 수 있습니다. 아래는 인기 있는 AI 도구를 사용하여 이 서버에 연결하는 방법에 대한 지침입니다: :::ExpandableHeading{isOpen="true"} ### 커서 1. 커서를 열고 커서 메뉴로 이동합니다. 2. 커서->설정->커서 설정->MCP로 이동합니다. 3. +새로운 글로벌 MCP 추가를 클릭합니다. ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/YzKx3lkm0svvSRTOv6A5W_image.png) 그런 다음 다음 구성을 추가합니다: **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **Windows** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. \를 ``로 바꿉니다. Back4App에서 복사한 계정 키입니다. 2. 구성 파일을 저장합니다. ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/yjyGhtyrINZlB9OY9o5rx_image.png) ::: **대체 설정** 프로젝트 설정을 선호하는 경우 로컬 프로젝트 구성 파일을 생성할 수 있습니다: 1. 프로젝트 루트에 `.cursor` 디렉토리를 생성하세요. 존재하지 않는 경우. 2. 존재하지 않는 경우 `.cursor/mcp.json` 파일을 생성하고 열어보세요. 3. 앞서 언급한 구성을 추가하세요. :::ExpandableHeading{isOpen="true"} ### 윈드서핑 1. 윈드서핑을 열고 Cascade 도우미로 이동하세요. 2. 망치(MCP) 아이콘을 탭한 다음 구성하기를 눌러 구성 파일을 엽니다. 3. 다음 구성을 추가하세요: **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **윈도우** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. \를 ``로 바꾸세요. back4app에서 복사한 계정 키. 2. 구성 파일을 저장하고 Cascade 도우미에서 새로 고침을 탭하여 다시 로드하세요. 3. 서버가 성공적으로 연결된 후에는 녹색 활성 상태를 볼 수 있어야 합니다. ::: :::ExpandableHeading ### 비주얼 스튜디오(코파일럿) 1. VS 코드를 열고, 프로젝트 루트에 `.vscode` 디렉토리를 생성합니다(존재하지 않는 경우) 2. 존재하지 않는 경우 `.vscode/mcp.json` 파일을 생성하고 엽니다 3. 다음 구성을 추가합니다: **macOS / 리눅스** ```json { "inputs": [ { "type": "promptString", "id": "back4app-account-key", "description": "Back4App 개인 액세스 토큰", "password": true } ], "servers": { "back4app": { "command": "npx", "args": ["-y", "@back4app/mcp-server-back4app@latest"], "env": { "BACK4APP_ACCOUNT_KEY": "${input:back4app-account-key}" } } } } ``` **윈도우** ```json { "inputs": [ { "type": "promptString", "id": "back4app-account-key", "description": "Back4App 개인 액세스 토큰", "password": true } ], "servers": { "back4app": { "command": "npx.cmd", "args": ["-y", "@back4app/mcp-server-back4app@latest"], "env": { "BACK4APP_ACCOUNT_KEY": "${input:back4app-account-key}" } } } } ``` 1. 구성 파일을 저장합니다 2. 코파일럿 채팅을 열고 "에이전트" 모드로 전환합니다. MCP 도구가 사용 가능한지 확인할 수 있는 도구 아이콘이 표시됩니다 3. 서버를 사용하기 시작하면 개인 액세스 토큰을 입력하라는 메시지가 표시됩니다. 이전에 생성한 토큰을 입력합니다 VS 코드에서 MCP 사용에 대한 자세한 정보는 코파일럿 문서를 참조하세요. ::: :::ExpandableHeading ### 클라인 1. VS Code에서 Cline 확장을 열고 MCP 서버 아이콘을 탭하세요. 2. 구성 파일을 열려면 MCP 서버 구성 탭을 누르세요. 3. 다음 구성을 추가하세요: **macOS / 리눅스** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **윈도우** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. \를 ``로 바꾸세요. back4app에서 복사한 계정 키입니다. 2. 구성 파일을 저장하세요. Cline은 자동으로 구성을 다시 로드해야 합니다. 3. 서버가 성공적으로 연결되면 녹색 활성 상태가 표시되어야 합니다. ::: ::::ExpandableHeading ### 클로드 데스크탑 1. 클로드 데스크탑을 열고 설정으로 이동합니다. 2. 개발자 탭에서 구성 파일을 열기 위해 구성 편집을 탭합니다. 3. 다음 구성을 추가합니다: **macOS / 리눅스** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **윈도우** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. \를 ``로 바꾸고 back4app에서 복사한 계정 키로 교체합니다. 2. 구성 파일을 저장하고 클로드 데스크탑을 재시작합니다. 3. 새 채팅 화면에서 새로운 MCP 서버가 사용 가능하다는 해머(MCP) 아이콘이 나타납니다. :::hint{type="warning"} 구식 Node.js 설치는 클로드 데스크탑에서 npx 명령이 실패할 수 있습니다. 16보다 오래된 버전은 제거하고 Node.js v16 이상을 사용하는 것이 좋습니다. ::: :::: ::::ExpandableHeading ### 클로드 코드 1. 프로젝트 루트에 `.mcp.json` 파일을 생성하세요. 파일이 존재하지 않는 경우. 2. 다음 구성을 추가하세요: **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **Windows** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. \를 ``로 교체하세요. back4app에서 복사한 계정 키. 2. 구성 파일을 저장하세요. 3. 새 구성을 적용하기 위해 클로드 코드를 재시작하세요. :::hint{type="warning"} 구식 Node.js 설치는 클로드 코드에서 npx 명령이 실패할 수 있습니다. 16보다 오래된 버전은 제거하고 Node.js v16 이상을 사용하는 것이 좋습니다. ::: :::: ## 3 - 사용 가능한 도구 연결되면, AI 어시스턴트는 Back4App 계정에서 다양한 작업을 수행할 수 있습니다. 사용 가능한 도구는 다음과 같습니다: ### 앱 관리 - **create\_parse\_app** - 새로운 Parse 앱을 생성합니다. - **get\_parse\_apps** - 모든 Parse 앱의 목록을 가져옵니다. - **get\_parse\_app** - 특정 Parse 앱의 세부 정보를 가져옵니다. - **set\_current\_app** - 후속 작업을 위한 기본 앱을 설정합니다. - **get\_current\_app** - 현재 설정된 기본 앱을 가져옵니다. ### 직접 API 접근 (Parse REST API) - **call\_parse\_api** - Parse Server REST API 엔드포인트를 호출하여 앱을 완전히 관리합니다. **데이터베이스 작업** – 모든 클래스에서 객체를 생성, 읽기, 업데이트, 삭제합니다. – 풍부한 쿼리 (필터, 정렬, 페이지네이션, 카운트, 집계, 고유) **사용자 관리 및 보안** – 가입 / 로그인 / 로그아웃 / 비밀번호 재설정 – 역할, ACL 및 CLP를 통해 객체 및 클래스 수준에서 데이터 잠금 **실시간 및 푸시** – WebSockets를 통한 LiveQuery (생성/업데이트/삭제 구독) – 푸시 알림 및 설치 기록 **클라우드 코드 함수 호출** – 클라우드 함수 및 예약 작업 – 전후 트리거, 사용자 정의 웹훅 **파일, 분석 및 확장** – 파일 업로드/다운로드 ### Parse 앱의 클라우드 코드 및 웹 호스팅 - **list\_cloud\_code\_and\_web\_hosting\_files** - 모든 클라우드 코드 및 웹 호스팅 파일 목록 - **get\_file\_content** - 특정 파일의 내용을 보기 - **deploy\_cloud\_code\_files** - 클라우드 코드 파일을 앱에 배포 - **deploy\_web\_hosting\_files** - 웹 호스팅 파일을 앱에 배포 ## 4 - 보안 고려사항 :::hint{type="danger"} MCP 서버는 개인 액세스 토큰의 권한으로 Back4App 계정에 완전한 액세스 권한을 가집니다. 이는 AI 도구가 앱과 데이터를 생성, 수정 및 덮어쓸 수 있음을 의미합니다. 항상 다음과 같은 예방 조치를 취하십시오: ::: 1. **전용 테스트 계정 사용** 초기 실험을 위해 2. **MCP 사용을 위해 별도의 액세스 토큰 생성** 3. **구성 파일 공유 금지** 액세스 토큰이 포함된 4. **모든 코드 및 API 호출 검토** AI에 의해 생성되거나 수정된 후 프로덕션에 배포하기 전에 5. **의심스러운 사용이 의심될 경우 액세스 토큰 즉시 취소** ## 5 - 문제 해결 ### 일반적인 문제 - **연결 실패**: 개인 액세스 토큰이 유효하고 올바르게 입력되었는지 확인하십시오. - **서버 응답 없음**: Node.js가 설치되어 있고 npx가 올바르게 작동하는지 확인하십시오. - **권한 오류**: 액세스 토큰에 필요한 권한이 있는지 확인하십시오. - **업데이트가 나타나지 않음**: 일부 MCP 클라이언트는 구성 변경 후 재시작이 필요합니다. ## 6 - 다음 단계 이제 AI 도구가 MCP를 사용하여 Back4App에 연결되었습니다. AI 어시스턴트에게 새 앱을 만들거나, 클라우드 코드를 배포하거나, 자연어를 사용하여 데이터를 관리하도록 요청해 보세요. 문제가 발생하거나 피드백이 있는 경우 다음 주소로 메시지를 보내주십시오: [community@back4app.com](mailto\:community@back4app.com) ## 결론 Back4App의 MCP 통합을 통해 AI 에이전트의 힘을 활용하여 개발 워크플로를 가속화할 수 있습니다. 앱 생성 및 구성에서 코드 배포 및 데이터 관리에 이르기까지 AI 어시스턴트가 이제 귀하를 대신하여 Back4App 플랫폼과 원활하게 상호작용할 수 있습니다.