Подключение агента программирования

Pommy — это MCP-сервер. Агент, с которым вы уже пишете код, — Claude Code, Codex, Cursor, VS Code или любой клиент с поддержкой streamable HTTP и OAuth — может к нему подключиться и дальше читать и менять вашу настройку Pommy за вас: проверить, чего не хватает проекту, получить код установки виджета и вставить его в сайт, над которым уже работает, добавить документ в базу знаний, переписать инструкции ассистента.

Настраивается это на странице Coding Agents в левом меню. Это страница для разработчиков, и больше ничто в Pommy от неё не зависит: если вы никогда не открываете терминал, смело пропускайте весь раздел.

Что может агент#

Подключение предоставляет фиксированный набор инструментов. Ничего вне этого списка вызвать нельзя, что бы агент ни просил. Инструменты с пометкой да меняют вашу настройку; они доступны, только если вы разрешили вносить изменения, а без этого разрешения агент их даже не видит.

Инструментов для чего-то другого нет: нельзя удалить проект, изменить оплату, управлять командой или опубликовать сценарий. Читать разговор можно, потому что исправление неверного ответа начинается с его прочтения; писать в разговор от вашего имени — нельзя.

Подключение#

1. Откройте Coding Agents и выберите своего агента

   Вкладки вверху карточки Connect — Claude Code, Codex, Cursor, VS Code, Other — показывают точную команду или файл для каждого клиента. Копируйте со страницы: адрес уже подставлен.

2. Выполните команду или сохраните файл

   Claude Code и Codex принимают однострочную команду в терминале. Cursor и VS Code читают небольшой JSON-файл — на странице указано, какой именно и где он лежит.

3. Войдите

   Агент открывает браузер, и вы входите в Pommy под своей учётной записью. В Claude Code вход начинается с команды /mcp; в Codex — с codex mcp login pommy; Cursor и VS Code открывают браузер сами.

4. Выберите, к каким проектам у агента будет доступ

   В браузере откроется экран согласия Pommy. Выберите проекты, подтвердите — и агент подключён.

claude mcp add --transport http pommy https://api.pommy.ai/mcp

codex mcp add pommy --url https://api.pommy.ai/mcp

{
  "mcpServers": {
    "pommy": {
      "url": "https://api.pommy.ai/mcp"
    }
  }
}

{
  "servers": {
    "pommy": {
      "type": "http",
      "url": "https://api.pommy.ai/mcp"
    }
  }
}

Подойдёт и любой другой клиент: укажите ему тот же адрес, https://api.pommy.ai/mcp. Это эндпоинт streamable HTTP за OAuth, и всё остальное — какой сервер авторизации использовать, какие разрешения существуют — клиент узнаёт сам.

Экран согласия#

Именно на шаге в браузере выдаётся разрешение, поэтому экран спрашивает сразу о двух вещах: что этому приложению будет разрешено делать и где.

• Какое приложение запрашивает доступ — имя, под которым оно зарегистрировано, показано вверху. Приложение, которое Pommy не распознаёт, до этого экрана не доходит.
• Что ему будет разрешено — по строке на каждое запрошенное разрешение: чтение ваших проектов, внесение в них изменений, сведения о том, кто вы. Внимательно прочитайте строку об изменениях — именно она важна.
• Какие проекты — все доступные вам проекты, сгруппированные по организациям. Если проектов больше шести, появляется поле поиска. Подтвердить, не отметив ни одного, нельзя.

Отметка проекта ничего не выдаёт — она сужает то, к чему может прикасаться агент. Вы не раздаёте доступ, а выбираете, какую часть своего собственного доступа одолжить.

Этот экран появляется при каждом подключении, даже если вы уже подключали этот клиент, — так задумано, ведь список проектов вы можете захотеть изменить. Прошлый выбор уже отмечен, так что повторная авторизация без изменений — это один клик.

Разрешения и безопасность#

• Агент действует от вашего имени. Подключение несёт ваши собственные права и ничего сверх них — поэтому оно никогда не получит доступ шире вашего. Если вы не можете редактировать ассистента в панели, агент тоже не сможет.
• Только выбранные вами проекты. Агенту доступно пересечение вашего текущего доступа и проектов с экрана согласия — оба условия, а не одно из них.
• Доступ перепроверяется при каждом вызове, а не запоминается со дня одобрения. Потеряли доступ к проекту — ушли из команды, сменилась роль — и агент теряет его в тот же момент, отзывать ничего не нужно.
• Изменения идут тем же путём, что и в панели. Всё, что пишет агент, проходит через те же процедуры, что и панель управления: та же проверка входных данных, те же проверки прав, та же квота, тот же журнал аудита. Документ, добавленный из терминала, ничем не отличается от добавленного вручную — в том числе в журнале аудита.
• Ничего общеплатформенного не открыто. Список инструментов отобран вручную, и в нём нет ни одного инструмента, которому нужны права администратора платформы, — даже для аккаунта, у которого они есть.
• Подключение ваше, а не всей команды. Подключение вашего агента не подключает чужих, а отзыв вашего не затрагивает их.

Просмотр и отзыв подключений#

Карточка Connected справа на странице Coding Agents показывает всех агентов, которых вы авторизовали: имя, под которым зарегистрирован клиент, к скольким проектам у него есть доступ и дату выдачи разрешения.

Revoke просит подтверждения, после чего у агента нет доступа ни к одному проекту. Его токен может ещё какое-то время оставаться действительным, но больше не открывает ни одной двери: каждый вызов инструмента сообщает, что доступных проектов нет. Чтобы вернуть агента, снова начните подключение из клиента и заново выберите проекты.

Если что-то не работает#