Gemini MCP와 Skills로 코딩 어시스턴트 설정하기

AI 코딩 어시스턴트는 강력하지만 한계가 있어요—학습 데이터가 특정 시점에서 끊겨 새 API 기능과 변경 사항을 모르거든요. Gemini 전용 문서에 접근할 수 없으면 에이전트가 최적화된 접근 대신 일반적인 패턴을 제안할 수 있어요.

진화하는 Gemini API와 권장 사용법에 코딩 어시스턴트를 최신으로 유지하려면 Gemini Docs MCP를 설정하고 Gemini API Skills로 환경을 보강하길 권장해요. 이 도구들은 개별적으로 쓸 수 있지만 함께 쓰도록 설계되어 완전한 커버리지를 제공해요.

출처: 원문

본문

Gemini Docs MCP 연결하기

Gemini는 https://gemini-api-docs-mcp.dev에서 공개 MCP(Model Context Protocol) 서버를 호스팅해요. 코딩 에이전트를 이 서버에 연결하면 모든 쿼리가 최신 API·코드 업데이트·최적 구성 예제에 접근할 수 있어요.

에이전트의 터미널이나 프로젝트 루트에서 다음 명령을 실행해 서버를 설치하세요.

npx add-mcp "https://gemini-api-docs-mcp.dev"

이 서버는 에이전트가 공식 Gemini 문서 파일에서 실시간 API 정의와 통합 패턴을 가져오는 데 쓸 수 있는 search_documentation 함수를 추가해요.

API 개발 Skills 추가하기

이 스킬들은 내장된 규칙과 모범 사례(예: 올바른 SDK와 현재 모델 버전 강제)를 어시스턴트 컨텍스트에 직접 제공해요. 이 스킬은 Gemini Docs MCP 서비스와 함께 작동해요. 둘 다 설치하면 스킬이 문서용으로 MCP 서비스를 사용하지만, MCP가 없어도 ai.google.dev에서 /gemini-api/docs/llms.txt를 가져와 폴백해요(개별 페이지는 .md.txt를 붙여 raw Markdown으로 가져올 수도 있어요. 예: https://ai.google.dev/gemini-api/docs/speech-generation.md.txt).

이 스킬들은 다음 지원 도구 중 하나로 설치할 수 있어요. 각 스킬 모듈 아래에 설치 방법이 제공돼요.

skills.sh: 권장. 이식 가능한 에이전트 동작의 공개 표준.
Context7: 이미 Context7 생태계를 쓰는 사용자 지원.

gemini-api-dev

Gemini API(Interactions API)로 앱을 빌드하는 스킬이에요. Interactions API는 Gemini 모델·에이전트로 빌드하는 가장 간단하고 좋은 방법이에요. 이 스킬은 다음을 다뤄요.

텍스트 생성, 다중 턴 채팅, 스트리밍
함수 호출, 구조화 출력, 이미지 생성
백그라운드 실행과 Deep Research 에이전트
서버 측 대화 상태 관리
현재 모델로의 프롬프트 라우팅과 폐기 모델 회피
Python·TypeScript SDK 패턴

skills.sh로 설치

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

Context7로 설치

npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev

gemini-live-api-dev

Gemini Live API로 실시간 대화형 AI 애플리케이션을 빌드하는 스킬이에요. 이 스킬은 다음에 대한 문서와 모범 사례를 제공해요.

저지연 스트리밍을 위한 WebSocket 연결
오디오·비디오·텍스트 스트리밍
음성 활동 감지와 barge-in 지원

skills.sh로 설치

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

Context7로 설치

npx ctx7 skills install /google-gemini/gemini-skills gemini-live-api-dev

설치 확인

설치 후 코딩 어시스턴트가 Gemini Docs MCP 서버에 연결되고 설치한 스킬을 사용할 수 있는지 확인하세요.

1. 에이전트 동작 확인

가장 확실한 방법은 에이전트에게 Gemini API에 대한 기술 질문을 하는 거예요.

프롬프트: "How do I use context caching with the Gemini API?"

성공적인 설정은 다음을 보여줘요.

정확한 코드 제공: 최신 엔드포인트의 cacheContent나 cachedContents.create 같은 특정 Gemini 메서드를 참조해요.
MCP 도구 사용: Gemini Docs MCP Server에 연결됐거나 search_documentation 도구를 사용해 데이터를 가져오는 걸 보여줘요.
로드된 스킬 호출: "Using skill: gemini-api-dev" 표시를 보여줘요(보조 래퍼에 의존하는 경우).

2. 매니페스트와 도구 확인

에이전트가 일반적이거나 막연한 답을 주면 환경에 맞는 특정 Discovery 또는 Status 명령을 사용해 Docs MCP나 스킬이 메모리에 로드됐는지 확인하세요.

환경	MCP 확인	Skills 확인
Claude Code	터미널에 `/mcp`를 입력해 활성 서버와 `search_documentation` 도구를 확인.	터미널에 `/skills`를 입력해 활성 매니페스트를 나열.
Cursor	Settings > Features > MCP로 이동해 서버가 "Connected"인지 확인.	Settings > Rules를 열어 "Agent Decides" 아래 스킬이 나타나는지 확인.
Antigravity	Customizations > Connections 사이드바에서 MCP 상태 확인.	`/skills list`를 입력하거나 Customizations > Rules 사이드바 확인.
Gemini CLI	`gemini mcp list` 또는 `/mcp list` 실행.	`gemini skills list` 또는 세션 내 `/skills` 슬래시 명령 사용.
Copilot	`@gemini /mcp`를 입력해 활성 데이터 커넥터 나열.	`@gemini /skills`(또는 `/skills`)로 활성 확장 보기.

문제 해결

에이전트가 일반적인 정보만 주거나 Gemini 특정 메서드를 인식하지 못하면 다음을 확인하세요.

에이전트가 스킬을 발견하지 못한 경우

대부분의 에이전트는 시작 시에만 스킬을 인덱싱해요.

해결: IDE(Cursor/VS Code)를 완전히 재시작하거나 터미널 기반 에이전트(Claude Code)를 닫고 다시 열어요.

글로벌 vs 로컬 충돌

--global 플래그로 설치했다면 에이전트가 프로젝트별 규칙을 우선해 이를 무시할 수 있어요.

해결: 글로벌 플래그 없이 프로젝트 루트에 스킬을 직접 설치해 보세요.

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

Gemini MCP와 Skills로 코딩 어시스턴트 설정하기