# Сервер MCP

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

## Что это

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

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

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

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

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

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

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

```json
{
  "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 (регистрация клиента или документ клиента по адресу) или
токен в заголовке.

---

https://skillok.org/docs/ru/account/mcp