# Ajanınız yazar. Shager yayınlar. Kontrol sizde kalır.

Claude, ChatGPT, Cursor ya da herhangi bir MCP istemcisini OAuth ile giriş yaparak, bir botu cihaz koduyla, geri kalan her şeyi de bir API anahtarı veya REST API ile bağlayın. Ajanınız bir video ya da görseller yükler, tüm hesaplar için tek bir gönderi hazırlar (Reels, Shorts, hikaye, TikTok videosu veya gönderi) ve her platformun kurallarına göre kontrol eder. Yayınlama, bir kişi açana kadar kapalı kalır.

Her planda MCP sunucusu, REST API ve OpenAPI dokümantasyonu, lansman döneminde ücretsiz.

## Tek video. Sekiz hesap.

Ajan videoyu upload_media_from_url ile yükler ve bir hesap grubuyla tek bir gönderi gönderir. Shager her hesap için, o platformun desteklediği formatta bir sürüm döndürür: Reels, Shorts, TikTok videosu, LinkedIn videosu. Her birinin kendi gönderim saati olur.

MCP: `https://app.shager.ai/api/mcp`

```json
// 1 · upload the video once
{
  "name": "upload_media_from_url",
  "arguments": {
    "workspace_id": "cm2studionoa",
    "url": "https://studio-noa.co.il/media/workshop.mp4"
  }
}
// → { "id": "cm2wheelvideo", "kind": "VIDEO",
//     "width": 1080, "height": 1920, "duration_ms": 24000 }  (measured by Shager)

// 2 · one post to every account
{
  "name": "create_post",
  "arguments": {
    "workspace_id": "cm2studionoa",
    "group_ids": ["cm2allaccounts"],
    "caption": "A new evening workshop…",
    "media_ids": ["cm2wheelvideo"],
    "cta_url": "https://studio-noa.co.il/workshop",
    "youtube_made_for_kids": false,
    "per_channel": [{
      "channel_id": "cm2tiktok",
      "tiktok_privacy": "SELF_ONLY"
    }],
    "schedule_at": "2026-10-20T09:00:00+03:00",
    "idempotency_key": "workshop-oct-20"
  }
}
```

```json
{
  "status": "SCHEDULED",
  "scheduled_at": "2026-10-20T06:00:00.000Z",
  "stagger_seconds": { "min": 30, "max": 90 },
  "issues": [],
  "destinations": [
    { "network": "INSTAGRAM", "format": "REEL",  "state": "PENDING" },
    { "network": "FACEBOOK",  "format": "REEL",  "state": "PENDING" },
    { "network": "YOUTUBE",   "format": "SHORT", "state": "PENDING" },
    { "network": "TIKTOK",    "format": "VIDEO", "state": "PENDING" },
    { "network": "LINKEDIN",  "format": "VIDEO", "state": "PENDING" },
    { "network": "X",         "format": "FEED",  "state": "PENDING" }
    // … 2 more, each with its own dispatch_at
  ],
  "calendar_notes": []
}
```

- `validate_post`, hiçbir şey kaydedilmeden önce tüm hesaplardaki tüm sorunları tek seferde döndürür.
- `calendar_notes`, seçilen gündeki tatilleri işaretler; böylece ajan zamanlamayı yeniden düşünebilir.
- `idempotency_key` yeniden denemeleri güvenli kılar: aynı istek asla ikinci bir gönderi oluşturmaz.

## İşi ajan yapar. Kararı bir insan verir.

- **Sahipliği bir insan alır.** Kendi kendine kaydolan bir ajan bir sandbox alır: taslaklar, medya ve müşteriler; planlama ve yayınlama yok. Bir kişi sahiplenme linkini açar, giriş yapar ve ancak o zaman organizasyon onun olur.
- **Yayınlama varsayılan olarak kapalıdır.** Her anahtarın okuma, yazma ve yayınlama izinleri vardır. Yayınlama izni ayrıca ve yalnızca bir insan tarafından verilir; anahtar her an iptal edilebilir.
- **Büyük veya ani gönderimler onay bekler.** 10 hesaptan fazlasına veya 60 dakika içinde yapılan gönderim hemen çıkmaz. Ajan size göstermek için bir gönderim planı alır ve yalnızca bir onay belirteciyle yeniden gönderir.
- **Anahtar başına sınırlar ve her işlem için kayıt.** Gönderi başına en fazla 50 hesap ve 24 saatte 20 planlı gönderi. Ajanın her işlemi kaydedilir: ne, ne zaman ve hangi anahtarla.

## Bağlanmanın üç yolu. Her ajan için.

### 1. OAuth destekleyen her MCP istemcisi

Sunucu adresini istemciye ekleyin (Claude ve ChatGPT’de özel bağlayıcı olarak). İstemci sizi Shager’e yönlendirir: giriş yapın, organizasyonu seçin ve onaylayın. Kopyalanacak anahtar yok; yayınlama, siz işaretlemedikçe kapalı kalır.

```sh
# MCP server URL (sign in with OAuth)
https://app.shager.ai/api/mcp
```

### 2. Tarayıcısız botlar: cihaz kodu

Tarayıcısı olmayan bir bot veya ajan bir kez kaydolur (RFC 7591), bir kod ister ve size gösterir. Telefonunuzdan app.shager.ai/device adresinde, aynı ekran ve aynı izinlerle onaylarsınız.

```sh
curl -X POST https://app.shager.ai/api/oauth/device_authorization \
  -d client_id=shgr_client_… \
  -d resource=https://app.shager.ai/api/mcp
# → user_code "BCDF-GHJK", verification_uri
#   https://app.shager.ai/device · then poll /api/oauth/token
```

### 3. Geri kalan her şey: API anahtarı

Ajanlar sayfasında bir anahtar oluşturun ve MCP veya REST API üzerinden Bearer başlığıyla gönderin. Henüz hesabınız yok mu? Ajan kendini bir sandbox’a kaydeder, siz de sonra sahiplenirsiniz (auth.md).

```sh
claude mcp add --transport http shager \
  https://app.shager.ai/api/mcp \
  --header "Authorization: Bearer shgr_live_…"
```

MCP config (Cursor and other clients):

```json
{
  "mcpServers": {
    "shager": {
      "url": "https://app.shager.ai/api/mcp",
      "headers": { "Authorization": "Bearer shgr_live_…" }
    }
  }
}
```

## Ajanın yapabileceği her şey.

- `whoami`: Ben kimim: organizasyon, anahtarın izinleri, sınırlar ve sandbox durumu
- `get_structure`: Tüm hesap tek bakışta: müşteriler, her müşterinin hesapları ve grupları
- `get_claim_link`: Organizasyonu sahiplenme linki
- `list_workspaces`: Müşterileri listele (çalışma alanları)
- `create_workspace`: Yeni müşteri aç
- `list_channels`: Bağlı hesaplar ve her platformun kuralları
- `create_connect_link`: Müşterinin kendi hesaplarını bağladığı link
- `list_groups`: Hesap grupları
- `create_group`: Grup oluştur (şubeler, markalar, kampanya)
- `upload_media_from_url`: URL’den görsel veya video yükle
- `validate_post`: Son içeriği ve planlamaya hazır olup olmadığını kontrol et
- `create_post`: Birçok hesap için tek gönderi, her platforma uyarlanmış
- `update_post`: Taslağı düzenle
- `schedule_post`: Hesaplar arasında kademeli gönderimle planla
- `request_approval`: Müşteri için onay linki
- `get_approval`: Gönderinin onay durumu
- `get_post`: Her hesaptaki yayın durumu, hatalar dahil
- `list_posts`: İçerik takvimi
- `cancel_post`: Planlamayı iptal et
- `delete_post`: Taslağı sil
- `list_comments`: YouTube veya Instagram'da yayınlanan bir gönderinin yorumları
- `reply_to_comment`: Hesap adına bir yoruma yanıt ver
- `hide_comment`: Bir yorumu gizle veya göster
- `delete_comment`: Bir yorumu sil
- `get_analytics`: Hesap ve gönderi başına tıklama
- `create_webhook`: 
- `list_webhooks`: 
- `delete_webhook`: 
- `send_test_webhook`: 
- `get_holidays`: Ne zaman yayınlanacağını seçmek için geleneğe göre tatiller ve özel günler

## Makinece okunabilir dosyalar

- `/llms.txt`: Ajanlar için site haritası: Shager nedir ve her sayfa nerededir.
- `/llms-full.txt`: Herkese açık tüm içerik tek bir Markdown dosyasında.
- `/md/…`: Her sayfanın Markdown sürümü. Örnek: /md/tr/pricing
- `https://app.shager.ai/api/v1/openapi.json`: REST API’nin eksiksiz OpenAPI belirtimi.
- `https://app.shager.ai/.well-known/oauth-authorization-server`: OAuth sunucusu meta verileri: dinamik istemci kaydı, PKCE, cihaz kodu.

## Ajan bağlamadan önce en çok sorulanlar.

### Bugün hangi ajanlar Shager ile çalışıyor?

OAuth ile girişi (Claude veya ChatGPT’deki özel bağlayıcı gibi) ya da API anahtarı başlığını (Claude Code, Cursor veya Codex gibi) destekleyen her MCP istemcisi, cihaz koduyla tarayıcısız botlar ve ajanlar, ve REST API’yi çağıran her kod.

### Ajan benim haberim olmadan yayın yapabilir mi?

Varsayılan olarak hayır. Yayınlama, bir insanın verdiği ayrı bir yayınlama izni gerektirir; bu izin anahtar oluştururken, sandbox’ı sahiplenirken veya bir bağlantıyı onaylarken kapalıdır. Ayrıca 10 hesaptan fazlasına veya 60 dakika içinde gönderim ikinci bir onay gerektirir. Bir çalışma alanındaki her gönderi için müşteri onayını da zorunlu kılabilirsiniz.

### Ajan için ayrıca ücret var mı?

Hayır. API ve MCP sunucusu her plana dahildir; ajanınızın oluşturduğu bir gönderi diğer gönderiler gibi sayılır.

### Ajan hata yaparsa ne olur?

Planlanmış bir gönderi yayınlanana kadar iptal edilebilir, taslak silinebilir. Her işlem kayda geçer ve anahtar tek tıkla iptal edilebilir.

### Ajan başkalarının hesaplarında paylaşım yapabilir mi?

Yalnızca organizasyonunuza bağlı hesaplarda, her platformun resmî izin ekranı üzerinden. Ajan şifreleri asla görmez.

Takip linkleri tıklamaları hesaba ve gönderiye göre gösterir. Potansiyel müşteri ve satış ilişkilendirmesi için analiz aracınız veya CRM'iniz gerekir.

---
Source: https://shager.ai/tr/agents