Баунс в вашем кодинг-агенте

Ваш кодинг-агент на ноутбуке (Claude Code, Codex, Cursor) может работать с Баунсом от вашего имени: заводить и править задачи, читать треды и «Знания», менять то, что открывает ваш токен. Для этого CLI bounc запускается как MCP-сервер по stdio:

bounc mcp serve --as-me

У сервера два инструмента:

• bounc_describe показывает, что можно вызвать: без аргумента список разделов API, с разделом (issues) его процедуры и их поля, с процедурой (issues.create) её схему входа.
• bounc_call вызывает процедуру по имени, например issues.create, и возвращает ответ как JSON. Отказ тоже приходит ответом: {"error":{"code":…,"hint":…}}, где подсказка говорит, что поправить.

Агент действует как вы: задача, которую он завёл, ваша, а в Настройках → Журнал действий рядом с ней написано, через что пришёл вызов: «Через: Токен доступа «Claude Code»» или «Через: Вход CLI».

Чем аутентифицироваться

Сервер берёт учётные данные так же, как любая команда bounc:

• BOUNC_TOKEN из окружения: персональный токен с выбранным допуском. Так безопаснее: агент получает только то, что открывает допуск токена.
• Вход CLI (bounc login), если BOUNC_TOKEN не задан. Вход это ваша собственная рука, у него нет допуска: агент может всё, что можете вы, включая личное и управление пространством.

Рабочее пространство одно на подключение: флаг --workspace <id>, иначе то, что выбрано в профиле (BOUNC_WORKSPACE_ID).

Какой допуск выбрать

Допуск задаётся при создании токена в Настройках → API-токены.

Выше допуска сервер отказывает с кодом above_clearance. Карточки «Разрешить» у токена нет: чтобы агент мог больше, выпустите токен с допуском шире.

Claude Code

claude mcp add bounc --env BOUNC_TOKEN=bnp_… -- bounc mcp serve --as-me --workspace <id>

Или в .mcp.json проекта; Claude Code подставит ${BOUNC_TOKEN} из окружения, в котором запущен, и токен не попадёт в файл:

{
  "mcpServers": {
    "bounc": {
      "command": "bounc",
      "args": ["mcp", "serve", "--as-me", "--workspace", "<id>"],
      "env": { "BOUNC_TOKEN": "${BOUNC_TOKEN}" }
    }
  }
}

Codex

В ~/.codex/config.toml:

[mcp_servers.bounc]
command = "bounc"
args = ["mcp", "serve", "--as-me", "--workspace", "<id>"]
env = { BOUNC_TOKEN = "bnp_…" }

Cursor

В ~/.cursor/mcp.json или .cursor/mcp.json проекта:

{
  "mcpServers": {
    "bounc": {
      "command": "bounc",
      "args": ["mcp", "serve", "--as-me", "--workspace", "<id>"],
      "env": { "BOUNC_TOKEN": "bnp_…" }
    }
  }
}

Далее

• Вход и токены — как выпустить и отозвать персональный токен.
• Справочник CLI — профили и переменные окружения.