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 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

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:

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

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 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

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

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

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

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:

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

Hata yönetimi

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

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

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

Ü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.