# hosted-mcp-tools

Субагент hosted-mcp-tools помогает собрать агента Microsoft Foundry, который вызывает инструменты удалённого MCP-сервера, на C# или Python.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 521 у репозитория
- Автор: moonbox3
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/agents/tools/hosted-mcp-tools.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/hosted-mcp-tools

## Что делает

Сценарий такой: инструменты живут на удалённом MCP-сервере, а вызовы делает сам сервис Foundry. Свою инфраструктуру под сервер держать не нужно. В разборе два пути — C# и Python.

В C# агент создаётся через `AIProjectClient` и `CreateAgentVersionAsync`, а инструмент описывается `MCPToolDefinition`: метка сервера, его адрес и список `AllowedTools` с разрешёнными именами. В Python короче — `FoundryChatClient` и `get_mcp_tool`. Агент хранится на стороне сервиса, поэтому сессию можно тянуть через несколько запросов и потом удалить её через `DeleteAgentAsync`.

Из окружения нужны `AZURE_FOUNDRY_PROJECT_ENDPOINT` и `AZURE_FOUNDRY_PROJECT_MODEL_ID`; без первого C#-пример падает с `InvalidOperationException` ещё до создания агента. Подтверждение вызовов задаётся в `RequireApproval` значениями `never` или `always`. Для `DefaultAzureCredential` в документации отдельное предупреждение: в продакшене берут конкретную учётную запись вроде `ManagedIdentityCredential`, иначе будут задержки и перебор источников учётных данных.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/hosted-mcp-tools.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/hosted-mcp-tools.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/hosted-mcp-tools.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/agents/tools/hosted-mcp-tools.md

## Когда брать
- подключить удалённый MCP-сервер к агенту Foundry без своего хостинга
- ограничить набор доступных инструментов списком `AllowedTools`
- настроить подтверждение вызова инструментов через `RequireApproval`
- сохранить состояние диалога между несколькими запросами
- удалить агента после прогона примера

## Примеры запросов агенту
- Собери на C# агента Foundry с hosted MCP-сервером `https://learn.microsoft.com/api/mcp` и инструментом `microsoft_docs_search`.
- Перепиши тот же пример на Python через `FoundryChatClient` и `get_mcp_tool`, подтверждение вызовов не нужно.
- Добавь в пример удаление агента через `DeleteAgentAsync` после запуска.

## Похожие
- [microsoft-agent-framework-dotnet](https://affpapa.org/nevibecode/agents/microsoft-agent-framework-dotnet.md) — субагент · 256 установок
- [azure-ai-projects-py](https://affpapa.org/nevibecode/skills/azure-ai-projects-py.md) — скилл · 3 установки
- [microsoft-foundry](https://affpapa.org/nevibecode/skills/microsoft-foundry.md) — скилл · 5 установок
- [azure-queue-storage](https://affpapa.org/nevibecode/skills/azure-queue-storage.md) — скилл · 181 установка
- [foundry-hosted-agent-copilotkit](https://affpapa.org/nevibecode/skills/foundry-hosted-agent-copilotkit.md) — скилл · 29 установок
- [entra-app](https://affpapa.org/nevibecode/commands/entra-app.md) — команда · ★ 41441 у репозитория

Из того же набора: [managedcode/dotnet-skills](https://affpapa.org/nevibecode/by/managedcode/dotnet-skills.md) — 38 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
