К плану
Урок
12+

Получение и безопасное хранение API-ключей

В предыдущих темах мы подготовили рабочее окружение и научились упаковывать серверы в Docker-контейнеры. Теперь пришло время «оживить» наших агентов. Чтобы MCP-сервер мог взаимодействовать с большими языковыми моделями (LLM), ему необходим доступ к их API.

Этот доступ обеспечивает API-ключ — уникальный идентификатор, который подтверждает провайдеру (Anthropic, OpenAI), что запрос легален и должен быть оплачен с вашего аккаунта. В 2026 году, когда агенты совершают тысячи операций в секунду, защита API-ключей стала критически важной: боты-сканеры находят ключи в открытом коде за секунды и мгновенно обнуляют ваш баланс.

Где брать ключи

Для работы с Claude (основной моделью для MCP) создайте аккаунт в Anthropic Console. В разделе «API Keys» сгенерируйте новый ключ.

Для российских разработчиков актуальны локальные модели. Процесс получения ключей для GigaChat (через GigaChain/SberCloud) или YandexGPT (через Yandex Cloud) аналогичен: создаете сервисный аккаунт, генерируете ключ или IAM-токен и сохраняете его.

Почему нельзя хранить ключи в коде

Никогда не вставляйте ключ прямо в исходный код (hardcoding).

Пример опасного кода. При публикации на GitHub такой ключ будет украден или аннулирован системами безопасности:

# settings.py
API_KEY = "sk-ant-api03-..." # ОШИБКА: ключ в открытом виде

Безопасный метод — изоляция секретов. Как работает этот механизм, показано на Схеме 1.

Переменные окружения и .env-файл

Переменные окружения — это данные, которые хранятся в операционной системе и доступны вашим программам. Чтобы не прописывать их вручную в терминале, используют .env-файл. Это простой текстовый файл в корне проекта, где настройки хранятся в формате КЛЮЧ=ЗНАЧЕНИЕ.

Шаг 1. Настройка .env и .gitignore

  1. Создайте файл .env в корне проекта:
ANTHROPIC_API_KEY=your_secret_key_here
GIGACHAT_CREDENTIALS=your_auth_data
  1. Создайте файл .gitignore и добавьте в него строку .env. Это запретит Git отслеживать файл и отправлять его в облако. Ваш секрет останется только на вашем компьютере 🛡️.

Шаг 2. Чтение ключей в коде

Используйте стандартные библиотеки для загрузки переменных.

Python (библиотека python-dotenv):

import os
from dotenv import load_dotenv

load_dotenv() # Загружает данные из .env в окружение
api_key = os.getenv("ANTHROPIC_API_KEY")

TypeScript (библиотека dotenv):

import * as dotenv from 'dotenv';
dotenv.config();

const apiKey = process.env.ANTHROPIC_API_KEY;

Лимиты и квоты

Даже при безопасном хранении ключей всегда настраивайте лимиты в личном кабинете провайдера. Установите «Monthly Budget» (например, $10) и «Hard Limit». Если из-за ошибки в коде агент уйдет в бесконечный цикл, лимит спасет вас от огромных счетов 💸.

Практика: Проверка изоляции

  1. Создайте в корне проекта файл .env с текстом TEST_KEY=12345.
  2. Добавьте .env в файл .gitignore.
  3. Напишите скрипт на Python или TS, который считывает TEST_KEY и выводит: «Ключ успешно загружен» (но не печатает сам ключ!).
  4. Введите в терминале git status. Если вы видите .env в списке «Untracked files», значит, .gitignore не работает — проверьте правильность написания имени файла.

Теперь ваши секреты защищены. В следующей теме мы используем этот ключ, чтобы настроить MCP-сервер для работы с Claude и совершить первый вызов модели.

Сохраните прогресс в Telegram.Продолжить в Telegram