Что такое Credentials в n8n и как их настроить

Credentials в n8n — это сохранённые «ключи доступа», с помощью которых Ваши workflow подключаются к внешним сервисам: OpenAI, Telegram, Google Sheets, Gmail и сотням других. Если workflow — это сценарий работы ИИ-агента, то Credentials — это пропуска, которые позволяют агенту действовать в этих сервисах от Вашего имени. Без правильно настроенных Credentials не заработает ни один агент, поэтому эта тема — одна из первых, которые мы разбираем на курсе.

Зачем нужны Credentials простыми словами

Представьте, что Ваш агент должен записать заявку клиента в Google Sheets. Google не позволит неизвестной программе изменять Вашу таблицу — сервису нужно доказательство, что действие совершается с Вашего разрешения. Таким доказательством и являются Credentials: API-ключ, токен или OAuth-авторизация.

В n8n Credentials хранятся централизованно и отдельно от workflow. Это удобно и безопасно: Вы один раз сохраняете ключ, а затем используете его в любом количестве workflow. При экспорте workflow в JSON сами ключи не выгружаются — поэтому, когда Вы импортируете готовый workflow (например, созданный Claude Code), Credentials нужно подключить заново уже в своём n8n.

Основные виды Credentials

1. API Key — ключ доступа

Самый простой вид: длинная секретная строка, которую сервис выдаёт в личном кабинете. Классический пример — OpenAI API Key: Вы создаёте ключ на платформе OpenAI, вставляете его в n8n — и Ваши агенты получают доступ к языковым моделям. Обратите внимание: OpenAI API — это отдельный сервис с отдельной оплатой, он не входит в подписку ChatGPT.

2. Токен бота — доступ к Telegram

Для Telegram роль ключа играет токен бота, который выдаёт BotFather при создании бота. Токен вида 1234567890:AAE... вставляется в Telegram Credentials в n8n — после этого Telegram Trigger начинает принимать сообщения, а Node «Send Message» — отправлять ответы.

3. OAuth — авторизация через аккаунт

Google Sheets и Gmail используют более строгий механизм — OAuth. Вместо копирования ключа Вы проходите авторизацию: n8n перенаправляет Вас на страницу Google, Вы входите в свой аккаунт и подтверждаете, какие именно права получает приложение (например, чтение и запись таблиц). Настройка Google OAuth — обычно самый сложный шаг для новичка, поэтому на курсе мы проходим его пошагово по методичке.

Как создать Credentials в n8n: пошагово

1. Откройте раздел Credentials в меню n8n и нажмите «Add Credential» — либо создайте Credentials прямо из настроек Node.
2. Выберите тип сервиса: OpenAI, Telegram, Google Sheets и т.д.
3. Вставьте ключ или пройдите OAuth-авторизацию.
4. Нажмите «Save» — n8n автоматически проверит подключение.
5. В настройках соответствующего Node выберите созданные Credentials из списка.

Типичные ошибки с Credentials

• 401 Unauthorized — ключ указан с опечаткой, отозван или недействителен. Проверьте, что ключ скопирован целиком, без пробелов.
• 429 / insufficient_quota — на балансе OpenAI API закончились средства. Для работы агентов нужен отдельный бюджет на API-запросы.
• Бот молчит — токен Telegram используется одновременно в двух местах (например, в n8n и в другом сервисе): Telegram отдаёт сообщения только одному получателю.
• Импортированный workflow не работает — после импорта JSON Credentials всегда нужно подключать заново: в файле их нет по соображениям безопасности.
• OAuth-ошибка Google — не совпадает Redirect URL или не выданы нужные права; вернитесь к настройке приложения в Google Cloud Console и проверьте каждый шаг.

Credentials — часть общего маршрута

В маршруте создания агента Credentials занимают своё чёткое место: идея → ChatGPT → ТЗ → Claude Code → JSON → n8n → Credentials и API → Telegram и сервисы → тестирование → работающий агент. Освоив этот шаг один раз на практике, Вы перестанете воспринимать слова API, API Key, OAuth и Webhook как непонятные термины — Вы увидите каждый из них в работе. Подробнее о всём маршруте — в статье «Что такое Vibe Coding».