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


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

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

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

В примере разобрана работа с MCP-сервером через плагин Code Assistant, но вы можете [использовать](https://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://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://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 на панели слева нажмите на значок плагина <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><g fill="#000" clip-path="url(#svg-584tooq0__clip0_1068_334)"><path fill-rule="evenodd" d="M5.2 1A1.2 1.2 0 0 0 4 2.2v10.299a.5.5 0 0 0 .853.354L6.706 11H14.8A1.2 1.2 0 0 0 16 9.8V2.2A1.2 1.2 0 0 0 14.8 1H5.2Zm5.273 1.5L8 9.5h1.527L12 2.5h-1.527Z" clip-rule="evenodd"/><path d="M1.2 3H3v1H1.2a.2.2 0 0 0-.2.2v9.6c0 .11.09.2.2.2h11.6a.2.2 0 0 0 .2-.2V12h1v1.8a1.2 1.2 0 0 1-1.2 1.2H1.2A1.2 1.2 0 0 1 0 13.8V4.2A1.2 1.2 0 0 1 1.2 3Z"/></g><defs><clipPath id="svg-584tooq0__clip0_1068_334"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>.
1. На открывшейся панели выберите <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M7.199 2H8.8a.2.2 0 0 1 .2.2c0 1.808 1.958 2.939 3.524 2.034a.2.2 0 0 1 .271.073l.802 1.388a.2.2 0 0 1-.073.272c-1.566.904-1.566 3.164 0 4.069a.2.2 0 0 1 .073.271l-.802 1.388a.2.2 0 0 1-.271.073C10.958 10.863 9 11.993 9 13.8a.2.2 0 0 1-.199.2H7.2a.2.2 0 0 1-.2-.2c0-1.808-1.958-2.938-3.524-2.034a.2.2 0 0 1-.272-.073l-.8-1.388a.2.2 0 0 1 .072-.271c1.566-.905 1.566-3.165 0-4.07a.2.2 0 0 1-.073-.27l.801-1.389a.2.2 0 0 1 .272-.072C5.042 5.138 7 4.007 7 2.199c0-.11.089-.199.199-.199M5.5 2.2c0-.94.76-1.7 1.699-1.7H8.8c.94 0 1.7.76 1.7 1.7a.85.85 0 0 0 1.274.735 1.7 1.7 0 0 1 2.32.622l.802 1.388c.469.813.19 1.851-.622 2.32a.85.85 0 0 0 0 1.472 1.7 1.7 0 0 1 .622 2.32l-.802 1.388a1.7 1.7 0 0 1-2.32.622.85.85 0 0 0-1.274.735c0 .939-.76 1.7-1.699 1.7H7.2a1.7 1.7 0 0 1-1.699-1.7.85.85 0 0 0-1.274-.735 1.7 1.7 0 0 1-2.32-.622l-.802-1.388a1.7 1.7 0 0 1 .622-2.32.85.85 0 0 0 0-1.471 1.7 1.7 0 0 1-.622-2.32l.801-1.389a1.7 1.7 0 0 1 2.32-.622A.85.85 0 0 0 5.5 2.2m4 5.8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0M11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0" clip-rule="evenodd"/></svg> **Settings**.
1. Перейдите в раздел **Серверы MCP**.
1. Убедитесь, что сервер SourceCraft включен.

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

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

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

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

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

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

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

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

1. В VS Code на панели слева нажмите на значок плагина <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><g fill="#000" clip-path="url(#svg-avgfmkmg__clip0_1068_334)"><path fill-rule="evenodd" d="M5.2 1A1.2 1.2 0 0 0 4 2.2v10.299a.5.5 0 0 0 .853.354L6.706 11H14.8A1.2 1.2 0 0 0 16 9.8V2.2A1.2 1.2 0 0 0 14.8 1H5.2Zm5.273 1.5L8 9.5h1.527L12 2.5h-1.527Z" clip-rule="evenodd"/><path d="M1.2 3H3v1H1.2a.2.2 0 0 0-.2.2v9.6c0 .11.09.2.2.2h11.6a.2.2 0 0 0 .2-.2V12h1v1.8a1.2 1.2 0 0 1-1.2 1.2H1.2A1.2 1.2 0 0 1 0 13.8V4.2A1.2 1.2 0 0 1 1.2 3Z"/></g><defs><clipPath id="svg-avgfmkmg__clip0_1068_334"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></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://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](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/what-is-mcp.md)
* [Обзор MCP](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/overview.md)
* [MCP в плагине Code Assistant для VS Code](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/using-mcp-in-ca.md)
* [Транспорт MCP в плагине Code Assistant для VS Code](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/server-transports.md)
* [Отличия MCP и REST API](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/mcp-vs-api.md)
* [MCP-серверы SourceCraft и Yandex Cloud](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/mcp/recommended-mcp-servers.md)