모델 컨텍스트 프로토콜 (MCP)

모델 컨텍스트 프로토콜(mcp)은 대형 언어 모델(llm)을 back4app과 같은 플랫폼에 연결하기 위한 표준입니다 이 가이드는 mcp를 사용하여 back4app을 다음 ai 도구에 연결하는 방법을 다룹니다 커서 윈드서핑 (codium) 비주얼 스튜디오 코드 (copilot) cline (vs 코드 확장) claude 데스크탑 claude 코드 연결되면, ai 어시스턴트는 귀하를 대신하여 back4app 프로젝트와 상호작용하고 쿼리할 수 있습니다 mcp를 사용하는 ai 에이전트는 귀하의 back4app 앱에 대한 전체 액세스 권한을 갖도록 구성되어 있으며, 여기에는 리소스를 생성, 수정 및 삭제할 수 있는 기능이 포함됩니다 프로덕션 환경에서 사용하기 전에 기능과 잠재적 영향을 이해하기 위해 먼저 테스트 계정과 앱에서 시도해 보기를 강력히 권장합니다 전제 조건 back4app com에서 생성된 계정입니다 (각 새 계정은 기본적으로 앱의 제한이 있으며, 더 필요하시면 저희에게 연락해 주세요); 최근에 설치된 nodejs 버전 (16^); 더 나은 결과를 위해 가장 진보된 llm 모델과 코딩 에이전트를 사용하는 것을 추천합니다; 웹 호스팅 활성화 하여 서브 도메인에서 배포를 시각화합니다; 1 계정 키 생성하기 먼저, back4app 대시보드로 가서 개인 액세스 토큰을 생성하세요 back4app 계정에 로그인하세요 "안녕하세요, \[사용자 이름]" 메뉴 위에 마우스를 올리세요 이동하여 계정 키 를 생성하세요 목적을 설명하는 이름을 부여하세요, 예 "ai 어시스턴트 mcp" 토큰을 안전하게 복사하세요 다시는 볼 수 없습니다 그런 다음 계정 키 토큰에 이름을 지정하고 +를 클릭하세요 이 토큰은 mcp 서버를 back4app 계정으로 인증하는 데 사용됩니다 2 mcp 설치 자동 선호하는 ide/llm에 back4app mcp를 설치하려면 다음 단계를 따르세요 2 1 설치 명령 실행 터미널에서 이 명령을 실행하고 \<ide> 를 선호하는 환경으로, your account key를 1단계 에서 복사한 계정 키로 대체하세요 npx @back4app/mcp installer install \<ide> account key your account key 각 ide에 대한 특정 명령은 아래에 나열되어 있습니다 커서 npx @back4app/mcp installer install cursor account key your account key 윈드서프 npx @back4app/mcp installer install windsurf account key your account key 비주얼 스튜디오 npx @back4app/mcp installer install vscode account key your account key 클라인 npx @back4app/mcp installer install cline account key your account key 2 2 연결 확인 커서 설정 > 커서 설정 > mcp로 이동 윈드서프 cascade 입력 위의 도구 모음을 찾아 새로 고침을 클릭하세요 비주얼 스튜디오 에이전트 모드(코파일럿)에서 도구 구성 클릭 후 back4app mcp 도구를 찾으세요 3 ai 도구에서 구성하기 수동 mcp 호환 도구는 back4app mcp 서버를 사용하여 back4app에 연결할 수 있습니다 아래는 인기 있는 ai 도구를 사용하여 이 서버에 연결하는 방법에 대한 지침입니다 커서 커서를 열고 커서 메뉴로 이동합니다 커서 >설정 >커서 설정 >mcp로 이동합니다 +새로운 글로벌 mcp 추가를 클릭합니다 그런 다음 다음 구성을 추가합니다 macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } windows { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } \<account key>를 \<account key> 로 바꿉니다 back4app에서 복사한 계정 키입니다 구성 파일을 저장합니다 대체 설정 프로젝트 설정을 선호하는 경우 로컬 프로젝트 구성 파일을 생성할 수 있습니다 프로젝트 루트에 cursor 디렉토리를 생성하세요 존재하지 않는 경우 존재하지 않는 경우 cursor/mcp json 파일을 생성하고 열어보세요 앞서 언급한 구성을 추가하세요 윈드서핑 윈드서핑을 열고 cascade 도우미로 이동하세요 망치(mcp) 아이콘을 탭한 다음 구성하기를 눌러 구성 파일을 엽니다 다음 구성을 추가하세요 macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } 윈도우 { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } \<account key>를 \<account key> 로 바꾸세요 back4app에서 복사한 계정 키 구성 파일을 저장하고 cascade 도우미에서 새로 고침을 탭하여 다시 로드하세요 서버가 성공적으로 연결된 후에는 녹색 활성 상태를 볼 수 있어야 합니다 비주얼 스튜디오(코파일럿) vs 코드를 열고, 프로젝트 루트에 vscode 디렉토리를 생성합니다(존재하지 않는 경우) 존재하지 않는 경우 vscode/mcp json 파일을 생성하고 엽니다 다음 구성을 추가합니다 macos / 리눅스 { "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}" } } } } 윈도우 { "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}" } } } } 구성 파일을 저장합니다 코파일럿 채팅을 열고 "에이전트" 모드로 전환합니다 mcp 도구가 사용 가능한지 확인할 수 있는 도구 아이콘이 표시됩니다 서버를 사용하기 시작하면 개인 액세스 토큰을 입력하라는 메시지가 표시됩니다 이전에 생성한 토큰을 입력합니다 vs 코드에서 mcp 사용에 대한 자세한 정보는 코파일럿 문서를 참조하세요 클라인 vs code에서 cline 확장을 열고 mcp 서버 아이콘을 탭하세요 구성 파일을 열려면 mcp 서버 구성 탭을 누르세요 다음 구성을 추가하세요 macos / 리눅스 { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } 윈도우 { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } \<account key>를 \<account key> 로 바꾸세요 back4app에서 복사한 계정 키입니다 구성 파일을 저장하세요 cline은 자동으로 구성을 다시 로드해야 합니다 서버가 성공적으로 연결되면 녹색 활성 상태가 표시되어야 합니다 클로드 데스크탑 클로드 데스크탑을 열고 설정으로 이동합니다 개발자 탭에서 구성 파일을 열기 위해 구성 편집을 탭합니다 다음 구성을 추가합니다 macos / 리눅스 { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } 윈도우 { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } \<account key>를 \<account key> 로 바꾸고 back4app에서 복사한 계정 키로 교체합니다 구성 파일을 저장하고 클로드 데스크탑을 재시작합니다 새 채팅 화면에서 새로운 mcp 서버가 사용 가능하다는 해머(mcp) 아이콘이 나타납니다 구식 node js 설치는 클로드 데스크탑에서 npx 명령이 실패할 수 있습니다 16보다 오래된 버전은 제거하고 node js v16 이상을 사용하는 것이 좋습니다 클로드 코드 프로젝트 루트에 mcp json 파일을 생성하세요 파일이 존재하지 않는 경우 다음 구성을 추가하세요 macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } windows { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } \<account key>를 \<account key> 로 교체하세요 back4app에서 복사한 계정 키 구성 파일을 저장하세요 새 구성을 적용하기 위해 클로드 코드를 재시작하세요 구식 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 보안 고려사항 mcp 서버는 개인 액세스 토큰의 권한으로 back4app 계정에 완전한 액세스 권한을 가집니다 이는 ai 도구가 앱과 데이터를 생성, 수정 및 덮어쓸 수 있음을 의미합니다 항상 다음과 같은 예방 조치를 취하십시오 전용 테스트 계정 사용 초기 실험을 위해 mcp 사용을 위해 별도의 액세스 토큰 생성 구성 파일 공유 금지 액세스 토큰이 포함된 모든 코드 및 api 호출 검토 ai에 의해 생성되거나 수정된 후 프로덕션에 배포하기 전에 의심스러운 사용이 의심될 경우 액세스 토큰 즉시 취소 5 문제 해결 일반적인 문제 연결 실패 개인 액세스 토큰이 유효하고 올바르게 입력되었는지 확인하십시오 서버 응답 없음 node js가 설치되어 있고 npx가 올바르게 작동하는지 확인하십시오 권한 오류 액세스 토큰에 필요한 권한이 있는지 확인하십시오 업데이트가 나타나지 않음 일부 mcp 클라이언트는 구성 변경 후 재시작이 필요합니다 6 다음 단계 이제 ai 도구가 mcp를 사용하여 back4app에 연결되었습니다 ai 어시스턴트에게 새 앱을 만들거나, 클라우드 코드를 배포하거나, 자연어를 사용하여 데이터를 관리하도록 요청해 보세요 문제가 발생하거나 피드백이 있는 경우 다음 주소로 메시지를 보내주십시오 community\@back4app com 결론 back4app의 mcp 통합을 통해 ai 에이전트의 힘을 활용하여 개발 워크플로를 가속화할 수 있습니다 앱 생성 및 구성에서 코드 배포 및 데이터 관리에 이르기까지 ai 어시스턴트가 이제 귀하를 대신하여 back4app 플랫폼과 원활하게 상호작용할 수 있습니다