원격 MCP로 에이전트 네이티브 웹 검색하기

누구에게 맞나

AI 에이전트에 웹 검색을 시키고, 전통 검색 엔진이 아니라 모델 네이티브 검색과 에이전트 검색 제공자를 모으는 것을 받아들일 사람을 위한 것이다. 공식 문구는 Agent-native web search for AI agents — aggregating model-native search and agent search providers, not traditional search engines다.

호환 목록은 Codex CLI, Claude Code, OpenCode, Hermes, 그리고 일반 shell, Python 앱, remote Streamable HTTP MCP clients를 가리킨다.

원격 배포를 한 번 할 수 있고 검색 요청이 이 기기를 떠나는 것을 받아들일 때 맞다. 공식은 No telemetry, no shared secrets, Provider keys stay in runtime environment variables라고 쓴다. 공유 API-key 서비스가 없다고 네트워크가 없는 것도, 프라이버시 경계가 없는 것도 아니다.

저장소: https://github.com/JerryLiu369/agent-web-search

3분 만에 첫 시도

One-click remote MCP만 따른다. 공식 배포 입구는 https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FJerryLiu369%2Fagent-web-search&env=AGENT_WEB_SEARCH_AUTH_TOKEN

전제: 환경 변수 이름 AGENT_WEB_SEARCH_AUTH_TOKEN에 대응하는 실제 토큰을 준비한다. 자리 표시 값을 넣지 마라. 페이지는 로컬 npx나 pip 시작 명령을 쓰지 않았으므로 설치 줄을 스스로 보태지 마라.

낮은 위험 호출: 네이티브 MCP 도구로 검색을 한 번 한다. 공식은 a native MCP tool이라고 쓰지만 함수 이름은 없다. 같은 provider-neutral search core로 쓰면 된다.

성공 신호: 정규화된 results를 얻는 것이다. 공식 설명은 result 필드를 나열하지 않았다. model-backed providers는 answer도 반환할 수 있다. 처음에는 results가 나타나는지만 확인한다.

원격 검색은 위험이 0이 아니다. 질의는 배포한 서비스와 백엔드 제공자로 간다.

사용 사례

사례 1: 네이티브 MCP 도구로 한 번 검색한다. 배포와 토큰 설정 후 에이전트가 검색하게 하고, 반환이 정규화 results인지 확인한다. 인터페이스를 어떤 전통 검색 엔진의 네이티브 API로 이해하지 마라.

사례 2: 모델 백엔드가 켜져 있을 때 answer도 본다. 공식은 Every backend is available through the same MCP tool, CLI, Python API, and normalized results라고 쓰며, model-backed providers may also return an answer. 두 번째도 같은 계약을 쓰고 answer가 나타나는지만 확인한다. 페이지는 CLI 실행 파일 이름을 쓰지 않았으므로 명령줄을 만들지 마라.

사용 한계

같은 코어는 standard Agent Skill로 CLI에 가르칠 수도 있지만 스킬 파일 경로와 명령은 나오지 않는다. 제공자 키는 런타임 환경 변수에만 둔다.

저장소 제목은 free keyless defaults를 말하지만 본문은 동시에 인증 토큰과 제공자 키를 요구한다. 토큰이 없으면 배포하지 마라. 두 번째 MCP 도구 이름을 만들지 마라.