> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt > Use this file to discover all available pages before exploring further. # MCP Sunucusu > Model Bağlam Protokolü üzerinden sunulan 53 OrbitFlare aracı. Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Gemini CLI ve Codex CLI ile çalışır. OrbitFlare MCP sunucusu, Shredstream için optimize edilmiş Solana RPC’sini, gRPC akışını, adanmış düğümleri ve doğrulayıcı altyapısını yapay zekâ asistanınızın doğrudan çağırabileceği araçlar olarak sunar. Her yetenek odaklı bir girdi şemasına sahip bağımsız bir araçtır: dahili eylem yönlendiricisi yoktur, sonuç kimliğiyle sayfalama dansı yoktur. En iyi deneyim için MCP sunucusunu [Beceri](/tr/agents/skills) ile eşleştirin. Beceri ajana OrbitFlare’ın *nasıl* çalıştığını öğretir; MCP sunucusu sohbetten ayrılmadan çağrı yapılmasını sağlar. ## Kurulum Çoğu ana bilgisayar aynı JSON biçimini kullanır; yalnızca dosya konumu değişir: ```json theme={null} { "mcpServers": { "orbitflare": { "command": "npx", "args": ["@orbitflare/mcp@latest"], "env": { "ORBITFLARE_API_KEY": "your-license-key", "ORBITFLARE_NETWORK": "mainnet" } } } } ``` | Ana bilgisayar | Nereye koyulur | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) · `%APPDATA%\Claude\claude_desktop_config.json` (Windows) | | Claude Code | `claude mcp add orbitflare -- npx @orbitflare/mcp@latest` çalıştırın veya proje köküne bir `.mcp.json` bırakın | | Cursor | `~/.cursor/mcp.json` (genel) veya `/.cursor/mcp.json` | | Gemini CLI | `~/.gemini/settings.json` (genel) veya `/.gemini/settings.json` | | Windsurf | `~/.codeium/windsurf/mcp_config.json` | | VS Code | eklentiye bağlıdır (Continue, Cline, GitHub Copilot ajan modu) | **Codex CLI**, `~/.codex/config.toml` (veya `/.codex/config.toml`) konumunda TOML kullanır: ```toml theme={null} [mcp_servers.orbitflare] command = "npx" args = ["@orbitflare/mcp@latest"] ``` ### Lisans anahtarı alma [orbitflare.com](https://orbitflare.com) adresinden kaydolun ve gösterge panelinin **Lisanslar** bölümünden lisans anahtarınızı kopyalayın. Ücretsiz planda hemen başlamak için yeterli 10 RPS alırsınız. Anahtarı ana bilgisayar yapılandırmasına koymak istemezseniz ortam değişkenini boş bırakıp sohbetten `setApiKey` çağırın: > OrbitFlare API anahtarımı `xxxx-xxxx-xxxx` olarak ayarla. ## Yapılandırma | Ortam değişkeni | Amaç | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ORBITFLARE_API_KEY` | RPC lisans anahtarı (JSON-RPC için `?api_key=` olarak kullanılır) | | `ORBITFLARE_LICENSE_KEY` | `ORBITFLARE_API_KEY` için takma ad | | `ORBITFLARE_CUSTOMER_API_KEY` | Müşteri API v2 anahtarı (`X-ORBIT-KEY` başlığı). Ayarlanmazsa `ORBITFLARE_API_KEY`’e düşer | | `ORBITFLARE_NETWORK` | `mainnet` (varsayılan) veya `devnet` | | `ORBITFLARE_RPC_URL` | İsteğe bağlı açık RPC uç noktası URL’si (bölge / ağı geçersiz kılar). Adanmış düğümler için kullanışlıdır. | | `ORBITFLARE_BEARER_TOKEN` | Müşteri API’si için Bearer token. `pollDeviceToken` / `verifyWalletSignature` ile otomatik doldurulur ve `~/.orbitflare/mcp-session.json` konumunda kalıcı hale getirilir. | Tüm değerler çalışma zamanında `setApiKey` aracıyla geçersiz kılınabilir; ana bilgisayı yeniden başlatmadan ağ veya bölge değiştirmek için kullanışlıdır. ### Bölgesel uç noktalar Varsayılan `mainnet` (otomatik yönlendirilir). Bölge sabitlemek için `setApiKey` ile şunlardan birini çağırın: `ash`, `ny`, `la`, `slc`, `ams`, `fra`, `lon`, `dub`, `siau`, `tok`, `sgp`. ## Araçlar 53 araç, etki alanına göre gruplanmıştır. Her araç bağımsız çağrılabilir. ### RPC okumaları | Araç | Ne yapar | | ----------------------------------- | ------------------------------------------------------------------------------ | | `getBalance` | Bir pubkey için SOL bakiyesi, lamport ve SOL cinsinden | | `getAccountInfo` | Mümkün olduğunda `jsonParsed` çözümlemeli tam hesap bilgisi | | `getMultipleAccounts` | Tek çağrıda en fazla 100 hesaba toplu istek | | `getProgramAccounts` | Bir programa ait hesaplar (popüler programlar için filtre + dataSlice gerekir) | | `getTokenAccountsByOwner` | Bir cüzdanın sahip olduğu tüm SPL token hesapları | | `getTokenAccountBalance` | Belirli bir SPL token hesabının bakiyesi | | `getTokenSupply` | Bir SPL mint için toplam arz | | `getTransaction` | İmzaya göre ayrıştırılmış işlem | | `getSignaturesForAddress` | Son imzalar (`before` / `until` ile sayfalanır) | | `getBlock` | Bir slottaki blok üst verisi + işlemler | | `getSlot` | Geçerli slot | | `getEpochInfo` | Epoch numarası, slot dizini, epoch içindeki slotlar, ilerleme | | `getNetworkStatus` | Tek çağrıda sağlık + sürüm + kimlik + slot | | `getLatestBlockhash` | Son blockhash + lastValidBlockHeight | | `getFeeForMessage` | Derlenmiş mesaj için lamport ücreti | | `getMinimumBalanceForRentExemption` | Kira muafiyeti için minimum lamport | | `getStakeActivation` | Bir stake hesabı için etkin / etkin olmayan lamportlar + durum | | `getRecentPrioritizationFees` | Öncelik ücreti örnekleri + P50/P75/P90/P99 yüzdelikleri | | `simulateTransaction` | İşlem simülasyonu; günlükler + tüketilen birimleri döndürür | | `sendTransaction` | Zaten imzalanmış base-64 işlemi gönderir | ### Hesap, profil ve planlar | Araç | Ne yapar | | --------------- | ------------------------------------------------------------------------------------ | | `setApiKey` | Oturum için RPC veya Müşteri API anahtarı saklar, isteğe bağlı ağ / bölge değiştirir | | `getProfile` | Kimliği doğrulanmış kullanıcı profili + hesap bakiyesi | | `updateProfile` | Ad, e-posta, ödeme cüzdanını günceller | | `listLicenses` | Hesaptaki tüm RPC lisansları | | `listRpcPlans` | Fiyatlandırmalı mevcut plan kataloğu | ### Kimlik doğrulama (cihaz kodu + cüzdan meydan okuması) | Araç | Ne yapar | | ------------------------ | ------------------------------------------------------------------------------- | | `requestDeviceCode` | Cihaz yetkilendirme akışını başlatır; `verification_uri` + `user_code` döndürür | | `pollDeviceToken` | Tamamlanana kadar yoklar; başarıda Bearer token’ı otomatik saklar | | `revokeToken` | Oturum kapatma / Bearer token’ı temizler | | `requestWalletChallenge` | Solana cüzdanı için tek kullanımlık meydan okuma dizgesi alır | | `verifyWalletSignature` | İmza ile mevcut hesaba giriş | | `registerWithWallet` | Cüzdan imzasıyla yeni hesap oluşturur | ### API anahtarları ve lisanslar | Araç | Ne yapar | | ---------------------- | ------------------------------------------------------------------------- | | `listApiKeys` | Tüm API anahtarlarını listeler (maskelenmiş) | | `createApiKey` | Yeni API anahtarı oluşturur (tam anahtar **yalnızca bir kez** döndürülür) | | `regenerateApiKey` | Kimliğe göre yeniden üretir (eski anahtar anında geçersiz olur) | | `deleteApiKey` | Bir API anahtarını kalıcı olarak siler | | `addLicenseIp` | IP modlu lisansda bir IP’yi beyaz listeye ekler | | `removeLicenseIp` | Beyaz listeden bir IP kaldırır | | `regenerateLicenseKey` | Bir lisansın RPC anahtarını yeniler | ### Faturalandırma | Araç | Ne yapar | | ----------------- | ------------------------------------------------------------------------------- | | `prepareTopUp` | İmzasız USDC bakiye yükleme işlemi oluşturur | | `confirmTopUp` | İmzalı yüklemeyi gönderir; OrbitFlare zincir üstü doğrular ve bakiyeyi yükler | | `listInvoices` | Sayfalanmış fatura listesi | | `purchaseRpcPlan` | Hesap bakiyesinden plan satın alır veya yalnızca `validateOnly` kuru çalıştırır | ### Akış, staking, takas | Araç | Ne yapar | | ----------------------- | ----------------------------------------------------------------------------------------------- | | `subscribeTransactions` | OrbitFlare CLI için kullanıma hazır Jetstream veya Yellowstone gRPC yapılandırması üretir | | `getStakeInfo` | OrbitFlare doğrulayıcı kimliği, oy hesabı, komisyon, tahmini APY, isteğe bağlı ödül hesaplayıcı | | `getSwapQuote` | Jupiter Metis yönlendirme kotasyonu (`SOL` / `USDC` / `USDT` sembollerini otomatik çözümler) | ### Cüzdan ve yazma | Araç | Ne yapar | | ------------------------ | ------------------------------------------------------------------------------------------ | | `generateKeypair` | Ed25519 anahtar çifti üretir, isteğe bağlı `~/.orbitflare/mcp-keypair.json` konumuna yazar | | `loadKeypair` | base58 gizli veya Solana CLI anahtar dosyasından yükler | | `clearKeypair` | Oturumdan kaldırır (ve isteğe bağlı diskten) | | `getWalletAddress` | Yüklenen cüzdanın adresini döndürür | | `signMessage` | İsteğe bağlı mesajı Ed25519 ile imzalar (utf8 / base58 / base64) | | `buildSolTransfer` | SOL transfer eden imzasız sürümlü işlem oluşturur | | `buildStakeDelegation` | OrbitFlare oy hesabına (veya herhangi bir oy hesabına) yetki veren imzasız işlem oluşturur | | `signAndSendTransaction` | Oturum anahtar çiftiyle imzalar, OrbitFlare RPC üzerinden yayınlar | ## Akışlar ### Kimlik doğrulama (cihaz kodu) `requestDeviceCode`, `verification_uri` + `user_code` döndürür. Model bunları size gösterir. `pollDeviceToken { device_code }`, başarıya kadar her `interval` saniyede bir tekrarlanır. Bearer token otomatik saklanır ve sonraki Müşteri API çağrılarında kullanılır. `revokeToken` Bearer token’ı temizler. ### Kimlik doğrulama (cüzdan) `generateKeypair` (yeni oluşturur) veya `loadKeypair` (base58 / Solana CLI dosyasından). `requestWalletChallenge { wallet_address }`. `signMessage { message: }` ardından `verifyWalletSignature` (mevcut hesap) veya `registerWithWallet` (yeni hesap). ### Cüzdan gönderimi `generateKeypair` veya `loadKeypair`. `buildSolTransfer { recipient, amountSol }` imzasız base64 işlem döndürür. `signAndSendTransaction { transaction }` oturum anahtarıyla imzalar, yayınlar ve imza + Solscan bağlantısı döndürür. ### Bakiye yükleme `prepareTopUp { amount, wallet_address }` imzasız base64 USDC transferi + not döndürür. `signAndSendTransaction` ile yüklenen cüzdanla veya dışarıda imzalayın. `confirmTopUp { transaction: }`. OrbitFlare zincir üstü doğrular ve bakiyenizi yükler. ## Kaynaklar Sunucu OrbitFlare dokümantasyonunu MCP kaynakları olarak sunar; böylece model gerektiğinde güncel dokümanları çekebilir: | URI | Sayfa | | ---------------------------------- | ---------------------------------------------------------------- | | `orbitflare://docs/index` | Dokümantasyon dizini (`llms.txt`) | | `orbitflare://docs/quickstart` | Hızlı başlangıç | | `orbitflare://docs/authentication` | Kimlik doğrulama, uç noktalar, hız sınırları, bağlantı limitleri | | `orbitflare://docs/products` | Ürünler ve fiyatlandırma | | `orbitflare://docs/rpc-http` | HTTP RPC referansı | | `orbitflare://docs/jetstream` | Jetstream akışı | | `orbitflare://docs/yellowstone` | Yellowstone gRPC | | `orbitflare://docs/staking` | Doğrulayıcı staking | | `orbitflare://docs/metis-swap` | Metis Swap API | | `orbitflare://docs/cli` | OrbitFlare CLI | | `orbitflare://docs/customer-api` | Müşteri API v2 | ## Sistem istemleri Önceden hazırlanmış sistem / geliştirici istemleri [`system-prompts/orbitflare/`](https://github.com/orbitflare/orbitflare-mcp/tree/main/system-prompts/orbitflare) dizininde gelir: * `claude.system.md`: Claude için özlü sistem istemi * `openai.developer.md`: OpenAI modelleri için özlü geliştirici mesajı * `full.md`: Uzun operatör el kitabı (kimlik akışları, bakiye yükleme, sıkı koruma kuralları) Modele hangi araca ne zaman başvuracağına dair uçtan uca rehberlik için birini ana bilgisayar yapılandırmanıza ekleyin. ## Deneyin Kurulduktan sonra model doğru aracı otomatik seçer: > "`Gh9ZwEm…` adresinin SOL bakiyesi nedir?" > "`7xKXt…` için son 20 işlemi göster." > "Raydium’a dokunan bir hesap için şu an rekabetçi bir öncelik ücreti nedir?" > "Frankfurt’tan Jupiter takas işlemlerini akışa alan bir Yellowstone gRPC yapılandırması oluştur." > "1 SOL → USDC, %0,3 kayma ile kotasyon ver." > "OrbitFlare doğrulayıcı oy hesabı nedir ve 250 SOL yılda ne kadar kazandırır?" ## Kaynak * MCP sunucusu: [github.com/orbitflare/orbitflare-mcp](https://github.com/orbitflare/orbitflare-mcp) * npm: [`@orbitflare/mcp`](https://www.npmjs.com/package/@orbitflare/mcp)