---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - https://vibe.sourcecraft.dev/portal/docs/en/sourcecraft/operations/work-with-mcp.md
  - https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/work-with-mcp.md
  - href: https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/work-with-mcp.md
    type: text/markdown
    title: Markdown version
  - href: https://vibe.sourcecraft.dev/portal/docs/ru/llms.txt
    rel: describedby
title: Работа с MCP-сервером SourceCraft
description: Как работать с ресурсами SourceCraft через MCP-сервер с помощью AI-агента.
---
> **Documentation Index:** Fetch the complete configuration index at https://vibe.sourcecraft.dev/portal/docs/ru/llms.txt


<!-- source: ru/_includes/code-assistant/work-with-mcp.md -->
# Работа с MCP-сервером SourceCraft

С помощью [SourceCraft MCP](https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/recommended-mcp-servers.md) AI-агенты могут работать с сущностями SourceCraft. Например, искать и выполнять [задачи](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#issues), создавать [предложения изменений](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#pr) и управлять другими ресурсами платформы.

В этой инструкции с помощью Code Assistant и SourceCraft MCP мы найдем задачу в репозитории, внесем все необходимые изменения, отправим их в репозиторий и закроем задачу.

В примере разобрана работа с MCP-сервером через плагин Code Assistant, но вы можете [использовать](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/connect-to-mcp.md#universal-installation) любого другого агента, поддерживающего работу с MCP.

<!-- source: ru/_includes/code-assistant/recommended-mcp-servers.md -->
{% note info %}

Список MCP-серверов Yandex Cloud и SourceCraft, а также рекомендуемые MCP-серверы можно посмотреть в разделе [MCP-серверы SourceCraft и Yandex Cloud](https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/recommended-mcp-servers.md).

{% endnote %}
<!-- endsource: ru/_includes/code-assistant/recommended-mcp-servers.md -->

## Подготовьте окружение {#prepare}

Для выполнения предложенного сценария понадобятся следующие инструменты:

* [Visual Studio Code](https://code.visualstudio.com/download).
* [Плагин Code Assistant для Visual Studio Code](https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/index.md)
* [Git](https://git-scm.com/downloads)
* [Python](https://www.python.org/downloads/)

## Проверьте подключение MCP {#check-mcp}

Если репозиторий размещен в SourceCraft, плагин Code Assistant автоматически подключает SourceCraft MCP. PAT не требуется.

1. В VS Code на панели слева нажмите на значок плагина ![image](../../_assets/code-assistant/vsc-icon-small.svg).
1. На открывшейся панели выберите ![image](../../_assets/console-icons/gear.svg) **Settings**.
1. Перейдите в раздел **Серверы MCP**.
1. Убедитесь, что сервер SourceCraft включен.

## Подготовьте репозиторий {#create-repo}

1. [Создайте пустой репозиторий](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/repo-create.md#create-empty), например `mcp-test`.
1. [Добавьте](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/add-file-repo.md) в созданный репозиторий файл `hello.py` со следующим содержимым:

   ```python
   print("Hello, World")
   ```

1. [Создайте](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/issue-create.md) задачу «Добавить русификацию» со следующим описанием:

   ```text
   В файл hello.py добавить альтернативный вариант на русском языке. Нужный язык должен выбирать пользователь при запуске.
   ```

## Отправьте запросы в чат {#send-requests}

Для примера использовался публичный репозиторий `mcp-test` в [организации](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#org) `orgname`. Используйте свои названия для запросов к Code Assistant.

Результаты выполнения запросов могут отличаться в зависимости от модели и выбранного режима поведения.

1. В VS Code на панели слева нажмите на значок плагина ![image](../../_assets/code-assistant/vsc-icon-small.svg).

1. В открывшемся чате попросите Code Assistant вывести список задач:

   ```text
   Покажи список issues в репозитории mcp-test в организации orgname.
   ```

   Ассистент воспользуется инструментом `ListRepositoryIssues` для вывода списка задач. В зависимости от ваших настроек плагина может потребоваться одобрить выполнение запроса.

1. С помощью Code Assistant клонируйте репозиторий:

   ```text
   Теперь клонируй репозиторий.
   ```

   Ассистент получит ссылку для клонирования с помощью инструмента `GetRepository`, а затем воспользуется командой `git clone`.

1. Попросите Code Assistant выполнить задачу в новой ветке репозитория:

   ```text
   Создай новую ветку в репозитории и выполни в ней упомянутую задачу по добавлению русификации.
   ```

   Ассистент отредактирует файл `hello.py` и добавит коммит с изменениями с помощью `git`.

1. Если на предыдущем шаге Code Assistant не протестировал отредактированный код, попросите его об этом:

   ```text
   Протестируй код.
   ```

   Ассистент выполнит тест обновленного кода и выведет результаты тестирования.

1. Создайте с помощью ассистента новое предложение изменений в репозитории:

   ```text
   Создай из ветки новое предложение изменений в репозитории и привяжи его к упомянутому ранее issue.
   ```

   Ассистент получит информацию о задаче в репозитории с помощью инструментов `GetRepository` и `GetIssue`, через `git` отправит изменения в удаленный репозиторий, создаст предложение изменений с помощью `CreatePullRequest` и привяжет к нему исходную задачу через `AddLinkedPRs`.

1. В [интерфейсе SourceCraft](https://sourcecraft.dev) найдите созданное предложение изменений, проверьте его и [выполните слияние](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/pr-work.md#merge) с основной веткой.

1. Попросите Code Assistant написать комментарий и закрыть задачу:

   ```text
   В упомянутом issue оставь комментарий, что задача выполнена, а затем закрой его.
   ```

   Ассистент откроет задачу с помощью инструмента `GetIssue`, а затем внесет в нее изменения инструментами `CreateIssueComment` и `UpdateIssue`.

   Чтобы проверить работу Code Assistant, откройте репозиторий в браузере и убедитесь, что изменения внесены и задача закрыта.

{% note tip %}

В примере описаны пошаговые команды для Code Assistant при работе с MCP SourceCraft для более гранулярного контроля над действиями агента.

Вы можете описать все действия, которые должен совершить Code Assistant, в одной общей команде и корректировать ассистента по ходу выполнения.

{% endnote %}
<!-- endsource: ru/_includes/code-assistant/work-with-mcp.md -->

#### Полезные ссылки {#see-also}

* [MCP-серверы SourceCraft и Yandex Cloud](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/connect-to-mcp.md)
* [Обзор MCP](https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/overview.md)