Ref MCP
MCP-сервер Ref: поиск по документации API и библиотек, который отдает агенту только нужные куски страниц
Установка
"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, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом