---
title: "Kimlik Doğrulama Kurulumu | Tajo"
description: "Brevo API ve MCP için güvenli kimlik doğrulama kurun"
url: https://tajo.io/tr/docs/quick-start/authentication-setup/
markdown: https://tajo.io/tr/docs/quick-start/authentication-setup.md
lang: tr-TR
author: "Set Noa"
author_url: https://tajo.io/tr/set-noa/
robots: noindex
---

Erken erişim talep edin

Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz.

# Kimlik Doğrulama Kurulumu

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

Brevo, kullanım senaryonuza göre iki kimlik doğrulama yöntemi sunar: standart API erişimi için **API anahtarı ile kimlik doğrulama** ve yapay zekâ entegrasyonları için **MCP token ile kimlik doğrulama**. Bu kılavuz her iki yöntemi de kapsar.

## API anahtarı ile kimlik doğrulama

Brevo API anahtarları, tüm Brevo hizmetlerine standart REST API erişimi için kullanılır.

### API anahtarınızı oluşturun

1. Brevo yönetim panelinize **giriş yapın**
2. **Ayarlar** → **API Keys** bölümüne gidin
3. **Generate a New API Key** düğmesine tıklayın
4. Anahtarınıza açıklayıcı bir ad verin (örneğin “My App Production”)
5. Anahtarı **kopyalayın ve güvenli biçimde saklayın** (bir daha göremezsiniz)

### API anahtarı güvenliği için en iyi uygulamalar

#### ✅ YAPIN

- Anahtarları ortam değişkenleri kullanarak **güvenli biçimde saklayın**
- Geliştirme ve üretim için **farklı anahtarlar kullanın**
- **Anahtarları düzenli olarak yenileyin** (90 günde bir önerilir)
- **Anahtar izinlerini** yalnızca gerekli olanla sınırlayın
- Yönetim panelinizden **anahtar kullanımını izleyin**

#### ❌ YAPMAYIN

- Anahtarları **asla sürüm kontrolüne göndermeyin**
- Anahtarları uygulamanızın içine **sabit olarak yazmayın**
- Anahtarları e-posta veya sohbet yoluyla **paylaşmayın**
- Test için **üretim anahtarlarını kullanmayın**

### Ortam değişkenleri

API anahtarlarınızı ortam değişkeni olarak saklayın:

#### Linux/macOS (.bashrc veya .zshrc)

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

#### Windows (Komut İstemi)

```cmd
set BREVO_API_KEY=your_api_key_here
```

#### Node.js (.env dosyası)

```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');
```

### Kimlik doğrulama başlıkları

API anahtarınızı istek başlıklarına ekleyin:

#### Standart başlık biçimi

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

#### JavaScript örneği

```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 Requests

```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)
```

### Anahtar izinleri ve kapsamları

Farklı API anahtarları farklı izinlere sahip olabilir:

- **Salt okunur**: Yalnızca GET isteklerine izin verilir
- **E-posta gönderme**: İşlemsel e-posta izinleri
- **Kişileri yönetme**: Kişi oluşturma, güncelleme, silme
- **Kampanya yönetimi**: Kampanya oluşturma ve gönderme
- **Tam erişim**: Tüm API uç noktaları

### Kimlik doğrulamanızı test etme

Kimlik doğrulamanızın çalıştığını doğrulamak için bu uç noktayı kullanın:

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

**Başarılı yanıt (200 OK):**

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

**Kimlik doğrulama hatası (401 Unauthorized):**

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

### Anahtar yenileme

API anahtarınızı yenilemek için:

1. Yönetim panelinde **yeni bir anahtar oluşturun**
2. **Ortam değişkenlerinizi** yeni anahtarla **güncelleyin**
3. **Uygulamanızı** yeni anahtarla **dağıtın**
4. Her şeyin çalıştığından emin olmak için **kapsamlı test yapın**
5. Yeni anahtardan emin olduğunuzda **eski anahtarı iptal edin**

### API anahtarı kullanımını izleme

API anahtarı kullanımınızı Brevo yönetim panelinden izleyin:

- **Gün/ay başına istek sayısı**
- **Uç nokta bazında hata oranları**
- **Coğrafi kullanım desenleri**
- **En yoğun kullanım saatleri**

### Çoklu API anahtarı stratejisi

Daha büyük uygulamalarda birden çok API anahtarı kullanmayı değerlendirin:

- **Üretim**: Canlı müşteri verileri ve e-postaları
- **Hazırlık**: Üretim öncesi testler
- **Geliştirme**: Yerel geliştirme ve test
- **İzleme**: Sağlık kontrolleri ve metrikler
- **Üçüncü taraf**: Dış entegrasyonlar

---

## MCP token ile kimlik doğrulama

**Brevo Model Context Protocol (MCP)**, yapay zekâ asistanlarının Brevo hizmetleriyle etkileşim kurmasını sağlayan bir yapay zekâ entegrasyon çerçevesidir. MCP, MCP token’ları üzerinden ayrı bir kimlik doğrulama yöntemi kullanır.

### MCP nedir?

MCP, Brevo API’lerine standartlaştırılmış yapay zekâ erişimi sağlar:

- **Aktarım**: HTTPS
- **Temel URL**: `https://mcp.brevo.com/v1/`
- **Yanıt biçimi**: JSON
- **Kimlik doğrulama**: MCP token (API anahtarlarından farklıdır)

### MCP token’ınızı oluşturun

1. Brevo yönetim panelinize **giriş yapın**
2. **Ayarlar** → **MCP Tokens** bölümüne (veya hesap ayarlarına) gidin
3. Yeni bir MCP token oluşturun
4. Token’ı **kopyalayın ve güvenli biçimde saklayın**

> **Not**: MCP şu anda yalnızca erken erişim kullanıcıları için kullanılabilir.

### MCP token’larını kullanma

MCP token’ları özellikle yapay zekâ entegrasyonları ve Model Context Protocol bağlantıları için kullanılır:

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

MCP uç noktalarına gönderdiğiniz isteklere MCP token’ını ekleyin:

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

### MCP ile API anahtarı karşılaştırması

| Özellik | API anahtarı | MCP token |
| --- | --- | --- |
| **Kullanım senaryosu** | Standart REST API erişimi | Yapay zekâ entegrasyonu ve MCP bağlantıları |
| **Temel URL** | api.brevo.com | mcp.brevo.com |
| **Başlık** | `api-key` | `Authorization: Bearer` |
| **Kullanılabilirlik** | Tüm kullanıcılar | Erken erişim kullanıcıları |

### MCP güvenliği için en iyi uygulamalar

- MCP token’larını API anahtarlarından ayrı saklayın
- Token saklamak için ortam değişkenleri kullanın
- Token’ları düzenli olarak yenileyin
- Token’ları asla sürüm kontrolüne göndermeyin
- MCP kullanımını yönetim panelinizden izleyin

---

## Kimlik doğrulama sorunlarını giderme

### Sık karşılaşılan API anahtarı sorunları

**Geçersiz API anahtarı biçimi**

- Anahtarlar tam olarak 64 karakter uzunluğunda olmalıdır
- Fazladan boşluk veya karakter olup olmadığını denetleyin

**İzin hatası**

- Anahtarınızın gerekli izinlere sahip olduğunu doğrulayın
- Anahtarın yönetim panelinizde etkin olup olmadığını denetleyin

**Hız sınırlaması**

- Başarısız kimlik doğrulamalar da hız sınırlarına dahil edilir
- Doğru kimlik bilgileriyle yeniden denemeden önce bekleyin

**Coğrafi kısıtlamalar**

- Bazı hesaplarda IP kısıtlamaları vardır
- IP adreslerini izin listesine eklemeniz gerekiyorsa destek ekibiyle iletişime geçin

### Sık karşılaşılan MCP token sorunları

**MCP kullanılamıyor**

- MCP özelliklerine erken erişiminizin olduğundan emin olun
- Erişim talep etmek için Brevo destek ekibiyle iletişime geçin

**Geçersiz token**

- Token’ın boşluksuz ve eksiksiz kopyalandığını doğrulayın
- Token’ın süresinin dolmadığını veya iptal edilmediğini denetleyin

**Yanlış temel URL**

- MCP token’ları yalnızca mcp.brevo.com ile çalışır
- MCP token’larını api.brevo.com uç noktalarıyla kullanmayın

## Sonraki adımlar

- [Hız sınırları hakkında bilgi edinin](https://tajo.io/tr/docs/rate-limits/)
- [Bir SDK kurun](https://tajo.io/tr/docs/sdks-libraries/)
- [İlk API çağrınızı yapın](https://tajo.io/tr/docs/quick-start/first-api-call/)