Ref MCP

MCP-сервер Ref: поиск по документации API и библиотек, который отдает агенту только нужные куски страниц

MCP-серверСредний риск

ref-tools/ref-tools-mcp

Установка

"Ref": {
  "type": "http",
  "url": "https://api.ref.tools/mcp?apiKey=YOUR_API_KEY"
}

Рекомендуемый удаленный вариант, фрагмент для секции mcpServers.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Ref дает агенту два инструмента: поиск по технической документации и чтение страницы по адресу с конвертацией в Markdown. Искать можно по публичной документации в сети и на GitHub, а также по приватным источникам вроде репозиториев и PDF. Сервер помнит историю поиска в сессии: не возвращает уже показанные результаты и при чтении большой страницы оставляет только самые подходящие фрагменты. Это экономит контекст по сравнению с обычным fetch. Для клиентов OpenAI инструменты доступны под именами search и fetch.

Для кого. Для разработчиков, чьи агенты часто обращаются к документации сторонних API и библиотек и тратят на это много токенов.

Подходит, если

  • Агент ошибается в API библиотеки, которую знает по устаревшим данным
  • Обычный fetch документации забивает контекст
  • Нужно искать по приватной документации команды

Не подходит, если

  • Нет возможности зарегистрироваться и получить ключ Ref
  • Документация уже лежит в репозитории и доступна агенту как файлы

Пример запроса к агенту

Найди в документации Figma API эндпоинт для добавления комментария и покажи параметры

Ограничения

Нужна регистрация на ref.tools и ключ API, условия тарифов описаны на сайте. Этот репозиторий содержит устаревший stdio-сервер, авторы рекомендуют удаленный HTTP. Запросы уходят во внешний сервис, доступность из России без VPN не проверена.

Как отключить. Удалите блок Ref из конфигурации MCP клиента.

MCP

Транспорт
http, stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
REF_API_KEY
обязательная, секрет
Ключ API Ref для stdio-сервера

Проверка безопасности

  • Отправляет поисковые запросы во внешний сервис
  • Может индексировать приватные репозитории и PDF

Коротко о README

README объясняет, как агент ищет и читает документацию через Ref, на примерах цепочек вызовов. Описаны два механизма экономии контекста и почему лишние токены вредят качеству и стоимости. Приведены конфигурации для HTTP и stdio, описаны инструменты и совместимость с deep research OpenAI. Лицензия MIT.

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

Какой вариант подключения выбрать?

Удаленный HTTP: авторы называют его рекомендуемым, а stdio-сервер из этого репозитория устаревшим.

Чем Ref отличается от обычного чтения страниц?

При чтении он оставляет около 5 тысяч токенов самых релевантных разделов с учетом прошлых поисков, а не всю страницу.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.
Выбор редакции

Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом

MCP-серверСредний риск62 тыс.