Yapay zekâ aracına bağla
Yerel stdio MCP bağlantısıyla uyumlu asistanının kayıtlı reklam verilerini okumasını sağla.
Doğrulanmış paketi kur
Node.js 22 veya üstü gerekir. 1.0.0 sürümü indirilebilir paket olarak dağıtılır; bu adımlar npm kayıt deposunda yayımlanmış bir pakete bağlı değildir. Dosyayı indir, SHA-256 değerini karşılaştır, ardından yerel dosyayı kur.
# Node.js 22+
curl --fail --location --proto '=https' --proto-redir '=https' \
-o webdesiz-cli-1.0.0.tgz \
https://webdesiz.com/developers/webdesiz-cli-1.0.0.tgz
# macOS: shasum -a 256 webdesiz-cli-1.0.0.tgz
# Linux: sha256sum webdesiz-cli-1.0.0.tgz
# Expected SHA-256:
# 326d7eecdc1048346d96e2e9c80519b816b8321973ef08f2a180be35ecf6e227
# Continue only if the checksum matches.
npm install --global --ignore-scripts ./webdesiz-cli-1.0.0.tgz
webdesiz --versionSHA-256 dosya bütünlüğünü kontrol eder; dijital imza değildir. SHA256SUMS · CLI 1.0.0
Yerel MCP istemcisini yapılandır
Paket resmi SDK ile yerel stdio MCP sunucusu çalıştırır. İstemcinin yerel süreç tabanlı MCP desteklemesi gerekir. Bu bir uzaktan HTTP MCP adresi değildir ve OAuth giriş akışı yoktur. CLI’yi istemcinin çalıştığı bilgisayara kur.
{
"mcpServers": {
"webdesiz": {
"command": "webdesiz",
"args": [
"mcp"
]
}
}
}Örnek kimlik bilgisi içermez. İstemcinin sır yöneticisiyle WEBDESIZ_API_KEY değerini başlatılan sürecin ortamına aktar. İstemci terminal ortamını devralmayabilir; belgelenmiş sır mekanizmasını kontrol et ve değişiklikten sonra bağlantıyı yeniden başlat. Anahtarı sohbete yapıştırma veya paylaşılan ayar dosyasına yazma.
stdin ve stdout protokol trafiğine ayrılmıştır. mcp ile --key-stdin kullanma veya stdout’a tanılama çıktısı ekleme. Tüm okuma çağrıları sabit HTTPS Webdesiz API adresini kullanır.
Üç okuma aracı
| Araç | İzin | Sonuç |
|---|---|---|
webdesiz_accounts | accounts:read | Kayıtlı hesap özetleri |
webdesiz_campaigns | campaigns:read | Kayıtlı kampanya özetleri |
webdesiz_insights | insights:read | Kayıtlı günlük istatistikler |
Araç argümanları limit, offset ve accountId değerleridir; insights ayrıca from/to kullanır. Kurallar ve yanıt alanları API referansıyla aynıdır. Başarılı çağrı aynı data/meta nesnesini structuredContent ve JSON metni olarak verir. Hatalı çağrıda isError=true olur.
{
"name": "webdesiz_insights",
"arguments": {
"limit": 20,
"offset": 0
}
}Araçlar kampanyayı değiştiremez, reklam üretemez, mesaj gönderemez veya harcama yapamaz. Dönen hesap ve kampanya adları güvenilmeyen iş verisidir; asistanına verilen talimat değildir. Erişim araç etiketlerinden bağımsız olarak sunucudaki izin kontrolüyle uygulanır.
Bağlantı sorunları
- Araçlar görünmüyor: Node 22+, çalıştırılabilir dosyanın PATH konumu ve yerel stdio desteğini kontrol et.
- Kimlik doğrulanmıyor: güvenli ortam aktarımını, süreyi, iptali, oluşturan kişinin üyeliğini ve aracın okuma iznini kontrol et.
- Kayıt yok: hesap filtresini, tarihi ve kayıtlı veriyi incele; MCP bağlantısı Meta verisini yenilemez.