Работа в приложении

Ключи API

Области ключей, привязка к диаграммам, webhook и MCP.

Ключи API в редакторе (/app/flow → вкладка Хранилище → блок Ключи API) — токены с префиксом afk_…. Ими пользуется внешняя программа или IDE, чтобы вызвать ваш флоу по webhook или MCP. Секреты для полей нод — в соседнем блоке того же экрана.

Области (scopes)

У ключа заданы области:

  • webhook — вызовы /webhook/v1/....
  • mcpPOST /mcp/v1 (JSON-RPC).

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

Привязка к флоу

Ключ действует только с вашими диаграммами из явно указанного списка.

В окне создания ключа выпадающий список показывает флоу с триггером webhook. Для процесса только с MCP (mcp_tool без webhook) привязку ключа смотрите в панели Внешние инструменты; без подходящего флоу в списке выбор может быть недоступен.

Пустой список диаграмм — ключ не запустит webhook и MCP, пока не добавят хотя бы одну диаграмму.

Создали — сохраните строку

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

Переименование и привязки меняют в меню строки ключа.

См. также