---
title: "iletiMerkezi MCP Server"
description: "iletiMerkezi SMS API'sini Claude, Cursor ve Cline gibi MCP destekli LLM istemcilerine bağlayan resmi Model Context Protocol sunucusu."
slug: /docs/mcp
locale: tr
audience: developer
last_updated: 2026-04-29
related: [overview, authentication, send-sms, get-report]
alternates:
  tr: https://www.iletimerkezi.com/docs/mcp
  en: https://www.iletimerkezi.com/en/docs/mcp
---

# iletiMerkezi MCP Server

`@iletimerkezi/mcp-server`, Claude Desktop / Cursor / Cline gibi **Model Context Protocol** istemcilerine iletiMerkezi SMS API'sini bağlayan resmi sunucudur. LLM, doğal dil isteğinizi alır, ilgili tool çağrısını üretir ve yanıtı yorumlar; SMS gönderimi, teslimat raporu, bakiye ve kara liste yönetimi tek bir konuşmadan yürütülebilir.

Sunucu tamamen TypeScript, MIT lisanslı, açık kaynaktır: [`iletimerkezi/iletimerkezi-mcp-server`](https://github.com/iletimerkezi/iletimerkezi-mcp-server).

## Sunduğu 7 tool

| Tool | API endpoint | Ne işe yarar |
|---|---|---|
| `send_sms` | `POST /v1/send-sms/json` | Tek veya çoklu numaraya SMS gönderir |
| `get_report` | `POST /v1/get-report/json` | Sipariş teslimat raporu (özet + alıcı bazında) |
| `get_balance` | `POST /v1/get-balance/json` | Hesap bakiyesi (TL + SMS kontörü) |
| `get_sender` | `POST /v1/get-sender/json` | Onaylı sender ID listesi |
| `get_blacklist` | `POST /v1/get-blacklist/json` | Engellenmiş numaralar (sayfalı) |
| `add_blacklist` | `POST /v1/add-blacklist/json` | Numara engelle (idempotent) |
| `delete_blacklist` | `POST /v1/delete-blacklist/json` | Engellemeyi kaldır |

## Kurulum (Claude Desktop)

`claude_desktop_config.json` dosyasına `mcpServers` bloğunu ekleyin:

```json
{
  "mcpServers": {
    "iletimerkezi": {
      "command": "npx",
      "args": ["-y", "@iletimerkezi/mcp-server"],
      "env": {
        "ILETIMERKEZI_API_KEY": "API_ANAHTARINIZ",
        "ILETIMERKEZI_API_HASH": "HASH_DEGERINIZ"
      }
    }
  }
}
```

İki değer de `panel.iletimerkezi.com` → **Ayarlar → Güvenlik → API Erişimi** altından kopyalanır. Hash'i kendiniz hesaplamayın; panel hazır verir. Detay: [authentication](./api/authentication.md).

Claude Desktop'ı tam quit ile kapatıp yeniden açtıktan sonra yeni bir konuşmada mesaj kutusunun altındaki tool ikonuna tıklayın; "iletimerkezi" sunucusu ve 7 tool görünmelidir.

> **Önemli ön koşul:** Panel'de **Ayarlar → Güvenlik → Erişim İzinleri → API kullanımına izin ver** seçeneği açık olmalı. Kapalıysa her çağrı `401` döner. Sunucunun hata mesajı bu adımı doğrudan size hatırlatır.

## Cursor, Cline ve diğer istemciler

Aynı `mcpServers` yapılandırması Cursor (`~/.cursor/mcp.json`), Cline ve diğer MCP destekli istemcilerde de geçerlidir. Sadece dosya yolu değişir; sunucu komutu ve env değişkenleri aynıdır.

## Tek kaynak prensibi

`@iletimerkezi/mcp-server` kendi içinde tool şeması tanımlamaz. Tool tanımları çalışma anında [`/api/manifest.json`](/api/manifest.json) üzerinden çekilir. Manifest, iletiMerkezi'nin resmi endpoint dokümantasyonundan üretilir; yani belgelerdeki bir güncelleme 24 saat içinde tüm MCP istemcilerinde görünür hale gelir, `npm update` gerekmez.

Bu yapı:

- Canlı API ile MCP arasında **drift = 0**.
- iletimerkezi.com erişilemese bile sunucu, `npm publish` anında pakete gömülen **build-time fallback** ile çalışmaya devam eder.
- Yeni endpoint eklendiğinde, dokümantasyon yayınlanır yayınlanmaz LLM'ler tool olarak görür.

## Örnek konuşmalar

LLM'e söyleyeceğiniz cümle, sunucunun arkasında tek bir tool çağrısına dönüşür:

- "Bakiyemi göster." → `get_balance`
- "905XXXXXXXXX numarasına 'Randevunuz yarın 14:00' yaz." → `send_sms` (sender, iys, tüm zarf otomatik)
- "Şu sipariş numarasının teslimat raporunu çıkar: 312988299." → `get_report`
- "0532'li numarayı kara listeye ekle." → `add_blacklist`
- "Onaylı başlıklarımı listele." → `get_sender`

## Güvenlik

- API Anahtarı + Hash hesabınıza tam yetkiyle bağlıdır; sızdırılırsa tek çağrıyla bakiye harcanabilir.
- Anahtarları kaynak kodunda veya çıktı dosyalarında bulundurmayın; MCP istemcisinin config dosyası lokal makinenizde kalır.
- Sunucu, kimlik bilgilerini bellekte saklamaz; her çağrıda env'den okur.
- Üretim entegrasyonlarında IP kısıtlaması ve aylık anahtar rotasyonu önerilir.

## Yardım ve katkı

- Sorun bildirimi: [GitHub Issues](https://github.com/iletimerkezi/iletimerkezi-mcp-server/issues)
- API dokümantasyonu: [API Genel Bakış](./api/overview.md)
- Hata kodları: [Error Codes](./api/error-codes.md)
- Destek: `destek@emarka.com.tr`