설정 파일이 익숙하지 않다면 이 글을 Antigravity Agent에 공유하고 워크스페이스 설정을 준비해 달라고 요청하세요. 변경 diff를 검토한 뒤 API 키는 로컬에서 입력하세요. 실제 키를 Agent 대화에 입력하지 마세요.
이 가이드를 따라 현재 Antigravity 워크스페이스에 DeepSeek Search를 연결해 주세요.
편집 전에 기존 .agents 파일을 확인하세요. 다른 프로젝트에 영향을 주지 않도록
워크스페이스 범위를 우선하고, 기존 MCP 구성을 재사용하며, 변경 사항을 하나씩
설명해 주세요. 키를 읽거나 출력하거나 채팅으로 전송하지 마세요. 키를 로컬에서
입력할 위치와 MCP 다시 불러오기 방법, 도구 표시 여부를 확인하는 방법을 알려
주세요. 먼저 알리지 않고 실제 요청을 보내지 마세요.Antigravity는 Agent 화면에서 MCP를 관리합니다. IDE에는 MCP Store와 원시 설정 보기가 있고, CLI에는 연결 상태와 로그를 확인할 수 있는 대화형 /mcp 관리자가 있습니다. 워크스페이스 설정 경로인 .agents/mcp_config.json을 사용하면 이 검색 커넥터를 하나의 프로젝트에만 연결할 수 있습니다. 모든 워크스페이스에서 사용할 때만 전역 파일을 선택하세요. Google Antigravity MCP 문서
추가하기 전에 적용 범위 선택하기
워크스페이스 설정은 커넥터를 한 프로젝트에 제한하고, 전역 설정은 여러 프로젝트에서 사용할 수 있게 합니다.
범위 | 설정 파일 | 효과 |
|---|---|---|
워크스페이스 |
| 현재 프로젝트만 로컬 DeepSeek 브리지를 불러옴 |
전역 |
| 여러 Antigravity 워크스페이스에서 사용 가능 |
영구 설정 없음 | 터미널에서 cURL 요청 1회 | Agent 도구를 추가하지 않고 한 번 검색 |
첫 테스트에는 워크스페이스 범위를 선택하세요. Antigravity의 Agent 권한 설정은 터미널 명령, 파일 접근, MCP 도구, 브라우저 읽기를 관리합니다. 평소 작업 방식에 맞는 승인 프리셋을 그대로 사용하세요. MCP 서버를 연결하기 위해 제한 없는 모드로 전환할 필요는 없습니다. Agent 설정
MCP Manager에서 연결 상태 확인하기
IDE에서 Agent 패널 메뉴를 열고 MCP Servers → Manage MCP Servers → View raw config를 선택하세요. CLI에서는 /mcp를 입력해 관리자를 엽니다. 기존 mcpServers 객체에 서버를 추가하세요. Node 브리지와 종속성 설정에는 검증된 Claude Code 튜토리얼의 어댑터를 재사용할 수 있습니다. Antigravity는 로컬 stdio로 이를 실행합니다.
{
"mcpServers": {
"deepseek-search": {
"command": "node",
"args": ["--env-file=/absolute/path/deepseek-search-mcp/.env", "/absolute/path/deepseek-search-mcp/server.mjs"]
}
}
}Node는 서버를 시작하기 전에 별도의 .env 파일에서 키를 읽습니다. 키 파일과 개인 로컬 경로가 드러나는 워크스페이스 설정은 Git에 커밋하지 마세요. 설정 파일 자체에는 인증 정보가 없습니다.
Antigravity 문서에는 전역 및 워크스페이스 파일 경로가 안내되어 있으며, 원격 MCP 연결에는 serverUrl이 지정되어 있습니다. 이 예제는 로컬 stdio이므로 추측한 원격 URL 필드 대신 command와 args를 사용합니다. 편집한 뒤 관리자에서 MCP 설정을 다시 불러오고 실시간 상태 표시를 확인하세요. MCP 설정 형식 및 위치
Agent의 출처 검증을 테스트하기
연결된 브리지는 전송이 가능하다는 뜻이고, 가져온 출처는 답변의 근거를 확인하게 해 줍니다.
프로젝트에서 사용하는 종속성의 최신 안정 버전처럼 현재 시점의 기술 질문을 Antigravity에 조사하도록 요청하세요. 다음 단계를 명시합니다.
- 공식 문서를 검색합니다.
- 결과 URL 하나를 가져옵니다.
- 가져온 페이지가 뒷받침하는 경우에만 버전이나 요구사항을 말합니다.
- 원본 문서 URL을 인용합니다.
Agent 도구 활동이나 CLI MCP 로그를 확인하세요. 연결 상태는 Antigravity가 브리지를 시작했다는 사실만 보여 줍니다. Agent가 Search와 Fetch를 호출하고 답변이 반환된 출처 내용과 일치해야 테스트를 마친 것입니다. 가져온 페이지 내용은 신뢰할 수 없는 입력으로 취급하세요. 다른 공개 웹페이지처럼 프롬프트 인젝션이 포함될 수 있습니다.
MCP 설정 없이 터미널 사용하기
MCP 없이 반복해서 조회하려면 Claude Code 가이드에 연결된 종속성 없는 search-cli.mjs를 사용하세요. Antigravity에 node --env-file="/absolute/path/.env" /absolute/path/search-cli.mjs search "QUERY" 3을 실행한 다음, 직접 선택한 결과에 fetch "SOURCE_URL"을 실행하도록 요청합니다. 일반 터미널 명령이므로 기존 권한 프리셋에 따라 검토하고 승인하세요.
한 번만 조회할 때는 MCP 대신 요청을 검토한 뒤 cURL을 실행할 수 있습니다. 터미널에 키를 입력할 때 화면에 표시되지 않도록 하세요.
read -r -s DEEPSEEK_API_KEY
export DEEPSEEK_API_KEY
curl --fail-with-body --max-time 20 \
https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"site:developer.chrome.com/docs extensions service worker lifecycle","count":3,"need_content":false}'응답에는 후보 출처 URL이 포함됩니다. 주장을 확인하려면 선택한 URL을 {"url":"https://..."} 형식으로 Fetch 엔드포인트에 보내고 반환된 Markdown을 읽으세요. 검색 요약은 살펴볼 대상을 고르는 데 도움을 주지만 페이지 본문을 대신하지는 않습니다. DeepSeek Search 및 Fetch API 가이드
Antigravity에 연결 끊김이 표시될 때
/mcp를 열고 연결 로그를 확인하세요. Node가 설치되어 Antigravity 프로세스에서 실행 경로를 찾을 수 있는지, 설정 경로가 존재하는지, MCP 프로세스가 API 키를 사용할 수 있는지, 설정 파일이 유효한 JSON인지 점검합니다. 원인을 수정한 뒤 한 번 다시 불러오세요. 서버 연결은 됐는데 답변에 인용이 없다면 간단한 프로젝트 규칙을 추가하거나 작업 프롬프트에 Search → Fetch → cite 요구사항을 포함하세요.
2026 Stack Overflow AI 코딩 에이전트 설문에서는 Google Antigravity가 제품명으로 포함되었고, “사용함” 항목 응답자의 16%가 언급했습니다. 이는 설문 결과이지 시장 점유율 추정치가 아닙니다. 이 가이드는 Antigravity가 현재 문서화한 워크플로를 다룹니다. 설문 데이터
설정이 완료된 기준
- 워크스페이스 MCP Manager에
deepseek-search가 활성화되어 표시됩니다. - 테스트 기록에 Search와 Fetch 호출이 모두 남아 있습니다.
- 답변은 가져온 내용이 뒷받침하는 페이지를 인용합니다.
- 저장소에 실제 API 키가 포함되어 있지 않습니다.
작성자: Jasper Quinn. Auspia에서 AI 검색 제품 연구원으로 60건 이상의 기능 변경을 추적했습니다. 변화가 빠른 AI 검색 제품과 실제 사용 방식에 관해 글을 씁니다.
