Получение и безопасное хранение 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
- Создайте файл
.envв корне проекта:
ANTHROPIC_API_KEY=your_secret_key_here
GIGACHAT_CREDENTIALS=your_auth_data
- Создайте файл
.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». Если из-за ошибки в коде агент уйдет в бесконечный цикл, лимит спасет вас от огромных счетов 💸.
Практика: Проверка изоляции
- Создайте в корне проекта файл
.envс текстомTEST_KEY=12345. - Добавьте
.envв файл.gitignore. - Напишите скрипт на Python или TS, который считывает
TEST_KEYи выводит: «Ключ успешно загружен» (но не печатает сам ключ!). - Введите в терминале
git status. Если вы видите.envв списке «Untracked files», значит,.gitignoreне работает — проверьте правильность написания имени файла.
Теперь ваши секреты защищены. В следующей теме мы используем этот ключ, чтобы настроить MCP-сервер для работы с Claude и совершить первый вызов модели.