Ajanlar ve MCP
TweetAPI'yi yapay zeka kodlama ajanlarıyla iki şekilde kullanabilirsiniz: güncel dokümantasyon ve salt okunur API erişimi için barındırılan MCP; ajan TweetAPI'yi uygulamanıza entegre ederken ise normal SDK veya sunucu tarafı kod.
Ürünün genel tanıtımı, gereksinimler ve bağlantı adımları için TweetAPI Twitter API MCP sunucusu sayfasına bakın.
Barındırılan MCP
Ajan istemcinizi şu adrese bağlayın:
https://mcp.tweetapi.com/mcp
Barındırılan MCP, panel üzerinden yetkilendirme kullanır. MCP sunucusunu eklemek yalnızca sunucu yapılandırmasını ajan istemcinize kaydeder. TweetAPI'yi tarayıcıda açmak için istemcinin MCP giriş/yetkilendirme komutunu çalıştırın, bağlantıda kullanılacak API anahtarını seçin ve tweetapi:read iznini onaylayın. İstemci MCP token'larını sakladığı için uygulamayı veya bilgisayarı yeniden başlatsanız da bağlantı korunur.
Canlı MCP araçları salt okunurdur ve müşterilere açık, herkese açık endpoint'lerle sınırlıdır. Her canlı araç çağrısı mevcut TweetAPI API'sine iletilir ve normal API kotanızdan düşer.
Hızlı kurulum
Codex için şunu çalıştırın:
codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi
Claude Code için şunu çalıştırın:
claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi
Cursor için şunu ~/.cursor/mcp.json dosyasına ekleyin:
{
"mcpServers": {
"tweetapi": {
"url": "https://mcp.tweetapi.com/mcp"
}
}
}
Codex ve Claude Code komutlarını ayrı ayrı çalıştırın. Ekleme/kurulum komutu tarayıcıyı kendiliğinden açmaz. Giriş/yetkilendirme komutu TweetAPI'yi açar; böylece giriş yapabilir, MCP bağlantısında kullanılacak API anahtarını seçebilir ve erişimi onaylayabilirsiniz. Cursor, kayıtlı uzak sunucuya ilk bağlandığında OAuth'u başlatır.
Neler yapabilirsiniz?
- Güncel TweetAPI dokümantasyonunda arama yapın.
- Kod yazmadan önce endpoint parametrelerine bakın.
- Ajanınızın sohbetinden canlı, salt okunur X/Twitter sorguları çalıştırın.
- Normal TweetAPI kotanızı ve faturalandırmanızı kullanın.
Gereksinimler
- Bir TweetAPI hesabı.
- Panelde onay sırasında seçilen bir TweetAPI API anahtarı.
- Codex, Claude Code veya uzak HTTP MCP destekleyen başka bir ajan istemcisi.
Codex'e kurulum
Şunu çalıştırın:
codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi
Komutları tek tek çalıştırın. İlk komut MCP sunucusunu ekler. İkinci komut, MCP erişimini onaylamanız için TweetAPI'yi açar. Mevcut bir API anahtarını seçin veya panelde MCP'ye özel bir anahtar oluşturun. Ekleyip giriş yaptıktan sonra Codex'i yeniden başlatın veya yeni bir sohbet açın. Codex'te /mcp komutunu çalıştırın ya da modelden TweetAPI MCP araçlarını listelemesini isteyin.
Panelden bağlantıyı iptal ederseniz veya bağlantının kullandığı API anahtarını silerseniz, yeniden bağlanmadan önce istemcideki eski oturumu temizleyin:
codex mcp logout tweetapi
codex mcp login tweetapi
Ardından Codex'i tamamen yeniden başlatın ve yeni bir sohbet açın.
Claude Code'a kurulum
Şunu çalıştırın:
claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi
Komutları tek tek çalıştırın. İlk komut MCP sunucusunu ekler. İkinci komut TweetAPI panelindeki onay ekranını açar. Token veya API anahtarı içeren ajan yapılandırma dosyalarını sürüm kontrolüne göndermeyin.
Panelden bağlantıyı iptal ederseniz Claude Code'da kayıtlı TweetAPI MCP yetkilendirmesini/oturumunu kaldırın ve claude mcp login tweetapi komutunu yeniden çalıştırın.
Cursor'a kurulum
TweetAPI'yi Cursor'ın ~/.cursor/mcp.json dosyasındaki genel MCP yapılandırmasına ekleyin:
{
"mcpServers": {
"tweetapi": {
"url": "https://mcp.tweetapi.com/mcp"
}
}
}
Cursor yeni sunucuyu hemen algılamazsa yeniden başlatın. Cursor bağlandığında, tarayıcınızda TweetAPI OAuth onayını tamamlayın ve bağlantıda kullanılacak API anahtarını seçin.
Bağlantıyı test edin
MCP'yi kurduktan sonra yeni bir sohbet açıp şunu sorun:
Kullanabileceğin TweetAPI MCP araçlarını listele. Ardından TweetAPI dokümantasyonunda arama
endpoint'ini bul ve zorunlu parametrelerini açıkla. Henüz canlı TweetAPI araçlarından hiçbirini
çağırma.
Canlı salt okunur erişimi test etmek için şunu sorun:
TweetAPI MCP ile "elonmusk" kullanıcı adının herkese açık profilini getir. Tam olarak bir canlı
araç çağrısı yap ve hangi aracı kullandığını göster.
Canlı araç çağrıları normal TweetAPI istek kotanızdan düşer.
MCP ne zaman kullanılır?
Model sohbet sırasında güncel TweetAPI dokümantasyonuna bakmak, endpoint parametrelerini öğrenmek veya sınırları belli, salt okunur TweetAPI çağrıları yapmak istediğinde barındırılan MCP'yi kullanın.
Model uygulamanızda değişiklik yapıyorsa normal SDK veya REST entegrasyon kodu kullanın. TweetAPI çağrıları sunucu tarafında çalışmalı ve API anahtarını sunucunuzun ortam değişkenlerinden okumalıdır.
Ajanınız için güvenli prompt
Bu özelliği uygulamama eklemek için TweetAPI'yi kullan. TweetAPI anahtarını sunucuda
TWEETAPI_API_KEY değişkeninden oku. API anahtarlarını, Twitter/X authToken'ını, proxy bilgilerini
veya DM içeriklerini kaynak koda koyma. Endpoint parametrelerini seçmeden önce barındırılan
TweetAPI MCP'nin dokümantasyon araçlarını kullan.
Node.js örneği
npm install tweetapi-node
import TweetAPI from "tweetapi-node";
const client = new TweetAPI({ apiKey: process.env.TWEETAPI_API_KEY! });
const result = await client.explore.search({
query: "tweetapi",
type: "Latest",
});
Python örneği
pip install tweetapi
import os
from tweetapi import TweetAPI
client = TweetAPI(api_key=os.environ["TWEETAPI_API_KEY"])
result = client.search.search(query="tweetapi", type="Latest")