DataFast MCP

MCP ile Başlarken

AI asistanınızı DataFast'a bağlayarak trafik, gelir ve özel hedefler hakkında soru sorabilir veya yetki verdiğiniz web sitesi işlemlerini yönetebilirsiniz. API erişimi olan bir DataFast hesabınızın olması gerekir.

Bağlantı Yöntemi Seçin

Bir yöntem seçin. Her ikisi de DataFast ile iletişim kurmak için Streamable HTTP kullanır.

• OAuth ile oturum açın — Codex ve Claude Code dahil OAuth oturum açma sunan istemciler için önerilir. DataFast'te web sitelerini ve izinleri seçin; istemci bağlantı belirtecini otomatik olarak yönetir. API anahtarı oluşturmanız veya kopyalamanız gerekmez.
• API belirteci kullanın — Bearer belirteci isteyen istemciler için. DataFast'te kapsamlı bir hesap belirteci oluşturun ve istemcinizin yapılandırmasına ekleyin.

Her iki yöntem de aynı DataFast araçlarını sunar. OAuth izinleri, analizleri, web sitesi yönetimini, hesap işlemlerini ve kimlik bilgisi yönetimini ayrı ayrı onaylamanıza olanak tanır. Her yöntemin destekledikleri için araç referansına bakın.

OAuth ile Bağlanma

1. DataFast'i istemcinize ekleyin

Aşağıdaki URL ile uzak bir MCP sunucusu ekleyin ve OAuth veya Oturum aç seçeneğini belirleyin.

https://datafa.st/api/mcp

Codex için sunucuyu ekleyin ve tarayıcı oturum açma işlemini tamamlayın:

codex mcp add datafast --url https://datafa.st/api/mcp

Daha sonra tekrar oturum açmak için codex mcp login datafast komutunu çalıştırın. Hem istemci meta veri belgeleri hem de dinamik kayıt desteklenir; yerel geri döngü geri çağırmaları dahil. DataFast zaten bir Bearer belirteci ile yapılandırılmışsa, OAuth'a geçmeden önce bu kimlik bilgisini istemcinin DataFast yapılandırmasından kaldırın.

Claude Code için sunucuyu ekleyin, ardından Claude Code içinde /mcp öğesini açın ve DataFast kimlik doğrulaması yapın:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. Oturum açın ve erişimi onaylayın

1. Mevcut DataFast hesabınızla datafa.st üzerinde oturum açın.
2. Bu istemcinin erişebileceği web sitelerini seçin.
3. İstenen izinleri gözden geçirin. Okuma izinleri varsayılan olarak seçilidir; istemcinin bu değişiklikleri yapmasını istiyorsanız yazma izinlerini etkinleştirin.
4. İstemcinize dönmek için Erişime izin ver seçeneğini belirleyin.

DataFast, istemciye bu bağlantı için bir erişim belirteci verir. İstemci bunu saklar ve bağlantı geçerli olduğu sürece otomatik olarak yeniler. DataFast şifreniz, kontrol paneli oturumunuz ve mevcut API anahtarlarınız istemciyle paylaşılmaz.

3. Deneyin

DataFast etkinken bir konuşma başlatın ve şunu sorun:

Kullanılabilir web sitelerimi listele, ardından web sitem için son yedi günün ziyaretçi ve gelir verilerini göster.

Devam etmeden önce web sitesini ve tarih aralığını doğrulayın. Planınız ve izinleriniz hâlâ geçerlidir.

Bağlantıyı Ayarlar → API / MCP → Bağlı uygulamalar altında yönetin veya iptal edin. DataFast sizden tekrar erişim onayı istediğinde veya farklı web siteleri ya da izinler paylaşmak istediğinizde yeniden bağlanın.

API Belirteci ile Bağlanma

İstemciniz bir API anahtarı veya Bearer belirteci istediğinde bu yöntemi kullanın. MCP için, dft_ ile başlayan bir hesap erişim belirteci ile başlayın.

1. Hesap belirteci oluşturun

1. Hesap ayarları → API / MCP bölümünü açın.
2. Yeni erişim belirteci altında, erişimi kısıtlamak için Belirli web siteleri seçeneğini veya iş akışınızın ihtiyacı buysa Tüm web siteleri seçeneğini belirleyin.
3. Yalnızca ihtiyacınız olan izinleri seçin. Bir analiz bağlantısı için Web siteleri → Okuma ve Analizler → Okuma ile başlayın, diğer tüm izinleri devre dışı bırakın.
4. Belirtece tanınabilir bir ad verin, Belirteç oluştur seçeneğini belirleyin ve dft_ değerini kopyalayın. Bu değer yalnızca bir kez gösterilir.

2. Belirteci istemcinize ekleyin

https://datafa.st/api/mcp kullanın ve belirteci bir Authorization: Bearer … başlığı olarak gönderin. Bunu istemcinin kimlik bilgisi ayarlarında veya bir ortam değişkeninde, kaynak kontrolü ve sohbet mesajlarının dışında tutun.

Codex: belirtecinizi DATAFAST_TOKEN ortam değişkeni olarak kullanılabilir yapın, ardından şunu çalıştırın:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: dft_xxx öğesini belirtecinizle değiştirin:

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: mcp.json öğesine bu girdiyi ekleyin. DATAFAST_TOKEN öğesini Cursor'un ortamında kullanılabilir yapın; Cursor ortam değişkenini genişletir bağlanırken.

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

Diğer istemciler: sunucu URL'sini ve Bearer belirtecini uzak MCP ayarlarına girin. Yalnızca yerel stdio sunucularını destekleyen istemciler için mcp-remote gibi bir köprü gerekir.

3. Deneyin ve erişimi yönetin

İstemcinizden kullanılabilir web sitelerinizi listelemesini isteyin, ardından bir web sitesi için son yedi günün ziyaretçi ve gelir verilerini isteyin.

Belirteci Hesap ayarları → API / MCP bölümündeki Erişim belirteçleriniz altında yönetin. Neler yapabileceğini değiştirmek için İzinleri düzenle, sırrını değiştirmek için Yenile veya iptal etmek için Sil seçeneğini kullanın. Bir belirteci yeniledikten sonra istemcinizdeki değeri güncelleyin.

Zaten bir df_ web sitesi API anahtarınız mı var? Genel MCP uç noktası bunları da kabul eder; erişim o web sitesine bağlıdır. Desteklediği işlemler için API kimlik doğrulamasına bakın. Ayrıca yukarıdaki Belirli web siteleri seçeneğini kullanarak bir hesap belirtecini tek bir web sitesiyle kısıtlayabilirsiniz.

Erişim Nasıl Sınırlanır

Her iki yöntem de istemciye gizli bir kimlik bilgisi verir. OAuth, onayınızın ardından bu kimlik bilgisinin verilmesini ve yenilenmesini otomatikleştirir; API belirteci ise kendinizin oluşturduğu ve yapılandırdığı bir kimlik bilgisidir.

DataFast, sunucuda kimlik bilgisini, izin verilen eylemi, web sitesi erişimini, mevcut üyeliği ve geçerli hesap veya plan kısıtlamalarını kontrol eder. Bir araç isteğindeki web sitesi kimliği, erişim kanıtı değil, kontrol edilecek bir hedeftir. Örneğin, Web Sitesi A'yı okumak için onaylanmış bir OAuth bağlantısı Web Sitesi B'yi okuyamaz veya Web Sitesi A'yı düzenleyemez.

OAuth bağlantıları yalnızca onaylanan web sitelerine erişir. Onaylanmış bir OAuth aracı aracılığıyla oluşturulan bir web sitesi bu bağlantıya eklenir; başka yerlerde eklenen web siteleri otomatik olarak paylaşılmaz. OAuth belirteçleri bir saat sonra sona erer, veriliş tarihinden itibaren en fazla 30 gün boyunca otomatik olarak yenilenir ve en fazla 90 gün sonra yeni onay gerektirir. Kontrol panelinde oluşturulan hesap belirteçleri, hesap erişiminize ve izinlerinize bağlı olarak siz yenileyene veya silene kadar geçerli kalır. OAuth aracılığıyla verilen API anahtarları ve hesap belirteçleri de orijinal bağlantının geçerli kalmasına bağlıdır.

OAuth belirteçleri yalnızca verildikleri MCP uç noktasında çalışır. Genel REST API'ye yapıştırılamaz veya DataFast kontrol paneline oturum açmak için kullanılamaz. Hesap belirteçleri ayrıca desteklenen REST API uç noktalarıyla da çalışır.

Güvenlik

• Sınırlı erişimle başlayın. İstemciye yalnızca ihtiyaç duyduğu web sitelerini ve izinleri verin. Hesap işlemleri, kimlik bilgisi yönetimi ve tam ziyaretçi ayrıntıları, varsayılan olarak kapalı olan ayrı OAuth izinleri gerektirir.
• Değişiklikleri gözden geçirin. OAuth yazma araçları onay ve bir yeniden deneme anahtarı gerektirir. API belirteci araçları, veri silme veya kimlik bilgisi verme gibi hassas işlemler için onay gerektirir. Bu kontroller istemcinin onay arayüzünü tamamlar; güvenilir bir istemci seçmenin yerini tutmaz.
• Kimlik bilgilerini gizli tutun. Her iki yöntem de Bearer belirteçleri kullanır: geçerli bir belirteç elde eden biri, süresi dolana veya iptal edilene kadar izin verilen erişimi kullanabilir. Kimlik bilgilerini asla URL'lere, kaynak kontrolüne veya sohbet mesajlarına koymayın.
• Gerektiğinde bağlantıyı kesin. Bir OAuth bağlantısını iptal etmek sonraki istekleri ve yenilemeleri engeller. Zaten çalışan bir istek tamamlanabilir ve diğer uygulamayla zaten paylaşılan veriler iptal ile silinmez.
• Yalnızca kontrol paneli işlemleri kontrol panelinde kalır. MCP web sitelerini silemez veya ödeme sağlayıcılarını bağlayamaz/bağlantısını kesemez.