MCP-сервер

Что такое MCP?

Model Context Protocol (MCP) — открытый протокол, через который ИИ-ассистенты подключаются к внешним сервисам. Подключив ассистента к MCP-серверу ALT Linux Space, вы можете попросить его, например:

• найти задачи по ключевым словам и кратко пересказать обсуждение;
• создать задачу или оставить комментарий;
• посмотреть изменения в запросе на слияние и написать к нему отзыв;
• прочитать файлы репозитория, не клонируя его;
• узнать, почему упала сборка в CI/CD.

Подключение

MCP-сервер доступен по адресу:

https://altlinux.space/mcp

Используется транспорт Streamable HTTP. Он поддерживается большинством современных клиентов: Claude Code, Cursor, VS Code и другими.

Доступ без токена

В этом режиме доступны только публичные данные: открытые репозитории, задачи и запросы на слияние. Действовать от вашего имени (создавать задачи, писать комментарии) ассистент не сможет.

Доступ с токеном

Чтобы ассистент работал от вашего имени и видел ваши приватные репозитории, создайте токен доступа:

1. Откройте Настройки → Приложения.
2. В разделе «Создать новый токен» укажите название, например mcp.
3. Выберите права. Давайте только то, что действительно нужно: например, read для repository и issue, если ассистент должен только читать код и задачи.
4. Нажмите «Создать токен» и скопируйте его. Повторно токен показан не будет.

Токен передаётся в заголовке Authorization в одном из двух форматов:

Authorization: Bearer <токен>
Authorization: token <токен>

Важно

С токеном ассистент может делать всё, что разрешено его правами: изменять репозитории, закрывать задачи, сливать запросы. Выдавайте минимально необходимые права и не публикуйте файлы конфигурации с токеном.

Настройка клиентов

Claude Code

claude mcp add --transport http altlinux-space https://altlinux.space/mcp \
  --header "Authorization: Bearer <токен>"

Без токена:

claude mcp add --transport http altlinux-space https://altlinux.space/mcp

VS Code

Создайте файл .vscode/mcp.json. VS Code запросит токен при первом подключении и сохранит его в защищённом хранилище:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "altlinux-space-token",
      "description": "Токен доступа ALT Linux Space",
      "password": true
    }
  ],
  "servers": {
    "altlinux-space": {
      "type": "http",
      "url": "https://altlinux.space/mcp",
      "headers": {
        "Authorization": "Bearer ${input:altlinux-space-token}"
      }
    }
  }
}

Cursor и другие клиенты

Большинство клиентов используют общий формат mcpServers (в Cursor это файл ~/.cursor/mcp.json):

{
  "mcpServers": {
    "altlinux-space": {
      "url": "https://altlinux.space/mcp",
      "headers": {
        "Authorization": "Bearer <токен>"
      }
    }
  }
}

Для доступа без токена уберите блок headers.

Доступные инструменты

Сервер работает на базе forgejo-mcp и предоставляет инструменты для работы с:

• репозиториями, ветками, коммитами и файлами;
• задачами, комментариями и учётом времени;
• запросами на слияние и отзывами;
• релизами, пакетами и вики;
• CI/CD (Forgejo Actions);
• организациями, пользователями и уведомлениями.

Полный список инструментов и их параметров есть в документации forgejo-mcp.