Обучающие материалы¶

На этой странице содержатся учебники по взаимодействию с Koda CLI.

Настройка сервера протокола контекста модели (MCP)¶

Предостережение

Прежде чем использовать сторонний сервер MCP, убедитесь, что вы доверяете его источнику и понимаете инструменты, которые он предоставляет. Вы используете сторонние серверы на свой страх и риск.

Этот учебник демонстрирует, как настроить сервер MCP, используя в качестве примера сервер GitHub MCP. Сервер GitHub MCP предоставляет инструменты для взаимодействия с репозиториями GitHub, такие как создание задач и комментирование запросов на слияние.

Предварительные условия¶

Прежде чем начать, убедитесь, что у вас установлено и настроено следующее:

Docker: Установите и запустите Docker.
Персональный токен доступа GitHub (PAT): Создайте новый классический или гранулированный PAT с необходимыми областями действия.

Руководство¶

Настройка сервера MCP в файле `settings.json`¶

В корневом каталоге вашего проекта создайте или откройте файл .kodacli/settings.json. Внутри файла добавьте блок конфигурации mcpServers, который предоставляет инструкции о том, как запустить сервер GitHub MCP.

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

Установите ваш токен GitHub¶

Предостережение

Использование персонального токена доступа с широкой областью действия, который имеет доступ к личным и частным репозиториям, может привести к утечке информации из частного репозитория в публичный. Мы рекомендуем использовать гранулированный токен доступа, который не предоставляет общий доступ как к публичным, так и к частным репозиториям.

Используйте переменную окружения для хранения вашего GitHub PAT:

GITHUB_PERSONAL_ACCESS_TOKEN="pat_YourActualGitHubTokenHere"

Koda CLI использует это значение в конфигурации mcpServers, которую вы определили в файле settings.json.

Запустите Koda CLI и проверьте соединение¶

Когда вы запускаете Koda CLI, он автоматически считывает вашу конфигурацию и запускает сервер GitHub MCP в фоновом режиме. Затем вы можете использовать подсказки на естественном языке, чтобы попросить Koda CLI выполнить действия GitHub. Например:

"получить все открытые задачи, назначенные мне в репозитории 'foo/bar', и расставить приоритеты"