Kagi API가 지원하는 MCP 서버입니다. MCP 호환 클라이언트에 검색 및 추출 도구를 제공합니다.

도구

• kagi_search_fetch - 웹, 뉴스, 동영상, 팟캐스트, 이미지 검색, 선택 가능한 페이지 추출, 필터, Kagi 렌즈 포함.
• kagi_extract - 마크다운으로 페이지의 전체 내용을 가져오기.

참고: 이전의 kagi_fastgpt와 kagi_summarizer 도구들은 제거되었습니다. 두 도구는 향후 버전에서 다시 돌아올 예정입니다.

호스팅 서버

저희는 **https://mcp.kagi.com/mcp**에 호스팅된 MCP 서버를 운영하며, 설치 필요 없습니다. HTTP가 지원되는 MCP 클라이언트를 그 서버에 연결하고 Kagi API 키로 인증하세요.

OAuth2는 아직 지원되지 않아요(로드맵에 포함되어 있어요). 그래서 일단 대시보드에서 API 키를 가져와서 Bearer HTTP 인증을 통해 전달하세요.

클로드 코드 예시:

직접 실행하고 싶으신가요? 로컬 uvx 설치에 대한 클라이언트 설정이나 자체 인프라에서 HTTP 서버를 호스팅하는 셀프 호스팅을 참고하세요.

요구 사항

• KAGI_API_KEY에 있는 Kagi API 키.
• uv는 권장 uvx 설치 경로입니다.

설치 uv:

윈도우:

클라이언트 설정

코덱스 CLI

코덱스는 MCP 구성을 ~/.codex/config.toml에 기록합니다.

클로드 데스크탑

먼저 UV를 설치하세요.

Kagi MCP Server

An MCP server backed by the Kagi API. It exposes search and extraction tools to MCP-compatible clients.

Tools

• kagi_search_fetch - web, news, videos, podcasts, and image search with optional page extracts, filters, and Kagi lenses.
• kagi_extract - fetch a page’s full content as markdown.

Note: The previous kagi_fastgpt and kagi_summarizer tools have been removed. Both are planned to return in a future release.

Hosted Server

We run a hosted MCP server at https://mcp.kagi.com/mcp — no install required. Point any HTTP-capable MCP client at it and authenticate with your Kagi API key.

OAuth2 isn’t supported yet (it’s on our roadmap), so for now grab your API key from the dashboard and pass it via Bearer HTTP authentication.

Example with Claude Code:

claude mcp add kagi https://mcp.kagi.com/mcp --transport http --header "Authorization: Bearer $(read -sp 'API key: ' k; echo $k)" --scope user

Prefer to run it yourself? See Client Setup for the local uvx install, or Self-Hosting to host the HTTP server on your own infrastructure.

Requirements

• A Kagi API key in KAGI_API_KEY.
• uv for the recommended uvx install path.

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Client Setup

Codex CLI

codex mcp add kagi --env KAGI_API_KEY= -- uvx kagimcp

Codex writes MCP configuration to ~/.codex/config.toml.

Claude Desktop

Install uv first.

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then in your Claude Desktop config (found through Settings -> Developer -> Edit Config):

{
  "mcpServers": {
    "kagi": {
      "command": "uvx",
      "args": ["kagimcp"],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code

claude mcp add kagi -e KAGI_API_KEY="YOUR_API_KEY_HERE" -- uvx kagimcp

Smithery

npx -y @smithery/cli install kagimcp --client claude

Kiro

Add to your Kiro MCP config file (~/.kiro/settings/mcp.json for global, or .kiro/settings/mcp.json for project-scoped) using the same mcpServers JSON as Claude Desktop. See the Kiro MCP documentation for more details.

OpenCode

Edit the OpenCode configuration file in ~/.config/opencode/opencode.json and add the following:

{
  "mcp": {
    "kagi": {
      "type": "local",
      "command": ["uvx", "kagimcp"],
      "enabled": true,
      "environment": {
        "KAGI_API_KEY": ""
      }
    }
  }
}