Agent MCP Devri

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 bir asistana Twexapi MCP erişimi verirken bu sayfayı kullanın.

Kısa özet: API MCP sunucusunu giriş yaparak veya bir API anahtarıyla bağlayın, agent’a diğer tüm araçlardan önce explore çağırmasını, okumalar için twexapi_request, yalnızca onaylanmış yazmalar için twexapi_write kullanmasını söyleyin ve sohbet özetleri yerine kalıcı devir çıktısı isteyin.

Devir kontrol listesi

Agent rota kontrol listesi

Önce belgeleri okuyun

Herkese açık belgeler, API parametreleri, kurulum talimatları, hata kodları, SDK rehberleri ve örnekler için https://docs.twexapi.io/mcp adresindeki Docs MCP’yi kullanın.

API rotasını keşfedin

Tam uç noktayı, yöntemi, istek şemasını, kategoriyi ve güvenlik işaretini bulmak için API MCP explore aracını kullanın.

API çağrısını yürütün

explore’un döndürdüğü tam yöntem ve göreli yolla salt okunur uç noktalar için API MCP twexapi_request, yazma uç noktaları için twexapi_write kullanın. Her explore sonucu kendi aracını belirtir. Yalnızca belgelenmiş query ve body alanlarını iletin.

Sohbet dışında kalıcı hale getirin

Bir backend’in yeniden denemeleri, cursor saklamayı, dosya indirmelerini, zamanlanmış işleri veya toplu orkestrasyonu yönetmesi gerektiğinde REST, SDK’lar, bir kuyruk veya iş akışı aracı kullanın.

Sonuçları devredin

Agent çalıştırmasını bitirmeden önce uç nokta yolunu, istek parametrelerini, döndürülen ID’leri, has_more, next_cursor, görev ID’lerini, yazma işlemi ID’lerini, düşülen kredileri ve varsa dışa aktarma veya polling rotasını saklayın.

Kopyala-yapıştır agent talimatı

Bunu agent’ınızın sistem talimatlarına, proje talimatlarına veya görev prompt’una yapıştırın:

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 the tool named in the catalog entry's `tool` field (`twexapi_request` for reads, `twexapi_write` for writes) with the exact method and a relative path from that entry.

Rules:
- Never call absolute URLs through `twexapi_request` or `twexapi_write`.
- 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 every `twexapi_write` call as a production action. Ask for explicit user confirmation before posting or replying.
- Never repeat an X cookie or auth_token back in your answer.
- 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.
- If a tool returns "No credits left on this TwexAPI account", stop and tell the user to top up; do not retry.
- 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ı araştırma

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

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 bir 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çileri dışa aktarma

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’un döndürdüğü bir sayfa/görev uç noktası için twexapi_request

Devir alanları: kaynak hesap, user_id, username, ad, biyografi, takipçi sayısı, doğrulama durumu, görev ID’si, has_more, next_cursor.

Yanıtları toplama

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’si, yanıt ID’si, yazar kullanıcı adı, metin, metrikler, sayfa indeksi, has_more, next_cursor.

X makalelerini getirme

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’si, başlık, yazar, Markdown gövdesi, çıkarılan bağlantılar, kaynak URL, oluşturulan özet.

Yazma işlemi çalıştırma

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. Kullanıcıya tam tweet metnini ve yanıt hedefini gösterin
3. Açık onayı bekleyin
4. cookie alanında kullanıcının X cookie’siyle POST /twitter/tweets/create için twexapi_write

MCP üzerinden kullanılabilen tek yazma işlemi paylaşım yapmaktır. Diğer yazma işlemleri REST API’yi kullanır.

Devir alanları: onay metni, yöntem, yol, tweet metni, tweet_id, durum, düşülen krediler, yanıt hedefi, medya URL’leri. Cookie’yi asla eklemeyin.

Devir çıktı sözleşmesi

Kalıcı iş akışları için agent’tan kompakt JSON döndürmesini isteyin:

{
  "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
}

CRM’e, elektronik tabloya, veritabanına veya kuyruğa gidecek kayıtlar için rows kullanın. Bir sonraki worker yalnızca kalıcı tanımlayıcılara ihtiyaç duyuyorsa ids kullanın.

Güvenlik modeli

Twexapi MCP’nin üç koruma katmanı vardır:

Hata yönetimi

MCP kimlik doğrulaması başarısız olduğunda hiçbir araç çalışmaz. JSON-RPC hatasını koruyun:

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": 401,
    "message": "Access token is invalid or expired"
  }
}

Hesabın kredisi bittiğinde bağlantı çalışmaya devam eder ve explore ücretsizdir, ancak diğer araç çağrıları şunu döndürür:

{
  "error": "No credits left on this TwexAPI account. Top up at https://twexapi.io/dashboard and try again."
}

Bir araç çalıştığında ve Twexapi API 2xx olmayan bir yanıt döndürdüğünde agent’tan araç sonucunu korumasını isteyin:

{
  "status_code": 429,
  "endpoint": "get_global_trending_tweets",
  "method": "GET",
  "path": "/twitter/global-trending/tweets",
  "result": {
    "code": 429,
    "msg": "Rate limit exceeded. QPS limit: 2 requests per second",
    "data": []
  }
}

Faydalı yorumlar:

Tüm hata mesajları için MCP araç referansına bakın.

Üretim rehberi

• Agent’ın paylaşım yapması gerekmiyorsa salt okunur bağlanın (girişte yazma kutusunun işaretini kaldırın).
• Otonom agent’lar için salt okunur iş akışlarını tercih edin.
• Yazma iş akışları için prompt’ları, istek gövdelerini, rota adlarını ve MCP yanıtlarını kaydedin.
• Her twexapi_write çağrısından önce insan onayı isteyin.
• Cookie’leri, kimlik doğrulama token’larını, API anahtarlarını ve özel DM metinlerini kullanıcının gördüğü son mesajların dışında tutun.
• Başka bir worker’ın işe devam etmesi gerektiğinde cursor’ları ve görev ID’lerini sohbet dışında saklayın.
• Yeniden deneme, kuyruk ve kalıcı depolama gerektiren zamanlanmış üretim işleri için doğrudan REST veya oluşturulmuş SDK’ları kullanın.