AI와 함께 코딩하기¶

AI 코딩 어시스턴트를 사용해 Agent Development Kit(ADK)로 에이전트를 구축할 수 있습니다. 프로젝트에 개발 스킬을 설치하거나 MCP 서버를 통해 ADK 문서를 연결해 코딩 에이전트에 ADK 전문성을 제공하세요.

ADK Dev Skills: ADK 개발 스킬을 프로젝트에 직접 설치합니다.
ADK Docs MCP Server: MCP 서버를 통해 코딩 도구를 ADK 문서에 연결합니다.
ADK Docs Index: llms.txt 표준을 따르는 머신 리더블 문서 파일입니다.

ADK Dev Skills¶

ADK는 API, 코딩 패턴, 배포, 평가를 다루는 개발 skills 세트를 제공합니다. 이 스킬은 Gemini CLI, Antigravity, Claude Code, Cursor를 포함한 모든 호환 도구에서 작동합니다.

ADK 개발 스킬을 설치하려면 프로젝트 디렉터리에서 다음 명령을 실행하세요.

npx skills add google/adk-docs/skills -y -g

다음이 포함된 GitHub의 ADK Dev Skills를 살펴보세요.

Skill	설명
`adk-cheatsheet`	Python API 빠른 참조 및 문서 인덱스
`adk-deploy-guide`	Agent Engine 및 Cloud Run 배포
`adk-dev-guide`	개발 수명 주기 및 코딩 가이드라인
`adk-eval-guide`	평가 방법론 및 점수화
`adk-observability-guide`	트레이싱, 로깅 및 통합
`adk-scaffold`	프로젝트 스캐폴딩

ADK Docs MCP Server¶

MCP 서버를 사용하도록 코딩 도구를 구성하면 ADK 문서를 검색하고 읽을 수 있습니다. 아래에는 널리 쓰이는 도구의 설정 방법이 나와 있습니다.

Gemini CLI¶

Gemini CLI에 ADK 문서 MCP 서버를 추가하려면 ADK Docs Extension을 설치하세요.

gemini extensions install https://github.com/derailed-dash/adk-docs-ext

Antigravity¶

Antigravity에 ADK 문서 MCP 서버를 추가하려면(uv 필요):

에디터 상단 에이전트 패널의 ...(더보기) 메뉴에서 MCP 스토어를 엽니다.
Manage MCP Servers를 클릭한 다음 View raw config를 클릭합니다.

mcp_config.json에 다음 내용을 추가합니다.

{
  "mcpServers": {
    "adk-docs-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpdoc",
        "mcpdoc",
        "--urls",
        "AgentDevelopmentKit:https://google.github.io/adk-docs/llms.txt",
        "--transport",
        "stdio"
      ]
    }
  }
}

Claude Code¶

Claude Code에 ADK 문서 MCP 서버를 추가하려면 다음을 실행하세요.

claude mcp add adk-docs --transport stdio -- uvx --from mcpdoc mcpdoc --urls AgentDevelopmentKit:https://google.github.io/adk-docs/llms.txt --transport stdio

Cursor¶

Cursor에 ADK 문서 MCP 서버를 추가하려면 (uv 필요):

Cursor Settings를 열고 Tools & MCP 탭으로 이동합니다.
New MCP Server를 클릭하면 mcp.json 편집기가 열립니다.

mcp.json에 다음 내용을 추가합니다.

{
  "mcpServers": {
    "adk-docs-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpdoc",
        "mcpdoc",
        "--urls",
        "AgentDevelopmentKit:https://google.github.io/adk-docs/llms.txt",
        "--transport",
        "stdio"
      ]
    }
  }
}

Other Tools¶

MCP 서버를 지원하는 모든 코딩 도구는 위와 같은 서버 구성을 사용할 수 있습니다. 사용하는 도구의 MCP 설정에 맞게 Antigravity 또는 Cursor 섹션의 JSON 예시를 조정하세요.

ADK Docs Index¶

ADK 문서는 llms.txt 표준을 따르는 머신 리더블 파일로 제공됩니다. 이 파일은 문서가 업데이트될 때마다 생성되며 항상 최신 상태를 유지합니다.

파일	설명	URL
`llms.txt`	링크가 포함된 문서 인덱스	`google.github.io/adk-docs/llms.txt`
`llms-full.txt`	전체 문서를 하나의 파일로 제공	`google.github.io/adk-docs/llms-full.txt`