---
title: "Настройка на удостоверяването | Tajo"
description: "Настройте сигурно удостоверяване за Brevo API и MCP"
url: https://tajo.io/bg/docs/quick-start/authentication-setup/
markdown: https://tajo.io/bg/docs/quick-start/authentication-setup.md
lang: bg-BG
author: "Set Noa"
author_url: https://tajo.io/bg/set-noa/
robots: noindex
---

Заявете ранен достъп

Въведете собственото си име и служебен имейл адрес. Ще ви изпратим връзка за потвърждение на заявката за достъп до Tajo.

# Настройка на удостоверяването

[Set Noa](https://tajo.io/bg/set-noa/)

Brevo предлага два метода за удостоверяване в зависимост от Вашия случай на употреба: **удостоверяване с API ключ** за стандартен достъп до API и **удостоверяване с MCP токен** за AI интеграции. Това ръководство описва и двата метода.

## Удостоверяване с API ключ

API ключовете на Brevo се използват за стандартен достъп през REST API до всички услуги на Brevo.

### Генериране на Вашия API ключ

1. **Влезте** в Вашето табло в Brevo
2. Отидете в **Settings** → **API Keys**
3. Кликнете върху **Generate a New API Key**
4. Дайте на ключа описателно име (например „My App Production”)
5. **Копирайте и съхранете** ключа на сигурно място (няма да го видите отново!)

### Добри практики за сигурност на API ключовете

#### ✅ ПРАВЕТЕ

- **Съхранявайте ключовете сигурно** чрез променливи на средата
- **Използвайте различни ключове** за разработка и за продукция
- **Ротирайте ключовете редовно** (препоръчително на всеки 90 дни)
- **Ограничавайте правата на ключа** само до необходимото
- **Следете използването на ключа** във Вашето табло

#### ❌ НЕ ПРАВЕТЕ

- **Никога не качвайте ключове** в системата за контрол на версиите
- **Не записвайте ключове твърдо** в кода на приложението си
- **Не споделяйте ключове** по имейл или чат
- **Не използвайте продукционни ключове** за тестване

### Променливи на средата

Съхранявайте API ключовете си като променливи на средата:

#### Linux/macOS (.bashrc или .zshrc)

```bash
export BREVO_API_KEY="your_api_key_here"
```

#### Windows (Command Prompt)

```cmd
set BREVO_API_KEY=your_api_key_here
```

#### Node.js (файл .env)

```env
BREVO_API_KEY=your_api_key_here
```

```javascript
// Load from environment
const apiKey = process.env.BREVO_API_KEY;
```

#### Python

```python
import os

api_key = os.getenv('BREVO_API_KEY')
```

#### PHP

```php
$apiKey = $_ENV['BREVO_API_KEY'];
// or
$apiKey = getenv('BREVO_API_KEY');
```

### Хедъри за удостоверяване

Включете API ключа си в хедърите на заявката:

#### Стандартен формат на хедъра

```http
GET /v3/account HTTP/1.1
Host: api.brevo.com
Accept: application/json
api-key: your_api_key_here
```

#### Пример на JavaScript

```javascript
const headers = {
  'Accept': 'application/json',
  'api-key': process.env.BREVO_API_KEY
};

fetch('https://api.brevo.com/v3/account', { headers })
  .then(response => response.json())
  .then(data => console.log(data));
```

#### Заявки с Python

```python
import requests

headers = {
    'Accept': 'application/json',
    'api-key': os.getenv('BREVO_API_KEY')
}

response = requests.get('https://api.brevo.com/v3/account', headers=headers)
```

### Права и обхвати на ключовете

Различните API ключове могат да имат различни права:

- **Само за четене**: разрешени са само GET заявки
- **Изпращане на имейли**: права за транзакционни имейли
- **Управление на контакти**: създаване, актуализиране и изтриване на контакти
- **Управление на кампании**: създаване и изпращане на кампании
- **Пълен достъп**: всички крайни точки на API

### Тестване на удостоверяването

Използвайте тази крайна точка, за да проверите дали удостоверяването работи:

```bash
curl -X GET "https://api.brevo.com/v3/account" \
  -H "Accept: application/json" \
  -H "api-key: $BREVO_API_KEY"
```

**Успешен отговор (200 OK):**

```json
{
  "email": "your-email@company.com",
  "firstName": "John",
  "lastName": "Doe"
}
```

**Грешка при удостоверяване (401 Unauthorized):**

```json
{
  "code": "unauthorized",
  "message": "Invalid API key provided"
}
```

### Ротация на ключовете

За да ротирате своя API ключ:

1. **Генерирайте нов ключ** в таблото
2. **Актуализирайте променливите на средата** с новия ключ
3. **Разположете приложението си** с новия ключ
4. **Тествайте обстойно**, за да сте сигурни, че всичко работи
5. **Отменете стария ключ**, след като сте уверени в новия

### Следене на използването на API ключа

Проследявайте използването на своя API ключ в таблото на Brevo:

- **Заявки на ден/месец**
- **Процент грешки по крайна точка**
- **Географски модели на използване**
- **Часове на пиково натоварване**

### Стратегия с няколко API ключа

За по-големи приложения обмислете използването на няколко API ключа:

- **Продукция**: реални клиентски данни и имейли
- **Staging**: тестване преди продукция
- **Разработка**: локална разработка и тестване
- **Мониторинг**: проверки на състоянието и показатели
- **Външни доставчици**: интеграции с трети страни

---

## Удостоверяване с MCP токен

**Brevo Model Context Protocol (MCP)** е рамка за AI интеграция, която позволява на AI асистентите да взаимодействат с услугите на Brevo. MCP използва отделен метод за удостоверяване чрез MCP токени.

### Какво е MCP?

MCP осигурява стандартизиран AI достъп до API на Brevo чрез:

- **Транспорт**: HTTPS
- **Базов URL**: `https://mcp.brevo.com/v1/`
- **Формат на отговора**: JSON
- **Удостоверяване**: MCP токен (различен от API ключовете)

### Генериране на Вашия MCP токен

1. **Влезте** в Вашето табло в Brevo
2. Отидете в **Settings** → **MCP Tokens** (или настройки на акаунта)
3. Генерирайте нов MCP токен
4. **Копирайте и съхранете** токена на сигурно място

> **Забележка**: MCP в момента е достъпен само за потребители с ранен достъп.

### Използване на MCP токени

MCP токените се използват специално за AI интеграции и връзки по Model Context Protocol:

```bash
export BREVO_MCP_TOKEN="your_mcp_token_here"
```

Включете MCP токена в заявките към крайните точки на MCP:

```http
GET /v1/account HTTP/1.1
Host: mcp.brevo.com
Accept: application/json
Authorization: Bearer your_mcp_token_here
```

### MCP срещу API ключ

| Характеристика | API ключ | MCP токен |
| --- | --- | --- |
| **Случай на употреба** | Стандартен достъп през REST API | AI интеграция и MCP връзки |
| **Базов URL** | api.brevo.com | mcp.brevo.com |
| **Хедър** | `api-key` | `Authorization: Bearer` |
| **Наличност** | Всички потребители | Потребители с ранен достъп |

### Добри практики за сигурност при MCP

- Съхранявайте MCP токените отделно от API ключовете
- Използвайте променливи на средата за съхранение на токените
- Ротирайте токените редовно
- Никога не качвайте токени в системата за контрол на версиите
- Следете използването на MCP във Вашето табло

---

## Отстраняване на проблеми с удостоверяването

### Чести проблеми с API ключовете

**Невалиден формат на API ключа**

- Ключовете трябва да са с дължина точно 64 знака
- Проверете за излишни интервали или знаци

**Грешка с правата**

- Проверете дали ключът има необходимите права
- Проверете дали ключът е активен във Вашето табло

**Ограничаване на заявките**

- Неуспешните удостоверявания се броят към лимита на заявките
- Изчакайте, преди да опитате отново с коректни данни

**Географски ограничения**

- Някои акаунти имат ограничения по IP
- Свържете се с поддръжката, ако трябва да добавите IP адреси в белия списък

### Чести проблеми с MCP токените

**MCP не е наличен**

- Уверете се, че имате ранен достъп до функциите на MCP
- Свържете се с поддръжката на Brevo, за да заявите достъп

**Невалиден токен**

- Проверете дали токенът е копиран правилно, без интервали
- Проверете дали токенът не е изтекъл или отменен

**Грешен базов URL**

- MCP токените работят само с mcp.brevo.com
- Не използвайте MCP токени с крайните точки на api.brevo.com

## Следващи стъпки

- [Научете повече за лимитите на заявките](https://tajo.io/bg/docs/rate-limits/)
- [Инсталирайте SDK](https://tajo.io/bg/docs/sdks-libraries/)
- [Направете първата си заявка към API](https://tajo.io/bg/docs/quick-start/first-api-call/)