Сервер MCP

Подключи репозитории SKILLOK к своему агенту — Claude, ChatGPT, Cursor, VS Code — по Model Context Protocol.

Обновлено Скопировать как Markdown
В этой статье

Что это#

MCP (Model Context Protocol) — открытый протокол, по которому агенты зовут инструменты сервисов. Сервер MCP SKILLOK делает твои репозитории контекстом агента, которым ты уже пользуешься: он читает файлы и задачи, ищет, ведёт задачи и предлагает правки — с теми же правами, что у тебя на сайте.

SKILLOK — не ещё один чат над моделью. Здесь живут знания и код, а модель — приходящий работник: подписку можно сменить, а контекст остаётся в репозиториях, в git, и открывается любым агентом.

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

  1. В агенте открой добавление коннектора (сервера MCP) и вставь адрес https://skillok.org/api/v1/mcp.
  2. Агент откроет страницу SKILLOK «Разрешить доступ». Отметь, можно ли агенту писать, и нажми «Разрешить».

Всё. Доступ появится в Настройки → Токены доступа с именем агента — там же его можно отозвать. Через 90 дней агент попросит разрешение снова.

Если агент не умеет входить сам#

Создай токен в Настройки → Токены доступа (только читать — право «чтение»; задачи и правки — ещё «запись») и укажи его заголовком:

{
  "mcpServers": {
    "skillok": {
      "type": "http",
      "url": "https://skillok.org/api/v1/mcp",
      "headers": { "Authorization": "Bearer sk_…" }
    }
  }
}

Где лежит контекст проекта#

Контекст живёт в репозиториях — файлами, в git:

Что Где Кто видит
Правила для агента файл AGENTS.md в корне репозитория все агенты: Codex, Cursor, Copilot, Claude Code (импортом @AGENTS.md) и SKILLOK
Память проекта: решения, заметки, итоги репозиторий контекста — обычный репозиторий, связанный с основным агент читает его вместе с основным и пишет туда заметки
Что агенту можно Настройки репозитория → ИИ → Агенты владелец репозитория

Репозиторий контекста связывают в настройках основного репозитория. Один контекст может обслуживать несколько репозиториев — например, фронт, бэк и документацию проекта. Агент пишет заметки в контекст сразу, а в основной репозиторий — только запросом на слияние.

AGENTS.md держи коротким: правила, договорённости, как собрать и проверить. Справку и историю решений — в репозиторий контекста: длинные правила агенту мешают и стоят денег на каждом запросе.

Что агенту можно#

Владелец выбирает уровень в Настройки репозитория → ИИ → Агенты:

Уровень Что можно
Только читать файлы, задачи, поиск
Читать и вести задачи ещё заводить задачи, отвечать, менять и закрывать их, метки
Всё ещё правки запросом на слияние и заметки в репозиторий контекста

Уровень только сужает: писать агент может, только если писать можешь ты, и только если токен выдан с записью. Сливать запросы и удалять агент не умеет — это решает человек.

Инструменты#

Инструмент Что делает
get_project_context правила AGENTS.md, что агенту можно, репозиторий контекста и его файлы — с него стоит начинать
list_repositories твои репозитории и репозитории организаций, где включён ИИ
list_files, read_file, search файлы, текст с номерами строк, поиск
list_issues, read_issue задачи и запросы на слияние
create_issue, comment, update_issue завести, ответить, изменить или закрыть, метки
propose_change ветка llm/… и запрос на слияние
save_note заметка в репозиторий контекста

Тот же контекст сервер отдаёт ресурсом skillok://владелец/имя/context — для агентов, которые умеют прикреплять ресурсы.

Как сэкономить#

  • Подключай SKILLOK к своему агенту: запросы идут по твоей подписке, а не по ключу SKILLOK.
  • Держи AGENTS.md коротким, а память — в репозитории контекста: агент читает её по кусочкам, когда нужно.
  • Одинаковое начало запроса (правила, инструменты) провайдеры кэшируют и берут за него от половины до десятой доли цены.

Версии протокола#

2025-11-25, 2025-06-18 и 2025-03-26, без сессий: каждый запрос — отдельное сообщение JSON-RPC. Вход — OAuth 2.1 с PKCE (регистрация клиента или документ клиента по адресу) или токен в заголовке.

Было полезно?