Jina AI MCP Server

Что умеет сервер

Сервер работает на API Jina: Reader, поиске, эмбеддингах и реранкере. Он отдаёт двенадцать инструментов. Читают: read_url возвращает страницу или PDF в Markdown, capture_screenshot_url делает снимок страницы, guess_datetime_url оценивает дату публикации или обновления с уровнем уверенности. Ищут: search_web, search_arxiv, search_ssrn (научные работы), search_images и search_jina_blog. Обрабатывают тексты: sort_by_relevance ранжирует документы по запросу, deduplicate_strings оставляет самые разнообразные строки, extract_pdf достаёт из PDF рисунки, таблицы и формулы. Служебный primer выдаёт локализованный и привязанный ко времени контекст.

У read_url есть параметр question: страница режется на фрагменты, лучшие по смыслу возвращаются вместо всего текста, что сильно сокращает ответ. Параметр ocr распознаёт сканы и PDF без текстового слоя, по одной странице за вызов. В query и url можно передать массив до пяти элементов.

Когда использовать

Подходит для исследований, где нужно и искать, и читать: найти статьи на arXiv или SSRN, прочитать их, отранжировать найденное и отсеять дубли. README советует после search_web, search_arxiv и search_ssrn всегда вызывать read_url по найденным адресам, потому что поиск возвращает только заголовки, адреса и фрагменты.

Чтобы не тратить контекст на описания двенадцати инструментов, лишние отключают фильтрами в адресе: include_tags, exclude_tags, include_tools, exclude_tools.

Ограничения и безопасность

Без ключа работают primer, guess_datetime_url, search_jina_blog, а read_url и capture_screenshot_url доступны с ограничением частоты; остальным нужен ключ Jina. Некоторые клиенты не подставляют переменные окружения, и тогда ключ приходится вписывать в настройку напрямую.

README честно перечисляет сбои чтения с question: вопросы о положении в документе (например, «последняя версия» в начале журнала изменений) могут вернуть не то, таблицы и блоки кода перед ранжированием удаляются, а встроенный код может потерять части. Не запускайте команду, скопированную из фрагмента, не сверив её с источником. Страница с требованием входа может вернуться как её текст с формой входа. Клиенты вроде Claude Code, Claude Desktop и Cursor ограничивают ответ инструмента 25 тысячами токенов, поэтому сервер обрезает вывод read_url и помечает это в тексте.

Claude Code

claude mcp add -s user --transport http jina https://mcp.jina.ai/v1 \
  --header "Authorization: Bearer ${JINA_API_KEY}"

Клиенты с поддержкой удалённых MCP-серверов

Заголовок Authorization необязателен. Некоторые клиенты не подставляют переменные окружения, тогда замените ${JINA_API_KEY} на настоящий ключ вида jina_xxx:

{
  "mcpServers": {
    "jina-mcp-server": {
      "url": "https://mcp.jina.ai/v1",
      "headers": {
        "Authorization": "Bearer ${JINA_API_KEY}" // optional
      }
    }
  }
}

Клиенты без поддержки удалённых серверов

Нужен локальный прокси mcp-remote:

{
  "mcpServers": {
    "jina-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.jina.ai/v1",
        "--header",
        "Authorization: Bearer ${JINA_API_KEY}"
      ]
    }
  }
}

OpenAI Codex

В файл ~/.codex/config.toml:

[mcp_servers.jina-mcp-server]
command = "npx"
args = [
    "-y",
    "mcp-remote",
    "https://mcp.jina.ai/v1",
    "--header",
    "Authorization: Bearer ${JINA_API_KEY}"]

Фильтрация инструментов

Только поиск и чтение:

{
  "mcpServers": {
    "jina-mcp-server": {
      "url": "https://mcp.jina.ai/v1?include_tags=search,read",
      "headers": {
        "Authorization": "Bearer ${JINA_API_KEY}"
      }
    }
  }
}

Лимит ответа read_url в токенах задаёт параметр max_tokens, например https://mcp.jina.ai/v1?max_tokens=50000; значение 0 отключает усечение.