BlockVectra MCP sunucusu: AI Agent'lar için blokzincir RPC ve belge araçları

https://docs.blockvectra.com/mcp adresindeki BlockVectra MCP sunucusu, geliştiricilere ve AI Agent'lara blokzincir RPC çağrıları, zincir durumu, fiyatlandırma ve belgeler için 15 araç sunar. Bağlanmak için API key gerekmez: 10 araç hiçbir zaman API key gerektirmez; diğerleri istemcinizin başlıklarındaki x-api-key değerini kullanır. Tek satırda kurun: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

Uç nokta MCP uç noktasıdır (JSON-RPC 2.0 alan HTTP POST; GET 405 döndürür), MCP Streamable HTTP üzerinden sunulur ve durum bilgisi tutmaz. HTTP dosyaları, genel JSON ve çevresindeki kayıt akışı için AI Agent'ları bağlayın sayfasına bakın.

Araçlar

Bu tablo sunucunun araç kayıt defterinden üretilir; bu nedenle tools/list çağrısının döndürdüğü her aracı listeler. Her araç, kendi tools/list şemasında açıklanan argümanları alır ve açıklanan alanları döndürür.

API key güvenliği

Anahtar gerektiren araçlar, Data API istekleri, hesap işlemleri veya bir zincirin genel yöntemleri dışındaki RPC yöntemleri için bir API key ister.

• Yalnızca başlıklardan okunur: API key yalnızca MCP istemcisinin HTTP istek başlıklarından okunur (x-api-key: rgw_... veya Authorization: Bearer rgw_...).
• Anahtarları asla sohbete yazmayın: API key'leri veya özel anahtarları asla araç argümanlarında iletmeyin ve sohbete yapıştırmayın. Araç argümanları ve sohbet geçmişi konuşma günlüklerine ve bağlama girer; anahtarların argümanlarla iletilmesi reddedilir.

API key başlığı olmadan çağrılırsa, anahtar gerektiren araçlar isError: true döndürür ve agent'ı how_to_get_api_key aracına ve programatik kayıt rehberine yönlendirir.

İstemcinizde kurulum

https://docs.blockvectra.com/mcp adresindeki BlockVectra belge MCP sunucusuna yaygın geliştirme ortamları ve çerçevelerden bağlanabilirsiniz.

API key olmadan başlayın. MCP uç noktasına bağlanın, list_chains çağırın, ardından read_doc ile quickstart sayfasını okuyun. Data API veya hesap araçlarına ihtiyaç duyduğunuzda istemcinizin HTTP başlıklarına bir API key ekleyin. Anahtarsız RPC erişimi, her zincirin genel yöntem politikasını izler.

x-api-key başlığı isteğe bağlıdır. API key olmadan istemciler salt okunur belge araçlarının tamamını (read_doc, search_docs, list_docs), zincir keşfini (list_chains), canlı durumu (get_status), fiyat tahminini (get_pricing, estimate_usage), hata açıklamalarını (explain_error) ve genel uç noktalarda izin verilen yöntemleri kullanabilir. Anahtar gerektiren araçları (kısıtlı yöntemlerde rpc_call, send_raw_transaction, data_api_get, get_account ve get_deposit_address) kullanırken x-api-key başlığını API key'inizle yapılandırın.

Claude Code

CLI ile MCP sunucusuna bağlanın:

claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

Kimlik doğrulamalı araçlar için isteğe bağlı bir API key eklemek üzere --header (veya -H) seçeneğini kullanın ve anahtarı yapıştırmak yerine bir ortam değişkenine başvurun. Kabuğunuz değişkeni genişletmesin diye tek tırnak kullanın; Claude Code, oturumu başlatırken ${BLOCKVECTRA_API_KEY} ifadesini genişletir:

claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp \
  --header 'x-api-key: ${BLOCKVECTRA_API_KEY}'

Aynı yapılandırma, proje düzeyinde bir .mcp.json olarak (claude mcp add --scope project komutunun yazdığı dosya da budur):

{
  "mcpServers": {
    "blockvectra-docs": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp",
      "headers": { "x-api-key": "${BLOCKVECTRA_API_KEY}" }
    }
  }
}

BLOCKVECTRA_API_KEY değişkenini claude komutunu başlatan ortamda dışa aktarın. Claude Code, o dizinde claude komutunu ilk çalıştırdığınızda proje düzeyindeki bir .mcp.json sunucusunu onaylamanızı ister; o zamana kadar claude mcp list onu Pending approval olarak gösterir.

Betikler ve CI için dosyayı --mcp-config ile verin ve sunucunun araçlarına izin verin. Anahtar ortamda kalır ve MCP istemcisi başlığı kendisi ekler; böylece agent'ın $BLOCKVECTRA_API_KEY değişkenini genişleten bir kabuk komutuna ihtiyacı olmaz (Claude Code'un izin denetimi, etkileşimsiz modda bu tür komutları Contains simple_expansion ile reddetti):

claude -p "Use rpc_call to run eth_blockNumber on base_mainnet" \
  --mcp-config ./mcp.json --allowedTools "mcp__blockvectra-docs__*"

Anahtar ayarlıyken rpc_call sonucu ayrıca cu_charged ve balance_units alanlarını içerir; anahtarsız bir çağrı yalnızca JSON-RPC yanıtını döndürür. Değişken ayarlı değilse istemci başlık metnini olduğu gibi gönderir ve sunucu, anahtarsız uç noktaya geri dönmek yerine invalid_api_key (hata kodu -32024) yanıtını verir.

Resmî belgeler: Claude Code MCP belgeleri.

Cursor

Sunucuyu Cursor'ın MCP yapılandırmasına ekleyin:

{
  "mcpServers": {
    "blockvectra": {
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

Cursor ayrıca base64 kodlu eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9 yapılandırmasını ({"url":"https://docs.blockvectra.com/mcp"} değerini temsil eder) kullanan derin bağlantılarla tek tıkla kurulumu destekler:

cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9

Kimlik doğrulamalı araçlara (Data API veya hesap yönetimi) ihtiyaç duyduğunuzda API key'inizle headers nesnesini ekleyin:

{
  "mcpServers": {
    "blockvectra": {
      "url": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "${env:BLOCKVECTRA_API_KEY}"
      }
    }
  }
}

${env:NAME} biçimi, url ve headers içindeki değişkenleri çözen Cursor belgelerini izler; bu biçim burada Cursor'a karşı çalıştırılmamıştır. Dosyayı .cursor/mcp.json (proje) veya ~/.cursor/mcp.json (genel) konumuna koyun.

Resmî belgeler: Cursor MCP belgeleri ve Cursor kurulum bağlantıları.

VS Code

VS Code'da sunucuyu .vscode/mcp.json içinde, üst düzey servers anahtarı altında type: "http" ile yapılandırın:

{
  "servers": {
    "blockvectra": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

Kimlik doğrulamalı araçlara ihtiyaç duyduğunuzda headers nesnesini ekleyin:

{
  "servers": {
    "blockvectra": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Hassas kimlik bilgilerini saklarken VS Code, anahtarları koda gömmek yerine girdi değişkenlerine veya ortam dosyalarına başvurmayı destekler. Sunucuları ayrıca MCP: Add Server Komut Paleti eylemiyle de ekleyebilirsiniz.

Resmî belgeler: VS Code MCP sunucuları belgeleri ve VS Code MCP yapılandırma başvurusu.

Codex

Sunucuyu OpenAI Codex CLI ile ekleyin:

codex mcp add blockvectra --url https://docs.blockvectra.com/mcp

config.toml içinde sunucu URL'sini yapılandırın:

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"

Kimlik doğrulamalı araçlara ihtiyaç duyduğunuzda istek başlıklarını config.toml içinde yapılandırın:

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"
http_headers = { "x-api-key" = "YOUR_API_KEY" }

Alternatif olarak başlığı bir ortam değişkeninden eşleyin:

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"
env_http_headers = { "x-api-key" = "BLOCKVECTRA_API_KEY" }

Resmî belgeler: OpenAI Codex CLI MCP belgeleri.

Gemini CLI

Gemini CLI yapılandırmasında sunucuyu mcpServers altına, Streamable HTTP için httpUrl kullanarak ekleyin:

{
  "mcpServers": {
    "blockvectra": {
      "httpUrl": "https://docs.blockvectra.com/mcp"
    }
  }
}

Kimlik doğrulamalı araçlara ihtiyaç duyduğunuzda API key'inizle headers nesnesini ekleyin:

{
  "mcpServers": {
    "blockvectra": {
      "httpUrl": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Resmî belgeler: Gemini CLI MCP sunucusu belgeleri.

OpenAI Responses API

OpenAI Responses API'yi çağırırken MCP sunucusunu tools dizisinde type: "mcp" ile iletin:

OPENAI_API_BASE="https://api.openai.com/v1"
curl "$OPENAI_API_BASE/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "tools": [{
      "type": "mcp",
      "server_label": "blockvectra",
      "server_url": "https://docs.blockvectra.com/mcp",
      "require_approval": "never"
    }],
    "input": "..."
  }'

Kimlik doğrulamalı araçlara ihtiyaç duyduğunuzda araç tanımına headers alanını ekleyin:

{
  "type": "mcp",
  "server_label": "blockvectra",
  "server_url": "https://docs.blockvectra.com/mcp",
  "headers": { "x-api-key": "YOUR_API_KEY" },
  "require_approval": "never"
}

Resmî belgeler: OpenAI MCP araçları rehberi ve OpenAI Responses API başvurusu.

Windsurf

Windsurf'te sunucuyu mcpServers altında serverUrl alanını kullanarak yapılandırın:

{
  "mcpServers": {
    "blockvectra": {
      "serverUrl": "https://docs.blockvectra.com/mcp"
    }
  }
}

Kimlik doğrulamalı araçlara ihtiyaç duyduğunuzda API key'inizle headers nesnesini ekleyin:

{
  "mcpServers": {
    "blockvectra": {
      "serverUrl": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf ayrıca "x-api-key": "${env:BLOCKVECTRA_API_KEY}" gibi ortam değişkenlerine başvurmayı da destekler.

Resmî belgeler: Windsurf MCP belgeleri.

Claude Desktop ve claude.ai

Özel bağlayıcılar kullanıcı arayüzü üzerinden yapılandırılır:

• claude.ai: Customize > Connectors bölümüne gidin, + Add düğmesine tıklayın, Add custom connector seçeneğini seçin ve URL'yi girin:

  Metni Kopyala

  https://docs.blockvectra.com/mcp

• Claude Desktop: Hesap ayarları menüsünü açın ve özel bağlayıcıları bağlayıcılar arayüzünden yapılandırın.

URL'ye bağlanmak, Claude'un kimlik bilgisi olmadan rehberlerde arama yapmasını, Markdown belgelerini okumasını, desteklenen zincirleri incelemesini, ağ durumunu kontrol etmesini ve fiyat tahminleri hesaplamasını sağlar.

Resmî belgeler: Claude özel bağlayıcılar rehberi.

Bağlantıyı kontrol edin ve sorun giderin

Claude Code'da claude mcp list, her sunucunun durumunu gösterir. Gerçekten kaydedilen araçların sayısını görmek için akış çıktısıyla bir kez çalıştırıp init olayını okuyun veya hata ayıklama günlüğünü okuyun:

claude -p "say ok" --mcp-config ./mcp.json --output-format stream-json --verbose
claude -p "say ok" --mcp-config ./mcp.json --debug mcp --debug-file mcp-debug.log

Çalışan bir bağlantı, init olayında "status": "connected" ve mcp__blockvectra-docs__* araçlarını (list_chains ve rpc_call gibi) gösterir. Hata ayıklama günlüğünde blockvectra-docs ile ilgili Successfully connected ve Failed to fetch tools gibi satırlara bakın. Sunucu connected görünüyor ama hiç araç yoksa, hata ayıklama günlüğünün (--debug mcp) Failed to fetch tools sonrasında bildirdiği nedeni okuyun. Sunucunun kendisinin sağlıklı olduğunu denetlemek için aşağıdaki curl çağrılarını kullanın.

MCP uç noktasını istemci olmadan çağırın

Uç nokta, HTTP POST üzerinden JSON-RPC 2.0'dır; bu nedenle herhangi bir HTTP istemcisi onu çağırabilir:

curl -s https://docs.blockvectra.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s https://docs.blockvectra.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"rpc_call","arguments":{"chain":"base_mainnet","method":"eth_blockNumber","params":[]}}}'

İlk çağrı araç listesini döndürür; ikincisi JSON-RPC yanıtını result.structuredContent içinde döndürür. Zincir tanımlayıcıları base_mainnet gibi slug'lardır; bunları list_chains ile alın. Anahtar gerektiren araçlar x-api-key başlığına ihtiyaç duyar; bu çağrı hesabınızı bir ortam değişkenindeki anahtarla okur:

curl -s https://docs.blockvectra.com/mcp -H 'content-type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_account","arguments":{}}}'

result.structuredContent içinde key_id, plan, balance_units, balance_cu ve anahtarın hız sınırlarını döndürür. Agent'ınız komutları izin denetimli bir kabuk üzerinden çalıştırıyorsa bu değişken genişletmesi engellenebilir; bunun yerine başlığı MCP istemcisinde yapılandırın.

SSS

BlockVectra MCP sunucusu bir API key gerektirir mi?

Hayır. Bağlanmak için anahtar gerekmez ve 15 aracın 10 tanesi hiçbir zaman anahtar gerektirmez. rpc_call ve send_raw_transaction, anahtar olmadan yalnızca zincirin public.methods listesindeki yöntemler için çalışır (bunu list_chains ile okuyun). data_api_get, get_account ve get_deposit_address için x-api-key başlığı gerekir.

MCP sunucusu API key oluşturabilir veya iptal edebilir mi?

Hayır. Hiçbir araç API key oluşturmaz, listelemez veya iptal etmez. how_to_get_api_key yalnızca adımları döndürür; bir agent programatik kayıt rehberini izleyerek HTTP üzerinden anahtar oluşturur, insanlar ise konsolda oluşturur. Anahtarlar hiçbir zaman araç argümanlarından geçmez.

Bir agent MCP sunucusu üzerinden işlem gönderebilir mi?

Yayınlayabilir, imzalayamaz. rpc_call, eth_sendRawTransaction, eth_sendTransaction, eth_sign ve personal_* gibi yazma yöntemlerini reddeder. send_raw_transaction, yerelde zaten imzaladığınız bir işlemi eth_sendRawTransaction ile yayınlar; sunucu hiçbir zaman özel anahtar tutmaz veya görmez.

Bir çağrı başarısız olursa ne olur?

Araç hataları, yapılandırılmış bir nedenle isError: true döndürür. Bir hatanın faturalandırılıp faturalandırılmadığını ve yeniden denenip denenmeyeceğini görmek için explain_error aracını veya hata kodları başvurusunu kullanın.

İlgili

• AI Agent'ları bağlayın: makine tarafından okunabilir dosyalar, genel JSON uç noktaları ve zincir seçimi iş akışı.
• Programatik kayıt: tarayıcı olmadan bir cüzdan imzasıyla API key oluşturun.
• Agent çerçevesi tarifleri: ElizaOS, viem, wagmi ve Coinbase AgentKit.
• Hata kodları: faturalandırma ve yeniden deneme kurallarıyla her hata.