Minds를 Gemini CLI에 연결하기: 확장 프로그램과 MCP 설정

Minds는 상업용 합성 리서치를 위한 엔드투엔드 플랫폼입니다. Gemini CLI를 사용하면 터미널에서 Audience를 찾고, Study를 계획하고, 제안된 리서치 계획을 검토하고, 결과를 읽을 수 있습니다. Gemini CLI는 https://getminds.ai/mcp의 Minds MCP 서버와 통신하며, 사용자는 OAuth로 Minds 계정에 로그인합니다.

요구 사항

• Gemini CLI가 설치되어 있고 Gemini API 키, Vertex AI 또는 Gemini Code Assist Standard/Enterprise 라이선스로 로그인되어 있어야 합니다. 2026년 6월부터 Gemini CLI는 개인 Google 계정을 지원하지 않으며, Google은 개인 사용자에게 Antigravity CLI를 안내합니다. Google Antigravity에서 Minds 사용하기를 참고하세요.
• Minds 계정. 계정이 없다면 처음 연결할 때 가입할 수 있습니다.
• OAuth 로그인을 위한 같은 컴퓨터의 브라우저, 또는 브라우저가 없는 환경을 위한 Minds API 키.

어떤 방법이 맞을까요?

설정마다 한 가지 방법만 사용하세요. 확장 프로그램과 수동 항목 모두 minds라는 서버를 등록하므로 하나만 남겨 두세요.

방법 A: Minds 확장 프로그램 설치하기

1. 설치

gemini extensions install https://github.com/minds-ai-co/minds-mcp

Gemini CLI가 확장 프로그램이 추가하는 항목을 보여 줍니다. https://getminds.ai/mcp의 원격 MCP 서버 minds와 컨텍스트 파일 GEMINI.md입니다. 이 파일은 실행을 시작하기 전에 리서치 질문을 명확히 하고 스터디 계획을 확인받도록 에이전트에 지시합니다. Y로 확인하세요. 현재 폴더를 아직 신뢰하지 않았다면 Gemini CLI가 먼저 신뢰 여부를 묻습니다.

2. 설치 확인

gemini extensions list

minds-mcp가 MCP 서버 minds와 함께 표시됩니다. 로그인하기 전까지 gemini mcp list에서는 서버가 연결되지 않음으로 표시됩니다.

3. Minds에 로그인

gemini를 시작하세요. 처음 연결할 때 Gemini CLI가 브라우저에서 Minds 로그인 페이지를 엽니다. 로그인하고 Allow를 선택하세요. 로그인을 직접 시작하거나 나중에 다시 로그인하려면 세션에서 /mcp auth minds를 실행하세요. 이후 /mcp list에 Minds가 도구와 함께 연결됨으로 표시됩니다.

4. 최신 상태로 유지

gemini extensions update minds-mcp

방법 B: Minds를 MCP 서버로 추가하기

모든 폴더에서 사용할 수 있도록 사용자 범위로 서버를 추가하세요.

gemini mcp add --scope user --transport http minds https://getminds.ai/mcp

--scope user를 빼면 Gemini CLI는 현재 프로젝트의 .gemini/settings.json에 항목을 씁니다. ~/.gemini/settings.json을 직접 편집할 수도 있습니다. 스트리밍 HTTP에는 httpUrl을 사용하세요. url은 이전 SSE 전송 방식을 선택합니다.

{
  "mcpServers": {
    "minds": { "httpUrl": "https://getminds.ai/mcp" }
  }
}

gemini를 시작하고 방법 A의 3단계처럼 로그인하세요.

OAuth와 API 키 중 무엇을 쓸까요?

• OAuth (권장): Minds 계정으로 로그인합니다. Gemini CLI가 Minds에 자동으로 등록되므로 클라이언트 ID나 시크릿이 필요 없고, 각자 자신의 계정을 연결합니다.
• API 키: CI 작업이나 공유 서비스 계정처럼 브라우저가 없는 환경용입니다. Settings → API Keys에서 키를 만들고 헤더로 추가하세요.

gemini mcp add --scope user --transport http --header "Authorization: Bearer minds_YOUR_API_KEY" minds https://getminds.ai/mcp

키는 settings.json에 평문으로 저장됩니다. 이 파일을 버전 관리에 포함하지 말고, 개인 컴퓨터에서는 OAuth를 우선 사용하세요.

방법 C: Google Antigravity

Antigravity는 별도의 설정을 사용합니다. 원격 서버는 ~/.gemini/config/mcp_config.json 또는 .agents/mcp_config.json에 serverUrl로 정의하고, 로그인은 Settings → Customizations → Authenticate에서 진행합니다. Antigravity 가이드에서 세 가지 Antigravity 환경을 모두 다룹니다.

Gemini CLI에서 Antigravity CLI로 옮기시나요? agy plugin import gemini를 실행하면 설치된 Minds 확장 프로그램이 같은 서버를 쓰는 Antigravity 플러그인으로 변환됩니다.

Gemini 앱과 Gemini Enterprise

Google은 Gemini 앱(미국의 개인 계정)과 Gemini Enterprise에서도 맞춤 MCP 연결을 안내합니다. 아직은 이곳에 Minds를 연결할 수 없습니다. Minds가 이 커넥터를 지원할 때까지 Gemini CLI 또는 Google Antigravity를 사용하세요.

Gemini CLI에서 Minds가 작동하는 방식

• 먼저 계획: 무엇이든 실행하기 전에 에이전트가 리서치 계획을 제시하고 승인을 받습니다. Study는 확인한 뒤에만 시작됩니다.
• 긴 실행은 서버에서 계속: Study는 Minds에서 지속적으로 실행되므로 터미널을 닫아도 계속됩니다. 나중에 Gemini CLI에 상태를 물어보세요.
• Minds에서 더 깊이: 결과는 Minds의 Study로 연결되며, 그곳에서 개별 응답을 검토하고 Audience를 비교하고 결과를 내보낼 수 있습니다.

Gemini CLI가 사용할 수 있는 도구는 도구 참조에 나와 있습니다. MCP 개요에서 연동 전체를 설명합니다.

문제 해결

Minds가 연결되지 않음으로 표시됩니다. Gemini CLI 세션에서 /mcp auth minds를 실행하고 브라우저에서 로그인을 완료하세요.

로그인 페이지가 열리지 않습니다. Gemini CLI는 로컬 포트에서 OAuth 콜백을 받으므로 브라우저가 같은 컴퓨터에서 실행되어야 합니다. SSH나 컨테이너에서는 API 키를 사용하세요.

Minds 서버가 두 개이거나 도구가 중복됩니다. 확장 프로그램과 수동 항목이 모두 활성화되어 있습니다. gemini extensions uninstall minds-mcp 또는 gemini mcp remove minds로 하나를 삭제하세요.

Minds에서 열 수 있는 Study나 Audience에 "Not authorized"가 표시됩니다. Gemini CLI가 Study 소유자와 다른 Minds 계정에 연결되어 있습니다. 올바른 계정으로 /mcp auth minds를 다시 실행하거나 연결된 계정과 Study를 공유하세요.

새 Minds 도구가 나타나지 않습니다. 도구 목록을 다시 불러오도록 Gemini CLI를 다시 시작하고, 확장 프로그램을 사용한다면 gemini extensions update minds-mcp를 실행하세요.

ChatGPT, Claude, Codex 같은 다른 클라이언트는 연동 개요에 나와 있습니다.

MCP 서버 URL

https://getminds.ai/mcp

전체 MCP 문서 보기