Phygital+ для агентов

Плагин подключает генеративные модели Phygital+ к агенту: выбрать модель, прочитать её живую схему входа, передать файл, запустить генерацию и дождаться результата.

Внутри нет ничего, кроме описания: вся работа идёт на MCP-сервере портала (/api/mcp), а плагин отвечает за то, чтобы сервер оказался подключён, а агент знал, как им пользоваться.

Что внутри

Что	Зачем
`.claude-plugin/plugin.json`	манифест для Claude Code
`plugin.json`	портативный манифест для Codex, настройки OpenAI — в `extensions."com.openai"`
`.mcp.json`	адрес MCP-сервера в формате Claude Code
`mcp.json`	тот же сервер в формате Codex: `streamable-http`, OAuth через DCR
`skills/phygital-mcp/`	навык: порядок вызовов, сборка входа, работа с файлами и ошибками
`skills/phygital-which-ai/`	навык: какую модель взять под задачу
`commands/`	`/phygital-plus:connect`, `:models`, `:generate`, `:job` — только Claude Code

Навыки — копия docs/skills из корня репозитория; правятся они там, а сюда переносятся node scripts/sync-plugin-skills.mjs. CI падает, если копия отстала: разъехавшийся навык обещает агенту инструменты, которых на сервере уже нет.

Установка

Claude Code:

claude plugin marketplace add <адрес этого репозитория>
claude plugin install phygital-plus@phygital-plus

Codex — маркетплейс объявлен в .agents/plugins/marketplace.json:

codex plugin marketplace add <адрес этого репозитория>

дальше плагин ставится из каталога плагинов клиента.

Версии

version стоит в обоих манифестах и поднимается вместе на каждый релиз: Claude Code сравнивает именно её, и без новой версии claude plugin update оставит у человека старую копию. Перед коммитом — claude plugin validate --strict . из корня репозитория.

Авторизация

Сервер принимает два способа, и оба остаются рабочими.

OAuth — то, с чем плагин ставится. Настраивать нечего: при первом обращении к серверу клиент сам откроет вход, дальше токен живёт у клиента. Именно этот путь описан в .mcp.json — заголовков там нет намеренно, иначе клиент не пойдёт по OAuth-дискавери.

Личный API-ключ — для стендов и клиентов, где OAuth не включён. Ключ берётся в портале («API-ключ» в шапке) и прописывается в конфиг MCP руками:

{
  "phygital": {
    "type": "http",
    "url": "https://dev.phygital.plus/api/mcp",
    "headers": { "Authorization": "Bearer ${PHYGITAL_API_KEY}" }
  }
}

Сам ключ — в переменной окружения PHYGITAL_API_KEY, не в файле: он тратит кредиты владельца.

Что именно настроено у человека, покажет /phygital-plus:connect.

Другие клиенты

Сервер обычный Streamable HTTP MCP, поэтому подключается всюду, где есть поддержка удалённых MCP-серверов, — плагин нужен только там, где есть формат плагинов (Claude Code, Codex). Адрес везде один: https://dev.phygital.plus/api/mcp.

Навык при этом не переносится сам: там, где формата навыков нет, его текст вставляют в инструкции агента вручную — копия лежит в skills/phygital-mcp/ и на странице /skills портала.