코딩 에이전트에서 Haystack 문서 사용하기
코딩 에이전트에서 Haystack 문서 사용하기 (Using Haystack Docs in Your Coding Agent)
코딩 에이전트(Claude Code, Cursor, GitHub Copilot 등)에서 Haystack 공식 문서를 검색해서 답변에 활용하고 싶다면, Haystack이 제공하는 공개 Model Context Protocol (MCP) 서버를 연결하면 됩니다.
출처: 공식문서
서버는 무엇을 제공하나요?
이 서버는 search_haystack_docs라는 단일 도구를 노출하며, 관련 문서 섹션과 소스 URL을 반환해요. API 키나 회원가입이 필요 없습니다.
서버 URL
https://docs.haystack.deepset.ai/api/mcp
이 서버는 HTTP 전송 방식을 사용합니다. 대부분의 에이전트는 이를 자동으로 감지하는데, 내 에이전트가 선택지를 물어본다면 http를 고르면 됩니다.
설정 (Setup)
Claude Code
claude mcp CLI로 서버를 추가하세요:
claude mcp add --transport http haystack-docs https://docs.haystack.deepset.ai/api/mcp
Claude Code 세션을 재시작하고 /mcp를 실행해 연결을 확인합니다. haystack-docs가 search_haystack_docs 도구와 함께 목록에 보이면 성공이에요. (프로젝트 vs. 사용자 스코프, SSE 전송, 헤더 등 더 많은 옵션은 Claude Code MCP 문서를 참고하세요.)
Cursor
Cursor에서는 MCP 서버 설정 화면에서 HTTP (URL)로 위 URL을 추가하면 됩니다. 에이전트가 자동으로 search_haystack_docs 도구를 사용할 수 있게 됩니다.
GitHub Copilot
GitHub Copilot 역시 MCP 서버를 지원하므로, 동일하게 위 서버 URL을 MCP 서버로 등록해서 사용할 수 있어요.
정상 동작 확인하기
에이전트가 search_haystack_docs를 호출하고, 답변에서 docs.haystack.deepset.ai 아래의 소스 URL을 인용해야 정상이에요. 만약 에이전트가 도구를 호출하지 않고 답변만 한다면, "Use the haystack-docs MCP server to answer."처럼 명시적으로 지시해 보세요.