copilot-studio-code

Локальный MCP-сервер, который предоставляет агенту Microsoft Copilot Studio инструменты в стиле Claude-Code для работы с вашей локальной файловой системой и оболочкой — чтение, редактирование, поиск и выполнение команд прямо из тестовой панели Copilot Studio. Поставляется с импортируемым решением Copilot Studio, чтобы вы могли запустить работающего агента за считанные минуты.

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

Режимы безопасности (выбираются при запуске)

Как выбирается режим (в порядке приоритета):

1. Переменная окружения SAFETY (strict / moderate / open)

2. Флаг CLI --safety <mode>

3. Интерактивный запрос при запуске (тайм-аут 10 с → moderate)

Все вызовы write_file, edit_file и run_shell записываются в <root>/.copilotstudio-mcp/audit.log.

Запуск

npm install
npm start

Сервер выводит что-то вроде:

copilot-studio-code MCP server
  workspace root : E:\Dev\projects\my-project
  safety mode    : moderate
  listening on   : http://localhost:8787/mcp
  health check   : http://localhost:8787/healthz

Переопределение рабочей области, в которой он работает:

$env:WORKSPACE_ROOT = "E:\Dev\some-other-project"; npm start

Подключение к Copilot Studio

Copilot Studio размещается в облаке, поэтому он не может получить доступ к localhost. Используйте Microsoft Dev Tunnels для публикации сервера через HTTPS.

1. Установите и войдите в dev tunnels

winget install Microsoft.devtunnel
devtunnel user login

2. Создайте постоянный туннель для порта 8787

devtunnel create copilotstudio-mcp --allow-anonymous
devtunnel port create copilotstudio-mcp -p 8787 --protocol http
devtunnel host copilotstudio-mcp

devtunnel host выводит публичный URL, например https://<id>-8787.usw2.devtunnels.ms. Оставьте его запущенным.

Уберите --allow-anonymous, и туннель потребует учетную запись MS на стороне Copilot Studio. Рекомендуется, как только вы настроите работу.

3. Подключите MCP-сервер к агенту Copilot Studio

Два способа: импорт готового решения (быстрее) или настройка агента вручную.

Путь А — Импорт готового решения

Папка solution/ содержит неуправляемое решение Copilot Studio, включающее предварительно настроенного агента (генеративная оркестрация включена, модерация контента низкая), пользовательский коннектор для MCP-сервера и тему WorkspaceMCP, которая предоставляет инструменты планировщику.

1. Откройте https://make.powerapps.com → ваша среда → Решения → Импорт решения.

2. Загрузите solution/CopilotStudioCode_1_0_0_0.zip. Примите настройки по умолчанию в мастере.

3. После импорта откройте пользовательский коннектор Workspace MCP → Изменить → на вкладке Общие замените хост-заполнитель YOUR-TUNNEL-ID-PORT.YOUR-REGION.devtunnels.ms на ваш реальный хост dev tunnel (например, abc123-8787.usw2.devtunnels.ms). Сохраните → Обновить коннектор.

4. Откройте импортированного агента и перейдите к шагу 4 (тестовая панель).

Решение не включает сам MCP-сервер — он запускается локально из этого репозитория. Коннектор просто указывает на него.

Путь Б — Настройка агента вручную

1. Откройте Copilot Studio → ваш агент → Инструменты → + Добавить инструмент → Протокол контекста модели (MCP).

2. URL сервера: https://<your-tunnel-id>-8787.usw2.devtunnels.ms/mcp

3. Аутентификация: Нет (для анонимного туннеля) или Microsoft Entra (для аутентифицированного).

4. Сохраните. Copilot Studio получит список инструментов из /mcp и покажет семь инструментов. Убедитесь, что каждый из них включен для агента.

5. Настройки → Генеративный ИИ → Оркестрация: Генеративная; модерация контента: Низкая. Без генеративной оркестрации планировщик не будет вызывать инструменты MCP.

4. Протестируйте его в тестовой панели

Откройте тестовую панель и попробуйте такие запросы:

• "List the files in the workspace root."

• "Read package.json and tell me what scripts are defined."

• "Add a new script called lint that runs tsc --noEmit."

• "Run git status and summarize the result."

Агент выбирает инструменты по имени на основе описаний в src/tools.ts — уточните эти описания, если агент выбирает не тот инструмент.

Структура проекта

src/                                  the MCP server (TypeScript)
  index.ts                            entry: safety prompt + boot
  server.ts                           express + Streamable HTTP MCP transport
  tools.ts                            the seven tool registrations
  safety.ts                           mode definitions
  paths.ts                            workspace-root path jail
  audit.ts                            JSONL audit log
solution/                             importable Copilot Studio solution
  CopilotStudioCode_1_0_0_0.zip       agent + connector + topics (unmanaged)