--- title: "Agent MCP Devri" description: "Twexapi MCP erişimini AI agent'lara ve aşağı akış iş akışlarına güvenle devretme talimatları." --- Bir AI kodlama agent'ına, araştırma agent'ına, iş akışı agent'ına veya dahili asistana Twexapi MCP erişimi verirken bu sayfayı kullanın. Kısa özet: API MCP sunucusunu bağlayın, agent'a bir API anahtarı verin, `twexapi_request` öncesinde `explore` çağırmasını söyleyin ve sohbet özetleri yerine kalıcı devir çıktısı isteyin. ## Devir kontrol listesi 1. **API MCP sunucusunu bağlayın** MCP istemcinize `https://api.twexapi.io/mcp` ekleyin; `x-api-key` veya `Authorization: Bearer ` kullanın. 2. **Docs MCP sunucusunu bağlayın** Agent API rotalarını seçmeden önce Twexapi belgelerinde arama yapacaksa `https://docs.twexapi.io/mcp` ekleyin. 3. **Çağırmadan önce keşfedin** Agent'a görevle eşleşen sorgu veya kategoriyle önce `explore` çağırmasını söyleyin. 4. **Göreli yollar isteyin** Agent'a yalnızca `explore` tarafından döndürülen göreli yollarla `twexapi_request` çağırmasını söyleyin. 5. **Devir alanlarını koruyun** Son çıktıda ID'ler, imleçler, görev ID'leri, rota adları, durum ve kredi alanları zorunlu olsun. 6. **Yazmaları dikkatli yönetin** `read_only` değeri `false` olan uç noktalardan önce açık kullanıcı onayı isteyin. ## Agent rota kontrol listesi ### Önce belgeleri okuyun Herkese açık belgeler, API parametreleri, kurulum talimatları, hata kodları, SDK rehberliği ve örnekler için `https://docs.twexapi.io/mcp` Docs MCP kullanın. ### API rotasını keşfedin Tam uç nokta, yöntem, istek şeması, kategori ve güvenlik bayrağı için API MCP `explore` kullanın. ### API çağrısını yürütün API MCP `twexapi_request` ile `explore` tarafından döndürülen tam yöntem ve göreli yolu kullanın. Yalnızca belgelenmiş `query` ve `body` alanlarını iletin. ### Sohbet dışında kalıcı hale getirin Bir backend yeniden deneme, imleç depolama, dosya indirme, zamanlanmış iş veya toplu orkestrasyon sahiplenmeliyse REST, SDK'lar, kuyruk veya iş akışı aracı kullanın. ### Sonuçları devredin Agent çalışması bitmeden uç nokta yolu, istek parametreleri, dönen ID'ler, `has_more`, `next_cursor`, görev ID'leri, yazma işlemi ID'leri, ücretlendirilen krediler ve dışa aktarma veya yoklama rotasını saklayın. ## Kopyala-yapıştır agent talimatı Bunu agent'ınızın sistem talimatlarına, proje talimatlarına veya görev istemine yapıştırın: ```txt You have access to Twexapi MCP servers. Use Twexapi Docs MCP first when you need product documentation, setup instructions, endpoint docs, authentication details, examples, or error-code explanations. Use the API MCP tool `explore` before making API calls. Search by query or category to find the correct Twexapi endpoint. Then call `twexapi_request` with the exact method and a relative path from the returned catalog entry. Rules: - Never call absolute URLs through `twexapi_request`. - Never call paths that were not returned by `explore`. - Do not call `/openapi.json`, docs pages, dashboards, or hidden framework routes through API MCP. - Treat any catalog entry with `read_only: false` as a production action. - Ask for explicit user confirmation before posting, replying, liking, retweeting, following, blocking, bookmarking, deleting, sending DMs, or making any other write call. - Preserve tweet IDs, user IDs, task IDs, cursors, write action IDs, status, credit fields, and response metadata in your final answer when they are useful for auditability. - If a request fails, report the HTTP status, endpoint name, method, path, and Twexapi error message. - For downstream workflows, return compact JSON with route_used, request, rows or ids, has_more, next_cursor, and next_step. ``` ## Yaygın iş akışları ### Trend konularını araştırma ```txt Use Twexapi MCP to find trending countries, choose the United States, fetch AI-related trending tweets, and summarize the top themes with tweet IDs. ``` Önerilen rota: 1. `explore(category="trending")` 2. `/twitter/global-trending/countries` için `twexapi_request` 3. `/twitter/global-trending/topics` için `twexapi_request` 4. `/twitter/global-trending/tweets` için `twexapi_request` Devir alanları: `country`, `topic`, `content`, `tweet_id`, `author_username`, `created_at`, etkileşim metrikleri, `has_more`, `next_cursor`. ### Tweet arama ```txt Search recent posts from @openai that mention AI agents and return the most relevant tweets with IDs, author metadata, and a short summary. ``` Önerilen rota: 1. `explore(query="advanced search tweets")` 2. `/twitter/advanced_search/page` için `twexapi_request` 3. Katalog sayfalama akışı döndürürse `/twitter/advanced_search/page` kullanın Devir alanları: orijinal sorgu, sıralama modu, `tweet_id`, metin, yazar meta verisi, oluşturulma zamanı, doğrudan URL, `has_more`, `next_cursor`. ### Takipçi dışa aktarma ```txt Export a page of followers for @openai in CRM-ready JSON. ``` Önerilen rota: 1. `explore(category="followers")` 2. `/twitter/followers/{screen_name}/{count}` veya `explore` tarafından döndürülen sayfa/görev uç noktası için `twexapi_request` Devir alanları: kaynak hesap, `user_id`, `username`, ad, bio, takipçi sayısı, doğrulanmış durum, görev ID, `has_more`, `next_cursor`. ### Yanıtları kazıma ```txt Fetch replies for a tweet and return reply IDs, author usernames, text, and engagement fields. ``` Önerilen rota: 1. `explore(query="tweet replies")` 2. `/twitter/tweets/{tweet_id}/replies/{count}` veya `/twitter/tweets/{tweet_id}/replies/page` için `twexapi_request` Devir alanları: kaynak tweet ID, yanıt ID, yazar kullanıcı adı, metin, metrikler, sayfa indeksi, `has_more`, `next_cursor`. ### X makalelerini getirme ```txt Fetch this X article as Markdown and turn it into a concise brief. ``` Önerilen rota: 1. `explore(category="articles")` 2. `/x/article/{tweet_id}/markdown` için `twexapi_request` Devir alanları: makale ID, başlık, yazar, Markdown gövdesi, çıkarılan bağlantılar, kaynak URL, üretilen özet. ### Yazma işlemi yürütme ```txt Draft a reply to this tweet, ask me for confirmation, then post only after I approve. ``` Önerilen rota: 1. `explore(query="create tweet", include_writes=true)` 2. Tam yazma gövdesini kullanıcıya sunun 3. Açık onayı bekleyin 4. Dönen yazma uç noktası için `twexapi_request` Devir alanları: onay metni, yöntem, yol, istek gövdesi, `tweet_id`, `write_action_id`, durum, ücretlendirilen krediler, yanıt hedefi, medya URL'leri. ## Devir çıktı sözleşmesi Kalıcı iş akışları için agent'dan kompakt JSON döndürmesini isteyin: ```json { "source": "twexapi_mcp", "job": "tweet_search", "route_used": "/twitter/advanced_search/page", "request": { "method": "POST", "path": "/twitter/advanced_search/page", "query": null, "body": { "searchTerms": ["from:openai AI agents"], "maxItems": 20, "sortBy": "Latest" } }, "rows": [], "ids": [], "has_more": false, "next_cursor": null, "next_step": null } ``` Kayıtlar CRM, elektronik tablo, veritabanı veya kuyruğa gidecekse `rows` kullanın. Sonraki worker yalnızca kalıcı tanımlayıcılara ihtiyaç duyuyorsa `ids` kullanın. ## Güvenlik modeli Twexapi MCP'nin üç önemli koruması vardır: | Koruma | Davranış | | --- | --- | | API anahtarı auth | MCP, REST API ile aynı API anahtarı doğrulaması, kredi kontrolleri ve hesap kontrollerini kullanır. | | İzin listesi yolları | `twexapi_request` MCP kataloğu dışındaki uç noktaları reddeder. | | Yazma bayrakları | Yan etkili eylemler `read_only: false` olarak işaretlenir; agent onay isteyebilir. | ## Hata yönetimi MCP kimlik doğrulaması başarısız olursa araç çalışmaz. JSON-RPC hatasını koruyun: ```json { "jsonrpc": "2.0", "error": { "code": 401, "message": "Missing MCP API token" } } ``` `twexapi_request` çalışır ve altta yatan Twexapi API 2xx dışı yanıt döndürürse agent'dan araç sonucunu korumasını isteyin: ```json { "status_code": 403, "endpoint": "get_global_trending_tweets", "method": "GET", "path": "/twitter/global-trending/tweets", "result": { "detail": "Credits exhausted or action not allowed." } } ``` Faydalı yorumlar: | Durum | Anlam | | --- | --- | | `401` | Araç çalışmadan MCP kimlik doğrulaması başarısız; `x-api-key` veya Bearer auth kontrol edin. | | `403` | API anahtarı kullanılamıyor, krediler tükendi veya eyleme izin yok. | | `429` | Hız sınırı aşıldı. Limit penceresinden sonra yeniden deneyin. | | `5xx` | Servis tarafı hatası veya üst akış X/Twitter getirme sorunu. | ## Üretim rehberliği - Agent yalnızca belirli bir iş akışına ihtiyaç duyuyorsa kapsamlı bir API anahtarı kullanın. - Otonom agent'lar için salt okunur iş akışlarını tercih edin. - Yazma iş akışları için istemleri, istek gövdelerini, rota adlarını ve MCP yanıtlarını günlüğe kaydedin. - `read_only: false` çağrılarından önce insan onayı isteyin. - Cookie'leri, auth token'ları, API anahtarlarını ve özel DM metnini son kullanıcıya görünen mesajlardan çıkarın. - Başka bir worker işi sürdürmeli ise imleçleri ve görev ID'lerini sohbet dışında saklayın. - Yeniden deneme, kuyruklama ve kalıcı depolama gerektiren zamanlanmış üretim işleri için doğrudan REST veya oluşturulan SDK kullanın.