Context7 MCP

upstash/context7· Проверено 12.11.2026· 64,7 тыс.на GitHub

Подтягивает в контекст агента свежую документацию и примеры кода нужной версии библиотеки. Агент меньше выдумывает несуществующие API и не пишет код под старые версии пакетов.

2 реализации:

Сервер на стороне Context7: ставить ничего не нужно, ключ передаётся в заголовке.

Как подключить

Что сделать до подключения

Authorization

бесплатный ключ в кабинете context7.com/dashboard; без ключа сервер работает с более низкими лимитами

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header 'Authorization: Bearer <ключ Context7>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
http_headers = { "Authorization" = "Bearer <ключ Context7>" }

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Context7>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Context7>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Context7>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Context7>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "context7": {
        "type": "remote",
        "url": "https://mcp.context7.com/mcp",
        "headers": {
          "Authorization": "Bearer <ключ Context7>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.context7.com/mcp
Request headers: Authorization: Bearer <ключ Context7>

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Context7>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

resolve-library-idнаходит ID библиотеки по названию

query-docsдостаёт документацию и примеры

query-codeищет по исходникам библиотеки

Пакет @upstash/context7-mcp запускается на вашем компьютере через npx и ходит в тот же API Context7.

Как подключить

Что сделать до подключения

Node.js 20.18.1 или новее

CONTEXT7_API_KEY

бесплатный ключ в кабинете context7.com/dashboard; вместо переменной можно передать флаг --api-key

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'CONTEXT7_API_KEY=<ключ Context7>' --transport stdio context7 \
  -- npx -y @upstash/context7-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.context7.env]
CONTEXT7_API_KEY = "<ключ Context7>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<ключ Context7>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<ключ Context7>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<ключ Context7>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<ключ Context7>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "context7": {
        "type": "local",
        "command": ["npx", "-y", "@upstash/context7-mcp"],
        "environment": {
          "CONTEXT7_API_KEY": "<ключ Context7>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<ключ Context7>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<ключ Context7>"
      }
    }
  }
}

Инструменты сервера

resolve-library-idнаходит ID библиотеки по названию

query-docsдостаёт документацию и примеры

query-codeищет по исходникам библиотеки

Что попросить агента

«Сделай прокси для Next.js: проверка JWT в куках и редирект неавторизованных на /login. use context7»Найдёт ID библиотеки через resolve-library-id, возьмёт актуальную документацию через query-docs и напишет код по ней

«Настрой Cloudflare Worker, чтобы он кешировал JSON-ответы API на пять минут. use context7»Через resolve-library-id и query-docs подтянет документацию Cloudflare Workers

«Сделай базовую авторизацию на Supabase. use library /supabase/supabase для API и документации»С готовым ID пропустит поиск библиотеки и сразу вызовет query-docs

«Как настроить прокси в Next.js 16? use context7»Запросит документацию нужной версии через query-docs

Для каких задач

Написать код под конкретную версию фреймворка, например Next.js 16

Проверить, есть ли метод в актуальном API библиотеки

Найти примеры настройки пакета на нужном языке программирования

Подключать документацию автоматически через правило в CLAUDE.md или Cursor Rules

Ограничения

Документацию в Context7 добавляют сообщество и авторы проектов; точность и безопасность каждой библиотеки сервис не гарантирует

API, парсер и краулер закрыты; локальный вариант тоже берёт документацию с серверов Context7

OAuth есть только у удалённого сервера по адресу /mcp/oauth; локальный работает с ключом

query-code в режиме research preview и появляется только с флагом --research-preview

Если не работает

Ошибка ERR_MODULE_NOT_FOUND при запуске

Запустите сервер через bunx или deno вместо npx.

На Windows запросы падают по таймауту

Укажите в command полный путь к node.exe, а в args путь к установленному пакету, или запускайте через cmd /c npx.

Ошибки лимита запросов

Получите ключ API в context7.com/dashboard и добавьте его в конфиг: у запросов с ключом лимиты выше.

Ответ 401 Unauthorized

Проверьте, что ключ начинается с ctx7sk и передан как Authorization: Bearer для HTTP или через --api-key для stdio.

Ответ 404 Not Found на библиотеку

Проверьте формат ID /owner/repo или /owner/repo/version и сначала найдите библиотеку через resolve-library-id.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Context7 MCP (удалённый)разработчик сервиса	Upstash	64,7 тыс.	HTTP	токен	3	12 ноября 2026
Context7 MCP (локальный)разработчик сервиса	Upstash	64,7 тыс.	локально	токен	3	12 ноября 2026

Частые вопросы

Нужен ли ключ API?

Сервер работает и без ключа, но ключ из context7.com/dashboard поднимает лимиты запросов и открывает приватные репозитории. Ключ бесплатный.

Как не писать каждый раз «use context7»?

Добавьте правило в CLAUDE.md или в Cursor Settings → Rules, например: «Always use Context7 when I need library/API documentation». Команда npx ctx7 setup ставит такое правило сама.

Как сразу указать нужную библиотеку?

Напишите в запросе её ID через слеш, например /supabase/supabase. Тогда сервер пропускает поиск библиотеки и сразу отдаёт документацию.

Куда делся инструмент get-library-docs?

Его переименовали в query-docs. Если в клиенте есть список разрешённых инструментов, замените старое имя.

Работает ли сервер из России?

Документация приходит с серверов Context7, поэтому нужен доступ к сервису из вашей сети; за прокси сервер берёт адрес из переменной HTTPS_PROXY.

Context7 MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы