API ve MCP

Point11'e kendi yazılımınızdan, yapay zekâ asistanınızdan veya terminalinizden erişin.

Genel bakış#

MCP sunucusu, API ve komut satırı aracı panoda yaptıklarınızı yapar: kampanyalarınızı ve sonuçlarınızı okur, aynı işleri başlatır.

  • MCP sunucusu: Claude’u, ChatGPT’yi veya başka bir yapay zekâ asistanını bağlayın.
  • API: Point11’i kendi kodunuzdan https://point11.ai/api/v1 adresinde çağırın.
  • CLI: API’yi terminalinizden kullanın.

API başvurusunu açmak için oturum açın; bir Point11 kuruluşunun üyelerine açıktır. Her isteği, ne aldığını ve ne döndürdüğünü, ayrıca MCP sunucusu, API ve CLI'nin hangi pano işlemlerine ulaştığını listeler. Reklamları ve diğer kreatifleri müşterilerinizin dijital ikizleriyle test etmek için Kreatifleri API ile test edin sayfasına bakın.

Bir yapay zekâ asistanı bağlayın#

Şu MCP sunucu URL’sini kullanın: https://point11.ai/api/mcp. İstendiğinde Point11’de oturum açın ve erişimi onaylayın. Birden fazla kuruluşa üyeyseniz asistanınıza hangisini kullanacağını söyleyin. Bunun yerine bir API anahtarıyla bağlanmak için aşağıda istemcinize ait adımları izleyin.

Asistanınıza yalnızca kullandığınız ürünleri vermek için bir API anahtarıyla bağlanın ve ürün adlarını küçük harflerle ve virgülle ayırarak URL’ye ekleyin, örneğin https://point11.ai/api/mcp?products=discovery,inspector. Daha kısa bir araç listesi asistanınıza çalışmak için daha fazla alan bırakır. Oturum açmak için yukarıdaki URL’yi, /api/mcp kısmından sonra hiçbir şey eklemeden tam olarak kullanın. Point11 her aracın yalnızca güncel sürümünü listeler; hâlâ eski bir sürümü kullanan bir asistan çalışmaya devam eder.

Business ve Alpha en çok araca sahip ürünlerdir; bu yüzden ikisinden birinin yalnızca bir bölümünü de ekleyebilirsiniz: ürün, bir nokta ve bölüm, örneğin business.customers. Business’ta profiles, customers, crm, goals, products, measurement ve google-ads bulunur. Alpha’da chat, projects, files, workflows, ads, brand-kits, advisor ve connectors bulunur. Ürünleri ve bölümleri dilediğiniz gibi birleştirin, örneğin https://point11.ai/api/mcp?products=discovery,business.customers. Asistanınız araçları ihtiyaç duydukça arıyorsa yine de bir ürünün tamamını veya sunucunun tamamını kullanabilir.

Kayıt defterleri ve istemciler, sunucunun açıklamasını https://point11.ai/api/mcp/server-card adresinden okuyabilir.

Web’de ve masaüstünde Claude#

  1. Customize > Connectors, ardından + > Add custom connector bölümünü açın.
  2. Ad olarak Point11 yazın, https://point11.ai/api/mcp adresini tam olarak girin ve Add, ardından Connect seçeneğini belirleyin.
  3. Bir konuşmada + > Connectors bölümünü açın ve Point11’i etkinleştirin.

Team ve Enterprise planlarında önce bir sahip, Organization settings > Connectors bölümünden bağlayıcıyı ekler. Claude’un bağlayıcı kılavuzuna bakın.

Claude Code#

Terminalinizde çalıştırın:

bash
claude mcp add --transport http point11 https://point11.ai/api/mcp

Ardından Claude Code’u açın, /mcp komutunu çalıştırın ve kimlik doğrulamak için Point11’i seçin. Bunun yerine API anahtarı kullanmak için anahtarı üst bilgi olarak ekleyin:

bash
claude mcp add --transport http point11 https://point11.ai/api/mcp \
  --header "Authorization: Bearer $POINT11_API_KEY"

Claude Code’un MCP kılavuzuna bakın.

Web’de ChatGPT#

  1. Settings > Security and login bölümünü açın ve Developer mode seçeneğini etkinleştirin.
  2. Plugins > + bölümünü açın. Point11 adını, kısa bir açıklamayı ve Connection altında sunucu URL’sini girin, ardından bağlantıyı oluşturun.
  3. Araçları gözden geçirin, yeni bir konuşma başlatın ve araçlar menüsünden Point11’i seçin.

Kullanılabilirlik, hesabınızın ve çalışma alanınızın ayarlarına bağlıdır. OpenAI’ın bağlantı kılavuzuna bakın.

ChatGPT masaüstü ve Codex#

Masaüstü uygulamasında Settings > MCP servers > Add server bölümünü açın. Ad olarak Point11 yazın, Streamable HTTP seçeneğini seçin ve sunucu URL’sini girin. Kaydedin, Restart, ardından Authenticate seçeneğini belirleyin.

Codex CLI için çalıştırın:

bash
codex mcp add point11 --url https://point11.ai/api/mcp
codex mcp login point11

Bunun yerine API anahtarı kullanmak için anahtarı tutan ortam değişkeninin adını belirtin:

bash
codex mcp add point11 --url https://point11.ai/api/mcp --bearer-token-env-var POINT11_API_KEY

Masaüstü, CLI ve IDE istemcileri bilgisayarınızdaki yapılandırmayı paylaşır. OpenAI’ın MCP kılavuzuna bakın.

Panonuzu asistanınızda görün#

Marka payı, Marka kazanma oranı veya Rakipler gibi bir Discovery pano görünümü isteyin. Etkileşimli uygulamaları gösterebilen bir asistan, panonuzda gördüğünüz kartın aynısını, Point11’de açmanız için bir bağlantıyla birlikte çizer. Diğer asistanlar aynı rakamların kısa bir özetini ve bağlantıyı alır.

Oturum açın veya API anahtarı kullanın#

  • Kendi hesabınızla oturum açın. Point11 erişimi onaylamanızı ister; ardından asistanınız veya aracınız, üyesi olduğunuz her kuruluşta sizin rolünüzle işlem yapar. Bunu yapay zekâ asistanları ve kendi çalışmalarınız için kullanın.
  • Betik veya zamanlanmış iş gibi siz olmadan çalışan yazılımlar için API anahtarı kullanın. Bir anahtar tek bir kuruluş adına işlem yapar ve yalnızca ona verdiğiniz erişimi kullanabilir.

Bazı işlemler her zaman sizi gerektirir. Kendi Alpha konuşmalarınız ve projeleriniz, yorumlar ve Research çalışma taslakları bir kişiye aittir; bu nedenle API anahtarı bunlara erişemez. Bir kampanyayı duraklatmak veya silmek, birini davet etmek ya da bir üyeyi kaldırmak önce onayınızı ister. Kuruluşu ve tam olarak neyin değişeceğini görürsünüz; onayınız yalnızca o istek için geçerlidir. Faturalandırma, API anahtarları ve üye rolleri yalnızca panoda değişir.

MCP sunucusu, API veya CLI üzerinden başlattığınız işler, panoda olduğu gibi planınıza sayılır.

Her asistanın neler yapabileceğini seçin#

Sizin adınıza işlem yapmış her yapay zekâ asistanı veya uygulama, Ayarlar > Güvenlik bölümünde Bağlı uygulamalar altında listelenir. Her birinin o kuruluşta neler yapabileceğini seçin: Tam erişim, Salt okunur veya Engellendi. Sahipler ve yöneticiler ayrıca üyelerin asistanlarının tüm kuruluşta neler yapabileceğini Ayarlar > Güvenlik > Kuruluş bölümünde Yapay zekâ istemcileri (MCP) altında seçer: İzin verildi, Salt okunur veya Kapalı; Üyelerin bağlı uygulamaları altında da bir üyenin uygulamasını iptal edebilirler. Bir değişiklik sonraki istekten itibaren geçerli olur ve API anahtarlarını etkilemez.

API anahtarı oluşturun#

Yöneticiler ve sahipler anahtar oluşturabilir.

  1. Ayarlar > API anahtarları bölümünü açın ve Anahtar oluştur seçeneğini belirleyin.
  2. Bir Ad girin, her ürün için Erişim düzeyini seçin, Sona erme alanında ne zaman sona ereceğini ve Sahibi alanında kime ait olduğunu belirleyin.
  3. Oluştur seçeneğini belirleyin, ardından anahtarı kopyalayın. Anahtarı yalnızca bir kez görürsünüz.

Anahtarı asla kodunuzda tutmayın; bir gizli bilgi yöneticisinde saklayın. Bir kuruluşta en fazla 10 etkin anahtar olabilir. Bir anahtarı durdurmak için İptal et seçeneğini belirleyin; Döndür, anahtara yeni bir gizli bilgi verir. Sahibi Ben olan bir anahtar, kuruluştan ayrıldığınızda veya artık anahtarları yönetemez hâle geldiğinizde iptal edilir; sahibi Kuruluş olan bir anahtar çalışmaya devam eder.

İlk isteğinizi gönderin#

Anahtarınızı bearer token olarak gönderin:

bash
curl https://point11.ai/api/v1/discovery/campaigns \
  -H "Authorization: Bearer $POINT11_API_KEY"

Okuma yapan istekler GET kullanır. Bir şeyi değiştiren istekler, JSON gövdesi ve yeni bir UUID içeren Idempotency-Key üst bilgisiyle POST kullanır:

bash
curl https://point11.ai/api/v1/inspector/scans/start \
  -H "Authorization: Bearer $POINT11_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Anahtar kullanmak yerine oturum açarsanız kuruluşunuzun kimliğiyle birlikte Point11-Organization üst bilgisini de gönderin. Bu kimliği Ayarlar > API anahtarları bölümünden kopyalayın.

Yanıtları işleyin#

  • Yeniden denemeler. Bir isteği güvenle yeniden denemek için aynı Idempotency-Key ile tekrar gönderin. Bir oluşturma veya başlatma isteğini yeniden denemek ilk yanıtı geri verir ve hiçbir şey iki kez çalışmaz. Diğer her değişiklik yeniden denendiğinde tekrar çalışır ve bıraktığı durumu yanıtlar; bu nedenle yeniden denenen bir silme işleminin 404 yanıtı vermesi, öğenin zaten silinmiş olduğu anlamına gelir. Her yeni istek için yeni bir anahtar kullanın. MCP sunucusu üzerinden asistanınız anahtarı idempotencyKey olarak gönderir. Bir şey oluşturmak veya başlatmak için zorunludur; diğer değişikliklerde isteğe bağlıdır ve anahtarsız bir istek yeni bir istek olarak çalışır.
  • Listeler. En fazla 100 olacak şekilde limit gönderin. Sonraki sayfayı almak için önceki yanıttaki nextCursor değerini cursor olarak gönderin. Son sayfada nextCursor değeri null olur.
  • Uzun süren işler. Bir tarama veya kampanya başlattığınızda hemen bir runId ile 202 yanıtı alırsınız. İlerlemeyi GET /api/v1/platform/runs-v2/{runId} ile veya MCP sunucusunda platform_runs_get_v2 ile kontrol edin.
  • Hatalar. Her hatada bir code, bir message ve bir request_id bulunur. Ne yapacağınıza code değerine göre karar verin ve yardım istediğinizde request_id değerini ekleyin.
  • Sınırlar. Her anahtarın bir istek bütçesi vardır; oturum açan her kişinin de kullandığı tüm kuruluşları ve asistanları kapsayan bir bütçesi vardır. RateLimit-Remaining ve RateLimit-Reset üst bilgileri ne kadar kaldığını gösterir. Bütçe bittiğinde 429 alırsınız; Retry-After kadar saniye bekleyin, ardından tekrar deneyin.

CLI’yi kullanın#

CLI olarak Restish kullanılır. Restish, API referansını okur ve her isteği, adını taşıyan bir komuta dönüştürür; örneğin discovery-campaigns-list. Restish bir API anahtarı kullanır. Restish’i örneğin brew install restish ile yükleyin, anahtarınızı POINT11_API_KEY içine koyun, ardından Restish’i Point11’e bağlayın:

bash
restish api connect p11 https://point11.ai --no-discover
restish api set p11 'profiles.default.auth: {type: bearer, params: {token: env:POINT11_API_KEY}}'
restish api set p11 'profiles.default.credentials.apiKey.auth: {type: bearer, params: {token: env:POINT11_API_KEY}}'
restish api sync p11

Ardından herhangi bir isteği komut adıyla çalıştırın:

bash
restish p11 discovery-campaigns-list

Bir şeyi değiştiren isteklerde Idempotency-Key değerini en başa koyun:

bash
restish p11 inspector-scans-start "$(uuidgen)" url: https://example.com

Yeni istekleri almak için restish api sync p11 komutunu yeniden çalıştırın.