Model Context Protocol · Geliştiriciler

ADA AI'ı kendi araçlarına bağla (MCP)

MCP (Model Context Protocol), yapay zekâ asistanlarının ve geliştirme araçlarının dış hizmetlerle konuşmasını sağlayan açık bir standart. ADA AI'ın MCP sunucusunu bağladığında, kullandığın asistandan ya da kod editöründen ADA AI ekibine görev verebilir, görevin durumunu takip edebilir ve hazır raporu alabilirsin. Uygulamaya girmen gerekmez.

Neler yapabilirsin

Araç	Ne yapar	Gereken kapsam
start_task	Ekibe yeni bir görev verir. Hedefi yazarsın; istersen bağlam ve marka eklersin.	tasks:run
get_task_status	Görevin hangi aşamada olduğunu ve adımların durumunu gösterir.	tasks:read
get_task_report	Tamamlanan görevin raporunu Markdown olarak getirir.	tasks:read
run_specialist	Tek bir uzmana doğrudan soru sorar ya da kısa bir iş verir.	specialists:run
list_brands	Hesabındaki marka profillerini listeler; görev verirken markayı seçmek için.	brands:read

Bağlanmak için

Hesap ayarları → MCP Erişim Anahtarları bölümüne git.
Yeni anahtar oluştur'a bas, anahtara bir ad ver (örneğin "Laptop · Claude Code") ve ihtiyacın olan kapsamları seç. Yalnızca kullanacağın kapsamları seçmeni öneririz.
Anahtar yalnızca bir kez gösterilir. Hemen kopyala ve güvenli bir yere kaydet.
MCP istemcinde yeni bir HTTP sunucusu ekle:
Adres: https://api.getadaai.com/api/v1/mcp
Başlık: Authorization: Bearer <ANAHTARIN>

Örnek, Claude Code:

claude mcp add --transport http ada-ai https://api.getadaai.com/api/v1/mcp --header "Authorization: Bearer <ANAHTARIN>"

Örnek, run_specialist çağrısı (uzman slug'ı):

{
  "name": "run_specialist",
  "arguments": {
    "specialist": "copywriter",
    "prompt": "Yeni ürünüm için kısa bir lansman e-postası yaz."
  }
}

Not: specialist alanı uzman slug'ı (key) alır (örn. copywriter, strategy, seo, analytics, metin-yazari, pazarlama-stratejisti).

Başka bir istemci kullanıyorsan 'HTTP sunucusu' ya da 'uzak MCP sunucusu' ekleme adımı için o istemcinin belgesine bak. Yalnızca OAuth ile bağlanan istemciler şimdilik desteklenmiyor.

Bilmen gerekenler

01.Hesabının kuralları aynen geçerli

MCP üzerinden verdiğin görevler planının görev hakkından düşer; günlük sınırlar ve hız sınırları uygulamadakiyle aynıdır.

02.Onay gerektiren işlemler yine onay bekler

Bir görev Drive'a belge oluşturmak ya da e-posta göndermek gibi bir işlem önerirse, bu işlem MCP'den onaylanamaz. Onay kartı ADA AI'da çıkar; sen onaylayana kadar hiçbir şey yapılmaz.

03.Yalnızca kendi verine erişirsin

Oluşturduğun erişim anahtarı yalnızca senin görevlerini, raporlarını ve markalarını görür; hesaplar arası veri sızıntısı engellenmiştir.

04.Anahtarını paylaşma

Anahtarı olan herkes, seçtiğin kapsamlarda senin adına işlem yapabilir. Bir cihazı kaybedersen ya da anahtarın sızdığından şüphelenirsen, aynı sayfadan hemen iptal et. İptal edilen anahtar anında çalışmaz hale gelir.

05.Anahtarlar şifrelenmiş olarak saklanır

Biz de anahtarının açık halini göremeyiz; bu yüzden kaybedersen yenisini oluşturman gerekir.

Sorularınız veya geri bildiriminiz mi var?

MCP entegrasyonuyla ilgili soru ve önerilerin için bize ulaşabilirsin: [email protected]