--- title: "MCP Sunucusu" description: "AI aracılarını Model Bağlam Protokolü aracılığıyla Twexapi'ye bağlayın." --- # AI Aracılarını MCP aracılığıyla bağlayın Twexapi, AI aracılarının ve geliştirme araçlarının Twexapi hesabınızla programlı bir şekilde etkileşimde bulunmasına olanak tanıyan bir [Model Bağlam Protokolü](https://modelcontextprotocol.io) sunucusunu çalıştırır. Bu sayfa, kimliği doğrulanmış API eylemleri için "https://api.twexapi.io/mcp" adresindeki API MCP sunucusunu kapsar. Salt okunur belge araması için "https://docs.twexapi.io/mcp" adresindeki [Docs MCP sunucusunu](/mcp/docs-mcp) kullanın. ## Bağlantı ### Protokol MCP istemcileri için Akışlı HTTP aktarımlı HTTP. ### Uç nokta İstemcileri şuraya bağlayın: ```txt https://api.twexapi.io/mcp ``` API sunucusu hem 'https://api.twexapi.io/mcp' hem de 'https://api.twexapi.io/mcp/' kabul eder. İstemci açıkça normalleştirmediği sürece, istemci yapılandırmalarında eğik çizgi olmayan URL'yi kullanın. ### Kimlik doğrulama Çalışma alanınız için OAuth etkinleştirildiğinde "x-api-key"de bir Twexapi API anahtarı veya bir OAuth 2.1 Taşıyıcı belirteci kullanın. MCP sunucusu keşif meta verileri şu adreste mevcuttur: ```txt https://api.twexapi.io/.well-known/mcp.json ``` 'GET /.well-known/mcp.json' doğrudan MCP kayıt defteri sunucu kartı JSON'unu döndürür. 'GET /.well-known/mcp/server-card.json', iç içe geçmiş sunucu kartı yolunu okuyan istemciler için aynı kartı döndürür. Kayıt defteri kartı istemcileri, API anahtarı kimlik doğrulamasıyla "https://api.twexapi.io/mcp" için "aktarılabilir-http" uzaktan kumandası alır. Aşağıdaki doğrudan istemci örnekleri, istemci özel başlıkları desteklediğinde aynı anahtarı "x-api-key" ile gönderebilir. :::note API anahtarı istemcileri ilk istekte "x-api-key" göndermelidir. "https://api.twexapi.io/mcp"ye yönelik kimliği doğrulanmamış istekler "401"i döndürüyor. ::: ## Kimlik doğrulama MCP sunucusu şu kimlik doğrulama yöntemlerini destekler: - API anahtarı ("x-api-key" başlığı): Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode ve Claude Desktop tarafından uzak köprüler aracılığıyla kullanılır. MCP anlaşması sırasında anahtarınızı iletin. - Bearer token (`Authorization: Bearer `): Yetkilendirme başlıklarını tercih eden istemciler tarafından kullanılır. Bu, bir Twexapi API anahtarı veya OAuth etkinleştirildiğinde bir OAuth jetonu olabilir. API anahtarınızı [Twexapi kontrol panelinden](https://twexapi.io/dashboard) oluşturun. ## Nasıl çalışır? MCP sunucusu 2 araç sunar: ### `explore` Twexapi API kataloğunda arama yapın. Bu bir keşif aracıdır: uç nokta adlarını, yöntemlerini, yollarını, kategorilerini, parametre şemalarını, örnekleri ve güvenlik işaretlerini döndürür. ### `twexapi_request` Kimliği doğrulanmış Twexapi API çağrılarını yürütün. Maliyet, temeldeki son noktayı takip eder. Aracı önce "explore" ile arama yapar, ardından döndürülen yöntem ve göreceli yolla `twexapi_request`i çağırır. Kimlik doğrulama, MCP isteğinden otomatik olarak eklenir. ### `explore` aracı Bellek içi API uç nokta kataloğunda arama yapar. Çağrı hâlâ bir API anahtarı veya Taşıyıcı belirteci aracılığıyla MCP kimlik doğrulaması gerektiriyor. ```ts interface EndpointInfo { name: string; method: string; path: string; category: string; // trending, search, users, tweets, followers, engagement, communities, lists, dm, articles, timeline, accounts, write description: string; read_only: boolean; parameters_schema?: Record; example?: Record; } ``` ### `twexapi_request` aracı İzin verilenler listesindeki Twexapi REST uç noktalarına karşı API çağrılarını yürütür. ```ts declare const twexapi_request: { method: string; path: string; query?: Record; body?: unknown; }; ``` Örnek çağrı: ```json { "method": "GET", "path": "/twitter/global-trending/countries" } ``` ## MCP ve REST API karşılaştırması ### MCP Sunucusu Yapay zeka aracıları, IDE entegrasyonları ve doğal dil iş akışları için en iyisi. "X-api-key" veya Bearer auth ile "https://api.twexapi.io/mcp" adresine bağlanın. Aracılar, uç nokta araması için "explore"u ve kimliği doğrulanmış API çağrıları için `twexapi_request`i kullanır. ### REST API'si Arka uç hizmetleri, otomasyon komut dosyaları ve doğrudan programatik erişim için en iyisi. `Authorization: Bearer ` ile `https://api.twexapi.io/*` adresini çağırın. Uç noktalar, sayfalandırma, yanıt işleme veya doğrudan SDK kodu üzerinde ayrıntılı kontrole ihtiyaç duyduğunuzda API referansını kullanın. Bir aracının X/Twitter verileriyle doğal dil aracılığıyla etkileşimde bulunmasını istediğinizde MCP'yi kullanın. Bir üretim arka ucu, zamanlanmış iş veya doğrudan entegrasyon oluştururken REST'i kullanın. ## Kurulum ### Web ve terminal istemcileri - [Claude.ai](#claude-ai) - [Claude Masaüstü](#claude-masaüstü) - [Claude Kodu](#claude-kodu) - [Kodeks CLI](#codex-cli) #### Claude.ai Claude.ai, çalışma alanınız için MCP konektörleri etkinleştirildiğinde uzak MCP sunucularına bağlanabilir. Sunucu URL'si olarak `https://api.twexapi.io/mcp` kullanın. OAuth'un etkin olduğu çalışma alanları, kimlik doğrulamayı tarayıcıda tamamlayabilir; API anahtarı istemcileri "x-api-key" kullanmalıdır. #### Claude Masaüstü Claude Desktop yalnızca stdio aktarımını destekler. Köprü olarak 'mcp-remote' npm paketini kullanın: ```json { "mcpServers": { "twexapi": { "command": "npx", "args": [ "mcp-remote@latest", "https://api.twexapi.io/mcp", "--header", "x-api-key:twexapi_YOUR_KEY_HERE" ] } } } ``` #### Claude Kodu `.mcp.json` dosyanıza ekleyin: ```json { "mcpServers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### Kodeks CLI `~/.codex/config.toml` dosyasına ekleyin: ```toml [mcp_servers.twexapi] url = "https://api.twexapi.io/mcp" http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" } ``` ### Düzenleyici istemcileri - [İmleç](#imleç) - [VS Kodu](#vs-kodu) - [Rüzgar Sörfü](#Rüzgar Sörfü) - [AçıkKod](#açıkkod) #### İmleç `~/.cursor/mcp.json` (genel) veya `.cursor/mcp.json` (proje) dosyasına ekleyin: ```json { "mcpServers": { "twexapi": { "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### VS Kodu `.vscode/mcp.json` (proje) dosyasına ekleyin veya **MCP: Açık Kullanıcı Yapılandırmasını** (genel) kullanın: ```json { "servers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### Rüzgar sörfü `~/.codeium/windsurf/mcp_config.json` dosyasına ekleyin: ```json { "mcpServers": { "twexapi": { "serverUrl": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### Açık Kod 'opencode.json'a ekle: ```json { "mcp": { "twexapi": { "type": "remote", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` ### SohbetGPT ChatGPT'yi Twexapi'ye bağlamanın 3 yolu vardır: **Seçenek 1: Özel GPT** Özel bir GPT oluşturun ve API dağıtımınızdaki OpenAPI şemasını kullanarak Twexapi'yi Eylem olarak ekleyin. Kurulumunuza bağlı olarak kimlik doğrulamayı API anahtar başlığına veya Taşıyıcı belirtecine ayarlayın. **Seçenek 2: Agent SDK'sı** Bir aracı çalışma zamanından Akış Yapılabilir HTTP MCP'yi kullanın: ```python from agents.mcp import MCPServerStreamableHttp async with MCPServerStreamableHttp( url="https://api.twexapi.io/mcp", headers={"x-api-key": "twexapi_YOUR_KEY_HERE"}, params={}, ) as twexapi: # use Twexapi as a tool provider pass ``` **Seçenek 3: Geliştirici Modu** ChatGPT ortamınız MCP bağlayıcılarını desteklediğinde, uç nokta olarak "https://api.twexapi.io/mcp" ile Twexapi'yi ekleyin. OAuth'un etkin olduğu çalışma alanları, tarayıcıda kimlik doğrulamayı tamamlayabilir. ## Örnek istemler Bağlandıktan sonra AI temsilcinize aşağıdaki gibi sorular sorabilirsiniz: ### Arama ve arama - Son 24 saatteki "AI ajanları" hakkındaki son X gönderilerini arayın. Tweet kimliği, yazar, oluşturulma zamanı, beğeniler, yeniden gönderiler ve tek satırlık özet ile en iyi 20 tweet'i döndürün. - `@elonmusk`un `Grok` veya `AI`den bahseden son tweetlerini bulun. Sonuçları konuya göre gruplayın ve doğrudan X bağlantılarını ekleyin. - Bu tweet'i okuyun: `https://x.com/elonmusk/status/1803006263529541838`. Gönderiyi özetleyin, ardından en alakalı yanıtları alın ve yanıt kimliklerini gösterin. - Tweet ID '1803006263529541838' için benzer tweetler alın ve her sonucun neden ilişkili olduğunu açıklayın. ### Kullanıcı profilleri ve takipler - `@openai` profil biyografisini okuyun ve kullanıcı adını, görünen adı, kullanıcı kimliğini, konumu, takipçi sayısını ve profil URL'sini döndürün. - "Yapay zeka altyapısı" için X kullanıcısını arayın. Kullanıcı adı, biyografisi, takipçi sayısı ve neden eşleştiklerini içeren 25 hesabı döndürün. - `@elonmusk` için en son takipçileri alın, ardından hangi hesapların biyografilerinde yapay zekadan, girişimlerden veya kriptodan bahsettiğini belirleyin. - '@sama' için imleçle sayfalandırılmış bir takipçi sayfası çekin, ilk 20 kullanıcıyı döndürün ve sonraki çalıştırma için 'next_cursor'u koruyun. - '44196397', 'elonmusk' ve 'openai' hesaplarının doğrulanmış veya kuruluşa bağlı olup olmadığını kontrol edin. ### Trendler - Desteklenen tüm küresel trend ülkelerini gösterin, ardından "Amerika Birleşik Devletleri" için en önemli trend konularını getirin. - Konusu 'teknoloji' ve içerik etiketi 'AI' olan 'Amerika Birleşik Devletleri' için trend olan tweet'leri getirin. Tweet kimliklerini, yazarları ve etkileşim ölçümlerini döndürün. - Bugün Amerika Birleşik Devletleri'nde "AI", "Bitcoin" veya "Grok"un trend olup olmadığını kontrol edin. Geri dönen tweetlerdeki kanıtları açıklayın. - "Amerika Birleşik Devletleri", "Japonya" ve "Birleşik Krallık" için trend olan konuları karşılaştırın ve bölgeye göre nelerin farklı olduğunu özetleyin. ### Ekstraksiyonlar - "https://x.com/elonmusk/status/1803006263529541838" adresine verilen yanıtları alın, alaka düzeyine göre sıralayın ve yanıt kimliğini, yazarı, metni ve beğeni sayısını döndürün. - '1803006263529541838' tweet kimliğini retweetleyen 50 kullanıcıyı listeleyin. Varsa kullanıcı kimliğini, kullanıcı adını, görünen adı ve takipçi sayısını döndürün. - Get quote tweets for tweet ID `1803006263529541838`, then classify quotes as supportive, critical, or neutral. - '1803006263529541838' tweet ID'sinin tamamını çıkarın ve Markdown taslağına dönüştürün. - Get all tweets and replies for `@elonmusk` with a count of `20`, then separate original posts from replies. ### Makaleler - X makalesi '1803006263529541838'i Markdown olarak getirin ve 5 maddelik yönetici özetine dönüştürün. - '1803006263529541838' ve '1803006263529541839' kimliklerine sahip X makalelerini toplu getir; başlığı, yazarı, yayınlanma zamanını ve özeti döndürür. - Bu X makalesini Markdown olarak okuyun, tüm bağlantıları çıkarın ve bülten tarzında temiz bir özet oluşturun. ### Topluluklar ve listeler - X topluluklarında "Yapay zeka geliştiricileri"ni arayın. Topluluk kimliğini, adını, üye sayısını ve açıklamasını döndürün. - Tweet türü 'En Son' ve hedef sayısı '20' olan topluluk kimliği '1234567890123456789'dan en son tweet'leri alın. - 'Yapay zeka kurucuları' için arama listeleri. Liste kimliği, ad, açıklama ve üye sayısıyla birlikte ilk 10 listeyi döndürün. - '987654321098765432' numaralı listeden üyeleri alın, sonraki imleci dahil edin ve sonucu bir potansiyel müşteri tablosu olarak biçimlendirin. ### X yazma eylemleri - Şöyle bir tweet yayınlayın: 'Twexapi entegrasyonumuzun v2.0'ını az önce gönderdim. MCP kurulumu artık 2 dakikadan az sürüyor.` - '1803006263529541838' tweet kimliğine şu şekilde yanıt verin: 'Bu yararlı bir örnek. Twexapi MCP aracılığıyla test ettim.` - Resim URL'si 'https://example.com/launch.png' olan ve şu metni içeren bir tweet oluşturun: 'Yeni lansman: Twexapi MCP artık aracı iş akışlarını destekliyor.' - 'https://x.com/elonmusk/status/1803006263529541838' adresine kısa ve teknik bir tarzda bir yanıt taslağı hazırlayın ancak göndermeyin. :::warning Yazma eylemleri 'salt okunur: yanlış' olarak işaretlenir. Gönderi göndermeden, yanıtlamadan, takip etmeden, engellemeden veya yan etki yaratan başka bir eylem gerçekleştirmeden önce açık kullanıcı onayı isteyin. ::: ### Hesap ve kullanım - MCP isteğimin "/twitter/global-trending/tweets"e neden "401" döndürdüğünü açıklayın ve kontrol etmem gereken başlıkları listeleyin. - MCP isteğimin neden '403 Kullanılabilir kredi yok!' döndürdüğünü ve yeniden denemeden önce ne yapmam gerektiğini açıklayın. - Yüksek hacimli takipçi çıkarma işleminin neden '429' döndürdüğünü açıklayın, ardından yeniden deneme ve sayfalandırma planı önerin. - Bu görevin MCP'yi mi yoksa doğrudan REST'i mi kullanacağına karar verin: 'her sabah @openai için 10.000 takipçi çekin ve bunları veritabanımda saklayın'. ## Çerçeve kılavuzları Tercih ettiğiniz çerçevede Twexapi MCP araçlarıyla aracılar oluşturun: Twexapi MCP araçlarını LangChain ve LangGraph aracılarına bağlayın. Bir Twexapi MCP bağlantısını paylaşan araştırma ekipleri oluşturun. Streamable HTTP MCP araçlarıyla tür uyumlu aracılar kullanın. Gemini destekli ADK aracılarına Twexapi araçlarını ekleyin. TypeScript aracılarını uzak Twexapi MCP araçlarına bağlayın. Temsilci çıktılarını n8n, Zapier, Make ve Pipedream'e aktarın. ## Yapay zeka ajanı becerisi Twexapi becerisi, AI kodlama aracılarına MCP bağlantısı gerektirmeden Twexapi API'si hakkında derin bilgi sağlar. Temsilcinizin API entegrasyonları yazmasına, MCP bağlantılarını yapılandırmasına ve Twexapi en iyi uygulamalarını kullanmasına olanak sağlamak için bunu yükleyin. ```bash npx skills add twexapi-dev/x-api-scraper-cli ```