Yapay zekâ ajanlarını Eyivo Sites platformuna bağlayın.

1. Genel Bakış

Eyivo Sites MCP sunucusu, Streamable HTTP üzerinden Model Bağlam Protokolünü uygular. Bir MCP istemcisi mevcut araçları ve bunların giriş şemalarını keşfeder ve ardından bunları aracı iş akışının bir parçası olarak ne zaman çağıracağına karar verir.

MCP; araçlar, içerik iş akışı rehberi, site yetenek kaynağı şablonu ve medya yükleme uygulaması sunar.

Paylaşılan hizmet katmanı: MCP araçları, kontrol paneli ve REST API ile aynı Laravel hizmetlerini çağırır. Sahipliği, plan sınırlarını, doğrulamayı veya yayınlama kurallarını atlamazlar ve HTTP üzerinden genel REST API'yu çağırmazlar.

2. Hızlı başlangıç

1. 1
   Kişisel bir API belirteci oluşturun.

   API belirteçlerini açın. mcp:use'yu ve izin vermeyi düşündüğünüz araçların kapsamlarını seçin, ardından gösterildiğinde ey_ sırrını kopyalayın.

2. 2
   Sunucuyu yapılandırın.

   https://app.eyivo.com/mcp adresini uzak Streamable HTTP MCP sunucusu olarak kullanın ve belirteci Bearer kimlik bilgisi olarak gönderin.

3. 3
   Keşfi onaylayın.

   Bir site seçip yeteneklerini okuyun: etkin diller, tema alanları, bileşen şemaları, menü konumları ve kurulu eklenti panelleri. Yazmadan önce content-workflow kaynağını okuyun. Kaynakları desteklemeyen istemciler get-site-capabilities-tool kullanabilir. Keşif tamamlanana kadar tools/list nextCursor değerini izleyin.

Genel istemci yapılandırması

MCP istemcileri farklı yapılandırma anahtarları kullanır. Eşdeğer bağlantı değerleri şunlardır:

{
  "mcpServers": {
    "eyivo": {
      "type": "http",
      "url": "https://app.eyivo.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EYIVO_API_TOKEN}"
      }
    }
  }
}

Her MCP POST'un bu yetkilendirme başlığına ihtiyacı vardır. Eksik veya geçersiz kimlik bilgileri, araç keşfinden veya yürütülmesinden önce reddedilir.

Authorization: Bearer ey_your_token

3. İstemciler

Özel aracılar ve masaüstü IDE'ler için kişisel bir API belirteci kullanın. ChatGPT veya Claude bağlayıcıları gibi kullanıcının açık izniyle hareket eden üçüncü taraf ana bilgisayarlar için OAuth 2.0'yu PKCE ile birlikte kullanın.

Bağlı OAuth uygulamaları https://app.eyivo.com/connections konumunda görünür. Plan sınırları, bağlı uygulamaların ve kişisel belirteçlerin sayısı için geçerlidir.

4. Kimlik doğrulama ve keşif

MCP aktarımı, araçları listelemeden veya çalıştırmadan önce her istekte kimlik doğrular. ey_ ile başlayan kişisel belirteçler ve Passport erişim belirteçleri Bearer kimlik bilgisi olarak kabul edilir.

OAuth meta verileri

Standartlara duyarlı istemciler, korumalı kaynak keşfiyle başlamalıdır. Yapılandırılmış bir OAuth istemcisinin mcp:use ve ihtiyaç duyduğu her araç kapsamını istemesine izin verilmelidir.

5. Kapsamlar

Tüm bağlantılar mcp:use gerektirir. Bu kapsam MCP aktarımını açar; tek başına hiçbir hesaba, siteye veya içerik işlemine izin vermez.

Öneri: mcp:use account:read sites:read content:read kapsamlarıyla salt okunur olarak başlayın. Yazma kapsamlarını yalnızca ajanın ihtiyaç duyduğu iş akışları için ekleyin. Siteyle sınırlı bir kişisel belirteç site araçlarını yalnızca atandığı site için çağırabilir.

Mevcut OAuth bağlantıları eklenen media:read veya media:write kapsamları için yeniden yetkilendirilmelidir. Yalnızca yeniden bağlanmak eski izni genişletmez.

6. Araç kataloğu

Bunlar içerik ailesine göre örneklerdir. Tüm girdi/çıktı şemalarını ve gerekli kapsamları tools/list veya OpenAPI belgesinden keşfedin. Aşağıdaki REST yolları /api/v1/sites/{site} adresine göredir.

Yetenekler ve içerik düzenleme sözleşmesi

Bir site seçip yeteneklerini okuyun: etkin diller, tema alanları, bileşen şemaları, menü konumları ve kurulu eklenti panelleri. Yazmadan önce content-workflow kaynağını okuyun. Kaynakları desteklemeyen istemciler get-site-capabilities-tool kullanabilir. Keşif tamamlanana kadar tools/list nextCursor değerini izleyin.

eyivo://guides/content-workflow
eyivo://sites/{site_id}/capabilities

İstenen dili ve güncel version veya revision değerini kullanın. Blog kaydı belgenin tamamını değiştirir ve zamanlamasını iptal eder. Menü düzenlemeleri sayısal revision, içerik atamaları ayrı bir menu_revision özeti kullanır. Değiştirilen dizilerdeki mevcut öğeleri koruyun. Çakışmada yeniden okuyup değişiklikleri birleştirin.

Ana gezinme otomatik kalır. Ek menülerin taslakları ve yayınları ayrıdır. İçerik kaydı menü atamalarını hazırlar; ilgili içeriği yayınlamak diğer menü taslaklarını yayınlamadan bu atamaları uygular. Menü yayınlamak bağlantılı içeriği yayınlamaz. Sayfadaki source_hash eski kaynak metne dayanan çevirileri reddeder.

Sayfa gövdesi ve temanın richtext alanları temizlenmiş HTML kabul eder. Yayınlandığında ziyaretçinin dilinde çözümlenen kalıcı /__eyivo/pages/{id} bağlantıları için list-page-links-tool kullanın. Bloglar body_html yerine aynı siteye ait media_id ve sayfa/yazı hedefleri içeren yapılandırılmış document JSON kullanır.

{
  "type": "doc",
  "content": [{
    "type": "paragraph",
    "content": [{ "type": "text", "text": "Our story" }]
  }]
}

Görsel ve video yükleme

upload-media-tool, Claude gibi MCP Apps istemcilerinde dosya seçici açar. ChatGPT ayrıca kendi ek referansını sağlayabilir; Claude sohbet eki OpenAI dosya referansı değildir. İndirme adresi uydurmayın ve araç argümanlarında base64 dosya göndermeyin.

Codex ve Claude Code, prepare-media-upload-tool çağırıp dosyayı beş dakika içinde dönen upload_url adresine tek kullanımlık upload_token ile multipart olarak gönderebilir. Bu anahtarı gizli tutun. REST istemcileri kendi media:write anahtarlarını kullanabilir. İçerikte kullanılacak medya kimliği yalnızca tamamlanan yüklemede döner; bilet oluşturmak dosyayı yüklemez.

POST /api/v1/sites/{site}/media
Authorization: Bearer <media:write token>
Content-Type: multipart/form-data; boundary=<generated by HTTP client>

file: <original file bytes>

Örnek araç çağrısı

{
  "name": "create-page-tool",
  "arguments": {
    "site_id": 42,
    "type": "page",
    "locale": "en",
    "slug": "our-story",
    "title": "Our story",
    "body": "<p>How the company began.</p>"
  }
}

İçerik işlemleri data zarfı döndürür. MCP, structuredContent ve aynı JSON’un metin kopyasını; REST ise JSON döndürür. Kimlik, yayın hazırlığı ve sayfalama için çıktı şemasını okuyun. Blog, medya ve gönderim listelerinde dönen sayfa bilgilerini izleyin.

7. Önerilen iş akışları

Ajan talimat şablonu

Use Eyivo tools only for the site ID I confirm.
Preserve existing array entries and use current revision tokens.
Read capabilities and the current locale draft before editing.
Publish the affected item only when I want the change live.
Return the affected resource ID after a successful write.

Taslağı kaydedin, yayın hazırlığını kontrol edin ve kullanıcı değişikliği yayına almak istediğinde ilgili öğeyi ve dili yayınlayın. Diğer taslaklar yayınlanmaz.

8. Yanıtlar ve hatalar

İçerik işlemleri data zarfı döndürür. MCP, structuredContent ve aynı JSON’un metin kopyasını; REST ise JSON döndürür. Kimlik, yayın hazırlığı ve sayfalama için çıktı şemasını okuyun. Blog, medya ve gönderim listelerinde dönen sayfa bilgilerini izleyin.

Araç hataları, HTTP başarılı olsa bile isError: true ve Error: ile başlayan metin döndürür. Eksik araç izinleri için sonuçtaki _meta["mcp/www_authenticate"] alanında OAuth bildirimi bulunur. Bağlantıyı gerekli izinle yeniden yetkilendirin; mevcut token izinleri kendiliğinden genişlemez.

Sürüm çakışmasında veriyi yeniden okuyup değişiklikleri birleştirin. Eski isteği değiştirmeden tekrar göndermeyin.

9. Üretim güvenliği

• Yalnızca https://app.eyivo.com/mcp adresini kullanın; kimlik bilgilerini hiçbir zaman kiracı alan adına veya üçüncü taraf proxy sunucusuna göndermeyin.
• Kişisel belirteçleri kaynak kodunda veya istemlerde tutmayın; istemcinin güvenli saklama alanında ya da ortam yapılandırmasında saklayın.
• Yalnızca seçilen araçların ihtiyaç duyduğu kapsamları verin ve tek siteli aracılar için siteyle sınırlı belirteçleri tercih edin.
• Yazma işlemlerinde kullanıcının yetkilendirmesini esas alın; yayınlama ve silme etkilerini işlemden önce açıklayın.
• Araç çıktısını, sistem politikanızı geçersiz kılabilecek güvenilir talimatlar olarak değil, veri olarak değerlendirin.
• Kullanmadığınız kişisel belirteçleri API Belirteçleri sayfasından, OAuth istemcilerini ise Bağlı Uygulamalar sayfasından iptal edin.
• İçerik olarak parolaları, depolama kimlik bilgilerini, özel anahtarları veya ilgisiz kişisel verileri göndermeyin.

10. Mevcut sınırlar

Yalnızca keşfedilen araçları ve belgelenen uç noktaları kullanın. Yetkiler, site yalıtımı, plan sınırları ve yayın kuralları geçerlidir. Okuma yetkisi değişiklik yapma yetkisi vermez.