4.7 KiB
| title | description | lang |
|---|---|---|
| MCP интеграция – Документация Agent Teams | Как использовать MCP в Agent Teams для board operations, координации teammates и внешних tool servers. | ru-RU |
MCP интеграция
Agent Teams использует MCP двумя практическими способами:
| Слой | Что делает | Кто использует |
|---|---|---|
| Board MCP tools | Создают, стартуют, комментируют, завершают и читают tasks | Agents и leads |
| External MCP servers | Добавляют инструменты вроде browser, design, docs или company systems | Users и настроенные runtimes |
Держите эти слои отдельно. Board MCP нужен для координации внутри Agent Teams. External MCP servers - это дополнительные инструменты для runtimes.
Board MCP workflow
Agents должны использовать board MCP tools, когда работа относится к task:
- Прочитать свежий task context.
- Стартовать task только когда реально начинают работу.
- Добавлять task comments для blockers, plan и final results.
- Завершать task после result comment.
- Отправлять короткое сообщение, если lead или teammate должен увидеть результат.
Пример flow:
task_get -> task_start -> edit/test -> task_add_comment -> task_complete -> message_send
Direct message подходит для координации. Task comment подходит для durable task history.
::: tip Если заметка влияет на review, verification, changed scope или blocker, пишите её в task. :::
External MCP servers
Используйте external MCP servers, когда teammate нужен устойчивый tool connection, а не один prompt с pasted context.
Хорошие случаи:
- browser или website testing tools
- design или product data tools
- internal docs и search systems
- issue tracker или support systems
- database inspection tools с read-only credentials
Плохие случаи:
- secrets, вставленные в prompts
- one-off files, которые проще attached напрямую
- tools, которые меняют production systems без review
- широкий local filesystem access, когда достаточно project scope
Scopes
Agent Teams распознаёт shared и project-oriented MCP scopes.
| Scope | Когда использовать |
|---|---|
| User или Global | Один server нужен в разных projects |
| Project или Local | Server относится к одному repository, workspace или team context |
Выбирайте самый узкий scope, который всё ещё удобен. Project-scoped servers легче проверять на review, потому что tool привязан к изменяемому project.
Setup checklist
Перед task, который зависит от MCP server:
- Установите или настройте server.
- Проверьте, что он виден в installed MCP list.
- Запустите diagnostics, если app их предлагает.
- Начните с low-risk read-only task.
- Укажите ожидаемый MCP tool use в task description или team brief.
Если diagnostics падают, сначала чините setup. Лучший prompt не исправит missing command, неправильный config path или rejected credentials.
Task example
Audit the docs home page with the browser MCP. Check desktop and mobile widths, capture any layout issue as a task comment, and only edit landing/product-docs files. Run `pnpm --dir landing docs:build` before completion.
Такой task работает, потому что называет tool, surface, write boundary и verification step.
Safety rules
- Не выдавайте каждому teammate все MCP servers по умолчанию.
- Не добавляйте write-capable tools в broad teams без review.
- Для inspection tasks предпочитайте read-only credentials.
- Production-impacting tool use фиксируйте через explicit task comments и review.
- MCP diagnostic failures считайте setup failures, а не agent failures.