Authentication
모든 요청(MCP 및 REST API 모두)은 API 키 또는 Entra ID 액세스 토큰을 사용하여 인증할 수 있습니다. 자세한 설정 지침은 인증을 참조하세요.
MCP 서버 통합
Web IQ MCP 서버를 사용하면 AI 에이전트가 Microsoft Web IQ 제품에서 제공하는 다양한 검색 기능과 원활하게 통합할 수 있습니다. 이 통합을 통해 AI 모델은 웹, 뉴스, 비디오, 이미지의 최신 콘텐츠 및 찾아보기 기능에 실시간으로 액세스할 수 있습니다.
도구 결과는 REST 응답과 동일한 필드 존재 규칙을 따릅니다. null, 빈 문자열 및 빈 목록/배열 모델 필드는 구조화된 콘텐츠와 JSON 텍스트 대체 모두에서 생략됩니다. 없는 목록 필드를 항목이 없는 것으로 처리합니다. 공백 전용 문자열, false, 0빈 사전, 배열/사전 항목 및 포함된 원시 JSON이 유지됩니다. MCP 요청 매개 변수, JSON-RPC 식별자 또는 프로토콜 봉투 배열(예: content)은 변경되지 않습니다.
끝점:mcp https://api.microsoft.ai/v3/mcp
사용 가능한 MCP 도구:
-
web- 웹 검색 및 웹페이지 콘텐츠 가져오기 -
videos- 관련 비디오 검색 -
browse- 특정 URL에서 콘텐츠 가져오기 -
news- 최신 뉴스 기사 검색 -
images- 관련 이미지 검색
Note
WebIQ MCP 서버에서 노출하는 도구는 계정의 허용된 서비스 목록으로 제한됩니다. API 키 또는 Entra ID 액세스 토큰에 특정 도구에 대한 권한이 없는 경우 해당 도구는 MCP 도구 목록에 표시되지 않습니다. 추가 도구에 대한 액세스를 요청하려면 Microsoft 담당자에게 문의하세요.
MCP 서버 구성:
VS Code Copilot 또는 기타 MCP 호환 클라이언트와 함께 사용하려면 이것을 mcp.json 파일에 추가하세요:
{
"mcpServers": {
"WebIQ-MCP": {
"url": "https://api.microsoft.ai/v3/mcp",
"type": "http",
"headers": {
"x-apikey": "<your-api-key>"
}
}
}
}
Copilot CLI의 경우 다음 위치에 있는 구성 파일에 다음 내용을 추가합니다:
- Mac/Linux:
~/.copilot/mcp-config.json - 윈도우:
%USERPROFILE%\.copilot\mcp-config.json
{
"mcpServers": {
"WebIQ-MCP": {
"url": "https://api.microsoft.ai/v3/mcp",
"type": "http",
"authtype": "api-key",
"headers": {
"x-apikey": "<your-api-key>"
}
}
}
}
웹 검색 MCP 도구
도구 이름:web
MCP 도구는 REST API와 동일한 매개 변수를 허용합니다. 전체 참조는 웹 검색 매개변수를 참조하세요.
비디오 검색 MCP 도구
도구 이름:videos
MCP 도구는 REST API와 동일한 매개 변수를 허용합니다. 전체 참조 정보는 비디오 검색 매개변수를 참조하세요.
MCP 도구 찾아보기
도구 이름:browse
MCP 도구는 REST API와 동일한 매개 변수를 허용합니다. 전체 참조는 매개변수 찾아보기를 참조하세요.
뉴스 검색 MCP 도구
도구 이름:news
MCP 도구는 REST API와 동일한 매개 변수를 허용합니다. 전체 참조 문서는 뉴스 검색 매개변수를 참조하세요.
이미지 검색 MCP 도구
도구 이름:images
MCP 도구는 REST API와 동일한 매개 변수를 허용합니다. 전체 참조 정보는 이미지 검색 매개 변수를 참조하세요.