MCP ile Bir AI Asistanı Bağlayın

Başlamadan önce

1. Bir AlgoVesta hesabı. 7 günlük deneme yeterlidir — bunu test etmek için ücretli bir plana ihtiyacınız yok.
2. Bir MCP istemcisi: web, masaüstü veya mobilde Claude, Claude Code, Cursor, ücretli bir plandaki ChatGPT, Gemini CLI veya Model Context Protocol konuşan başka herhangi bir şey.
3. Bir anahtar. Başlamak için bağlı bir borsaya ihtiyacınız yoktur: bir paper anahtarı, $5,000'lık sanal bakiyeye karşı tam araç setini çalıştırır, böylece gerçek bir hesap devreye girmeden önce her şeyi kurup prova edebilirsiniz.

1. MCP bağlantınızı oluşturun

1. AlgoVesta panelini açın ve MCP Connection sekmesine gidin
2. Create key tıklayın, nerede kullanılacağını belirten bir etiket verin (örneğin claude-desktop veya cursor-laptop)
3. Bir kapsam seçin: yalnızca portföy soruları için read, $5,000'lık sanal bakiyeye karşı tam araç seti için paper, ya da gerçek emirler için live
4. Görünen adresi kopyalayın. Şuna benzer:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. Claude'a ekleyin

1. Claude'da Settings → Connectors'ı açın
2. Add custom connector tıklayın
3. Bir isim verin (AlgoVesta) ve MCP bağlantınızı URL alanına yapıştırın
4. Kaydedin, ardından yeni bir konuşma başlatın — araçlar konuşmanın araç listesinde görünür

Bu bağlayıcı, web, masaüstü ve mobilde Claude arasında senkronize olur, bu yüzden bir kez eklemek telefonunuzu da kapsar. Gizli bir adresi hiç yapıştırmak istemiyorsanız, AlgoVesta ayrıca PKCE (S256) ve Dynamic Client Registration ile https://api.algovesta.com/mcp adresinde standart bir OAuth 2.1 uç noktası sunar — bağlayıcıyı bunun yerine bu adrese yönlendirin ve normal bir tarayıcı onay ekranından geçirilirsiniz.

3. Claude Code'a ekleyin

Tek bir komut, sunucuyu streamable HTTP üzerinden kaydeder:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

Sunucunun kayıtlı ve erişilebilir olduğunu doğrulamak için ardından claude mcp list çalıştırın.

4. Cursor veya ChatGPT'ye ekleyin

Cursor bir JSON yapılandırma dosyası okur. mcp.json'a tek bir giriş ekleyin:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI aynı girişi alır, ancak alanı url yerine httpUrl olarak adlandırır. Geri kalan her şey aynıdır.

ChatGPT, ayarlarda developer mode etkinleştirilmiş ücretli planlarda özel MCP bağlayıcılarını destekler. Bağlayıcıyı orada ekleyin ve aynı bağlantıyı yapıştırın.

5. Bağlantıyı doğrulayın

1. İstemcinizde yeni bir konuşma başlatın
2. Sorun: How is my portfolio?
3. Asistan get_portfolio_context aracını çağırmalı ve gerçek bakiyelerinizle ve açık pozisyonlarınızla yanıt vermeli — bir paper anahtarında, $5,000'lık sanal bakiyeyle

Bir araç çağırmadan genel ifadelerle yanıt veriyorsa, sunucu bağlı değildir: asistan hesabınız hakkında değil, genel olarak işlem yapmak hakkında konuşuyordur. Bağlantıyı tekrar kontrol edin ve istemciyi yeniden başlatın.

Bağlandıktan sonra asistan neler yapabilir

Yirmi araç sunulur. Bunlardan on dördü okur veya prova yapar ve hiçbir şeyi değiştirmez: get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel ve compile_policy. Altısı emirleri hareket ettirir: place_order, close_position, modify_position, cancel_order, create_strategy ve update_strategy.

Bunları isimleriyle çağırmazsınız. Düz dille sorun — "neye sahibim?", "0.1 BTC şu anda bana kaça mal olur?", "ETH pozisyonumun yarısını kapat" — ve asistan araçları seçer ve zincirler. Açtığı her pozisyonda bir stop-loss gereklidir ve sonrasında bunu kaldıracak bir araç yoktur. Her araç için tam şemalar geliştirici dokümantasyonunda yer alır.

401 unauthorized

Anahtar iptal edildi, silindi veya adres yanlış yazıldı. Bu, bağlantı elle yapıştırıldığında veya sonunda bir boşlukla kopyalandığında görülen en yaygın hatadır. Anahtarın hâlâ MCP Connection sekmesinde var olup olmadığını kontrol edin; varsa, dizeyi onarmaya çalışmak yerine onu silip yenisini oluşturun.

insufficient_scope

Asistanın çağırmaya çalıştığı araç, anahtarın taşıdığından daha yüksek bir kapsam gerektiriyor. Bir read anahtarı place_order'ı çağıramaz ve bir paper anahtarı gerçek bir hesaba ulaşamaz. Kapsamlar sıralıdır, bu yüzden paper gerektiren bir araç bir read anahtarını reddeder. Ya sınırı kabul edin ya da gerçekten ihtiyacınız olan kapsamla yeni bir anahtar verin — live'a geçmek ikinci bir faktör gerektirir.

user_frozen

Kill switch hesabınızda aktif, bu da tüm anahtarları aynı anda durdurur. Bu kasıtlıdır: acil durdurma frenidir. İşlemin yeniden başlamasını istediğinizde onu panelde çözün. Yalnızca tek bir istemciyi kesmeyi amaçladıysanız, bunun yerine yalnızca o anahtarı iptal edin — diğerleri çalışmaya devam eder.

rate_limited

O anahtarda dakikada 60 isteği aştınız. Pahalı araçlara daha sıkı sınırlar uygulanır: place_order dakikada 10, replay_channel ise saatte 5 ile sınırlıdır. Bekleyin ve tekrar deneyin. Bunu tekrar tekrar görmek genellikle hızlı işlem yaptığınız değil, bir ajanın döngüye girdiği anlamına gelir — istek oranını artırmadan önce asistanın gerçekte ne yaptığını kontrol etmeye değer.