이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Model Context Protocol (MCP) 서버에 연결

MCP 서버는 Gemini에 추가 도구와 데이터 소스를 제공합니다. 예를 들어 Firebase MCP 서버를 추가하면 애플리케이션을 빌드하거나 디버깅하는 동안 자연어를 사용하여 Cloud Firestore 데이터를 탐색할 수 있습니다.

기본 요건

MCP 서버에 필요한 경우 Node.js 및 npm이 설치되어 있고 작동하는지 확인합니다.

호환되는 MCP 서버 선택

Firebase Studio는 MCP 서버를 기본적으로 지원하지만 일부 MCP 서버는 호환되지 않습니다. MCP 서버를 선택할 때는 다음 호환성 세부정보를 참고하세요.

지원됨:
- 표준 입력/출력 (stdio) 또는 서버 전송 이벤트 (SSE)/스트리밍 가능한 HTTP 전송 서버
- HTTP 헤더 또는 환경 변수를 사용한 API 키 인증
- MCP 서버에서 제공하는 도구
지원되지 않음:
- 그래픽 사용자 인터페이스 또는 데스크톱 세션이 필요한 서버
- MCP 서버에서 제공하는 프롬프트, 샘플링 또는 기타 리소스

MCP 서버 추가

MCP 서버를 추가하려면 구성 파일을 만들거나 수정해야 합니다.

첫 번째 서버의 경우: 구성 파일을 만듭니다.
서버를 추가하거나 조정하려면 서버 구성을 수정하세요.

1단계: 구성 파일 만들기

대화형 채팅과 Gemini CLI는 모두 MCP 서버에 연결할 수 있지만 서로 다른 구성 파일을 사용합니다.

대화형 채팅은 .idx/mcp.json을 사용합니다.
Gemini CLI는 .gemini/settings.json을 사용합니다.

다음 안내에 따라 하나 또는 두 파일을 모두 만듭니다.

대화형 채팅

Code 뷰에서 다음 방법 중 하나를 사용하여 .idx/mcp.json를 만듭니다.

명령어 팔레트: 명령어 팔레트 (Shift+Ctrl+P)를 열고 Firebase Studio: MCP 서버 추가 명령어를 사용합니다.
대화형 채팅: 대화형 채팅에서 도구 맞춤설정을 클릭하고 MCP 서버 추가를 선택합니다.
탐색기: 탐색기 (Ctrl+Shift+E)에서 .idx 디렉터리를 마우스 오른쪽 버튼으로 클릭하고 새 파일을 선택합니다. 파일 이름을 mcp.json로 지정합니다.

Gemini CLI

Code 뷰에서 .gemini/settings.json을 만듭니다.

탐색기 (Ctrl+Shift+E)에서 .gemini 디렉터리가 있는지 확인합니다. 그렇지 않은 경우 탐색기 창을 마우스 오른쪽 버튼으로 클릭하고 새 폴더를 선택합니다. 폴더 이름을 .gemini로 지정합니다.
.gemini 디렉터리를 마우스 오른쪽 버튼으로 클릭하고 New file을 선택합니다. 파일 이름을 settings.json로 지정합니다.

Gemini CLI에서 MCP 서버를 사용하는 방법에 대한 자세한 내용은 전체 문서를 검토하세요.

2단계: 서버 구성 수정

서버 구성 파일을 엽니다.

도움말: .idx/mcp.json을 빠르게 열려면 대화형 채팅에서 도구 맞춤설정을 클릭하고 구성 수정을 선택합니다.
파일의 콘텐츠에 서버 구성을 추가합니다. 예를 들어 Firebase MCP 서버를 추가하려면 다음을 입력합니다.
```
{
  "mcpServers": {
   "firebase": {
     "command": "npx",
     "args": [
       "-y",
       "firebase-tools@latest",
       "experimental:mcp"
      ]
    }
  }
}
```
이 구성 파일은 Gemini에 사용할 MCP 서버를 알려줍니다. 이 예에서는 npx 명령어를 사용하여 firebase-tools@latest를 설치하고 실행하는 firebase라는 서버를 하나 보여줍니다.

MCP 서버에 API 키 인증이 필요한 경우 다음 방법 중 하나로 구성할 수 있습니다.
- 요청 헤더에 API 키가 필요한 원격 HTTP MCP 서버의 경우 headers 필드를 사용합니다. 예를 들어 GitHub의 MCP 서버를 구성하려면 다음을 실행합니다.
```
{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}
```
- 환경 변수에 API 키가 필요한 로컬 stdio MCP 서버의 경우 env 필드를 사용합니다. 예를 들어 GitHub의 MCP 서버 로컬 빌드를 구성하려면 다음을 실행합니다.
```
{
  "mcpServers": {
    "github": {
      "command": "/path/to/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}
```
터미널(Shift+Ctrl+C)에서 필요한 명령어를 실행하여 설치를 완료합니다. 예를 들어 Firebase MCP 서버를 사용하려면 다음 명령어를 입력하여 계정에 로그인합니다.
```
firebase login --no-localhost
```
터미널의 안내에 따라 세션을 승인합니다. 일부 도구에는 연결된 Firebase 프로젝트가 필요합니다. Firebase MCP 서버를 사용하여 프로젝트를 만들거나 다음 명령어를 실행하여 Firebase 프로젝트를 초기화할 수 있습니다.
```
firebase init
```
이렇게 하면 루트 디렉터리에 firebase.json 파일이 생성됩니다.

MCP 도구 사용

사용하려는 MCP 서버를 설치하면 이 서버에서 제공하는 도구나 데이터를 다음 위치에서 사용할 수 있습니다.

Gemini CLI
에이전트 모드 및 에이전트(자동 실행) 모드 사용 시 대화형 채팅
App Prototyping agent

예를 들어 Firebase MCP 서버를 추가하면 Gemini에 현재 프로젝트의 SDK 구성을 가져오고, Cloud Firestore 및 Realtime Database에 저장된 데이터를 검색하고, Firebase 서비스 설정 지원 등 다양한 작업을 요청할 수 있습니다.

대화형 채팅에서 /를 입력하여 사용 가능한 MCP 프롬프트 목록을 확인합니다.

사용 가능한 MCP 프롬프트 목록

도구 확인 또는 조정

대화형 채팅에서 활성화된 도구를 관리할 수 있습니다.

대화형 채팅에서 도구 맞춤설정을 클릭하여 구성된 MCP 서버에서 사용 가능한 모든 도구 목록을 확인합니다.
체크박스를 사용하여 전체 서버 또는 개별 도구를 사용 설정 또는 사용 중지합니다.

사용 가능한 MCP 도구 목록

MCP 서버 문제 해결

MCP 서버에 문제가 발생하면 다음 단계에 따라 문제를 진단하세요.

로그에서 오류 확인

출력 패널 (Shift+Ctrl+U)을 엽니다.
드롭다운 메뉴에서 Gemini를 선택합니다.
[MCPManager] 태그로 시작하는 메시지를 확인합니다. 이러한 로그에는 구성된 서버, 성공적으로 추가된 도구, 오류 메시지가 표시됩니다.

환경 다시 빌드

MCP 서버가 설치되거나 연결되지 않으면 다음과 같이 작업공간을 다시 빌드해 보세요.

명령어 팔레트(Shift+Ctrl+P)를 엽니다.
Firebase Studio: Rebuild Environment 명령어를 실행합니다.
작업공간이 다시 빌드된 후 MCP 서버가 연결되는지 확인합니다.

도구를 사용하지 않는 경우

MCP 서버가 연결되지만 Gemini가 도구를 사용하지 않는 경우:

새 채팅 세션 시작: 이렇게 하면 Gemini가 최신 도구 구성을 선택합니다. 채팅 기록을 관리하는 방법 알아보기
프롬프트에서 구체적으로 설명: Gemini가 MCP 도구를 사용하지 않고 태스크를 완료할 수 있는 경우 다른 방법을 시도할 수 있습니다. 특정 도구를 사용하려면 도구 이름을 지정해 보세요. 예를 들어 'firebase_get_sdk_config를 사용하여 현재 프로젝트의 SDK 구성을 가져와'라고 말할 수 있습니다.
Google Developer Program 가입: 계정이 등록되어 있는지 확인합니다.