Подключите Clarid к AI-агенту
Через MCP агент читает документацию проекта, ищет по ней, наполняет её из кода и держит в соответствии с кодом — в Claude Code, Cursor, opencode и других инструментах.
Установка за минуту
- 1
Получите ключ в Clarid: Проект → Настройки → AI-агент (или «API-ключи»). Ключ показывается один раз — скопируйте
clarid_…. - 2
Добавьте сервер в
.mcp.jsonвашего агента. Устанавливать ничего не нужно —npxподнимет сервер сам. - 3
Перезапустите агента — инструменты Clarid появятся в списке доступных.
Claude Code / Cursor — .mcp.json
{
"mcpServers": {
"clarid": {
"command": "npx",
"args": ["-y", "clarid-mcp"],
"env": {
"CLARID_API_KEY": "clarid_ваш_ключ",
"CLARID_PROJECT_ID": "опционально-проект-по-умолчанию"
}
}
}
}Инструменты
Около 25 инструментов для чтения, наполнения из кода и поддержания документации. AI-работу выполняет ваш агент — сервер даёт доступ к документации и детерминированно её оценивает.
Чтение
get_project_brief— весь контекст проекта одним запросом — дерево, ключевые поля, статусыget_project_tree— структура компонентов проектаget_component— полное содержимое раздела со всеми полямиsearch— полнотекстовый поиск по документации (RU + EN)list_component_types— словарь типов компонентов и их полейget_references / get_dependencies— входящие и исходящие связи разделаget_broken_links— ссылки на несуществующие компоненты
Наполнение из кода — бесплатно
extract_digest_from_code— строит перечень фактов из кода любого стека — локально, без LLMcreate_components_batch— агент сам строит дерево документации из кодаevaluate_doc_quality— детерминированно проверяет покрытие и полноту → список того, что доработатьenrich_from_code— сопоставляет компонент с файлами кода
Поддержание соответствия коду
mark_components_seen— отметить разделы как затронутые текущим коммитомupdate_component— правка с code_ref → раздел переходит «в синхрон»get_history / get_diff— история и построчный дифф раздела
Правки
create_component— создать разделdelete_component— удалить разделmove_component— переместить или переименоватьfix_broken_link— починить ссылку на несуществующий компонент
Наполнить документацию из кода
Цикл build → evaluate → fix полностью бесплатен: AI-работу делает ваш агент своей моделью, Clarid хранит документацию и детерминированно проверяет её полноту.
- 1
extract_digest_from_code— агент извлекает перечень фактов прямо из репозитория — локально, без LLM - 2
create_components_batch— агент организует факты в дерево и заполняет поля из кода - 3
evaluate_doc_quality— Clarid проверяет покрытие и полноту → возвращает список, что доработать - 4
Повторяйте— агент устраняет замечания, пока список не опустеет
Лимиты по тарифам
API-ключи бесплатны. Действуют дневные лимиты вызовов; при превышении инструмент возвращает понятную ошибку (429) с временем сброса.
| Тариф | Чтений в день | Правок в день |
|---|---|---|
| Free | 500 | 50 |
| Pro | 5 000 | 500 |
| Team | 20 000 | 2 000 |
Подключите агента к проекту
Создайте проект, получите ключ clarid_… и добавьте сервер в .mcp.json.