BlockVectra MCP server: เครื่องมือ blockchain RPC และเอกสารสำหรับ AI Agent

BlockVectra MCP server ที่ https://docs.blockvectra.com/mcp มอบเครื่องมือ 15 รายการสำหรับการเรียก blockchain RPC สถานะเชน ราคา และเอกสารให้แก่นักพัฒนาและ AI Agent การเชื่อมต่อไม่ต้องใช้ API key: เครื่องมือ 10 รายการไม่ต้องใช้คีย์เลย ส่วนที่เหลือใช้ x-api-key จากส่วนหัวของไคลเอนต์ของคุณ ติดตั้งได้ในบรรทัดเดียว: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

endpoint คือ MCP endpoint (HTTP POST ที่รับ JSON-RPC 2.0; GET ส่งกลับ 405) ให้บริการผ่าน MCP Streamable HTTP และไม่เก็บสถานะ สำหรับไฟล์ HTTP, JSON สาธารณะ และโฟลว์การลงทะเบียนที่เกี่ยวข้อง ดูเชื่อมต่อ AI Agent

เครื่องมือ

ตารางนี้สร้างจากรีจิสทรีเครื่องมือของเซิร์ฟเวอร์ จึงแสดงทุกเครื่องมือที่ tools/list ส่งกลับ แต่ละเครื่องมือรับอาร์กิวเมนต์และส่งกลับฟิลด์ตามที่อธิบายไว้ในสคีมา tools/list ของเครื่องมือนั้นเอง

ความปลอดภัยของ API key

เครื่องมือที่ต้องใช้คีย์ต้องมี API key เพื่อรันคำขอ Data API การดำเนินการของบัญชี หรือเมธอด RPC นอกเหนือจากเมธอดสาธารณะของเชน

• อ่านจากส่วนหัวเท่านั้น: API key ถูกอ่านจากส่วนหัวคำขอ HTTP ของไคลเอนต์ MCP เท่านั้น (x-api-key: rgw_... หรือ Authorization: Bearer rgw_...)
• ห้ามใส่คีย์ในแชต: ห้ามส่ง API key หรือ private key ในอาร์กิวเมนต์ของเครื่องมือ และห้ามวางลงในแชต อาร์กิวเมนต์ของเครื่องมือและประวัติแชตจะเข้าสู่บันทึกและบริบทของการสนทนา การส่งคีย์ในอาร์กิวเมนต์จะถูกปฏิเสธ

หากเรียกโดยไม่มีส่วนหัว API key เครื่องมือที่ต้องใช้คีย์จะส่งกลับ isError: true และนำ agent ไปที่ how_to_get_api_key และคู่มือการลงทะเบียนแบบเป็นโปรแกรม

ติดตั้งในไคลเอนต์ของคุณ

คุณเชื่อมต่อกับ BlockVectra documentation MCP server ที่ https://docs.blockvectra.com/mcp ได้ในสภาพแวดล้อมการพัฒนาและเฟรมเวิร์กที่ใช้กันทั่วไป

เริ่มต้นโดยไม่ต้องใช้ API key เชื่อมต่อกับ MCP endpoint เรียก list_chains แล้วอ่าน quickstart ด้วย read_doc เพิ่ม API key ในส่วนหัว HTTP ของไคลเอนต์เมื่อต้องการเครื่องมือ Data API หรือบัญชี การเข้าถึง RPC แบบไม่ใช้คีย์เป็นไปตามนโยบายเมธอดสาธารณะของแต่ละเชน

ส่วนหัว x-api-key เป็นตัวเลือก หากไม่มี API key ไคลเอนต์ใช้เครื่องมือเอกสารแบบอ่านอย่างเดียวได้ทั้งหมด (read_doc, search_docs, list_docs) การค้นหาเชน (list_chains) สถานะแบบสด (get_status) การประมาณราคา (get_pricing, estimate_usage) คำอธิบายข้อผิดพลาด (explain_error) และเมธอดที่อนุญาตบน endpoint สาธารณะ เมื่อใช้เครื่องมือที่ต้องใช้คีย์ (rpc_call บนเมธอดที่จำกัด, send_raw_transaction, data_api_get, get_account และ get_deposit_address) ให้กำหนดส่วนหัว x-api-key ด้วย API key ของคุณ

Claude Code

เชื่อมต่อกับ MCP server ด้วย CLI:

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

หากต้องการใส่ API key ที่เป็นตัวเลือกสำหรับเครื่องมือที่ยืนยันตัวตน ให้ส่งตัวเลือก --header (หรือ -H) และอ้างอิงตัวแปรสภาพแวดล้อมแทนการวางคีย์ ใช้เครื่องหมายคำพูดเดี่ยวเพื่อไม่ให้เชลล์ขยายค่า; Claude Code จะขยาย ${BLOCKVECTRA_API_KEY} เมื่อเริ่มเซสชัน:

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

การกำหนดค่าเดียวกันในรูปแบบ .mcp.json ระดับโปรเจกต์ (เป็นสิ่งที่ claude mcp add --scope project เขียนด้วย):

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

ให้ export BLOCKVECTRA_API_KEY ในสภาพแวดล้อมที่เริ่ม claude Claude Code จะขอให้คุณอนุมัติเซิร์ฟเวอร์ใน .mcp.json ระดับโปรเจกต์เมื่อรัน claude ในไดเรกทอรีนั้นครั้งแรก; จนกว่าจะอนุมัติ claude mcp list จะแสดงเป็น Pending approval

สำหรับสคริปต์และ CI ให้ส่งไฟล์ด้วย --mcp-config และอนุญาตเครื่องมือของเซิร์ฟเวอร์ คีย์อยู่ในสภาพแวดล้อมและไคลเอนต์ MCP เพิ่มส่วนหัวเอง ดังนั้น agent ไม่ต้องใช้คำสั่งเชลล์ที่ขยาย $BLOCKVECTRA_API_KEY (การตรวจสอบสิทธิ์ของ Claude Code ปฏิเสธคำสั่งดังกล่าวในโหมดไม่โต้ตอบด้วย Contains simple_expansion):

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

เมื่อตั้งค่าคีย์แล้ว ผลลัพธ์ของ rpc_call จะมี cu_charged และ balance_units ด้วย; การเรียกแบบไม่ใช้คีย์ส่งกลับเฉพาะการตอบกลับ JSON-RPC หากไม่ได้ตั้งค่าตัวแปร ไคลเอนต์จะส่งข้อความส่วนหัวตามตัวอักษร และเซิร์ฟเวอร์ตอบ invalid_api_key (รหัสข้อผิดพลาด -32024) แทนที่จะถอยกลับไปใช้ endpoint แบบไม่ใช้คีย์

เอกสารทางการ: เอกสาร Claude Code MCP

Cursor

เพิ่มเซิร์ฟเวอร์ลงในการกำหนดค่า MCP ของ Cursor:

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

Cursor ยังรองรับการติดตั้งแบบคลิกเดียวผ่าน deep link โดยใช้การกำหนดค่าที่เข้ารหัส base64 eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9 (แทน {"url":"https://docs.blockvectra.com/mcp"}):

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

เมื่อต้องการเครื่องมือที่ยืนยันตัวตน (Data API หรือการจัดการบัญชี) ให้เพิ่มออบเจกต์ headers พร้อม API key ของคุณ:

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

รูปแบบ ${env:NAME} เป็นไปตามเอกสารของ Cursor ซึ่งแปลงตัวแปรใน url และ headers; รูปแบบนี้ยังไม่ได้รันกับ Cursor ที่นี่ วางไฟล์ไว้ใน .cursor/mcp.json (ระดับโปรเจกต์) หรือ ~/.cursor/mcp.json (ระดับส่วนกลาง)

เอกสารทางการ: เอกสาร Cursor MCP และ ลิงก์ติดตั้งของ Cursor

VS Code

ใน VS Code ให้กำหนดค่าเซิร์ฟเวอร์ใน .vscode/mcp.json ภายใต้คีย์ระดับบนสุด servers พร้อม type: "http":

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

เมื่อต้องการเครื่องมือที่ยืนยันตัวตน ให้เพิ่มออบเจกต์ headers:

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

เมื่อเก็บข้อมูลประจำตัวที่ละเอียดอ่อน VS Code รองรับการอ้างอิงตัวแปรอินพุตหรือไฟล์สภาพแวดล้อมแทนการฮาร์ดโค้ดคีย์ คุณยังเพิ่มเซิร์ฟเวอร์ได้ด้วยการดำเนินการ Command Palette MCP: Add Server

เอกสารทางการ: เอกสาร MCP servers ของ VS Code และ เอกสารอ้างอิงการกำหนดค่า MCP ของ VS Code

Codex

เพิ่มเซิร์ฟเวอร์ด้วย OpenAI Codex CLI:

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

ใน config.toml ให้กำหนดค่า URL ของเซิร์ฟเวอร์:

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

เมื่อต้องการเครื่องมือที่ยืนยันตัวตน ให้กำหนดค่าส่วนหัวคำขอใน config.toml:

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

หรือจะแมปส่วนหัวจากตัวแปรสภาพแวดล้อมก็ได้:

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

เอกสารทางการ: เอกสาร OpenAI Codex CLI MCP

Gemini CLI

ในการกำหนดค่า Gemini CLI ให้เพิ่มเซิร์ฟเวอร์ภายใต้ mcpServers โดยใช้ httpUrl สำหรับ Streamable HTTP:

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

เมื่อต้องการเครื่องมือที่ยืนยันตัวตน ให้เพิ่มออบเจกต์ headers พร้อม API key ของคุณ:

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

เอกสารทางการ: เอกสาร Gemini CLI MCP server

OpenAI Responses API

เมื่อเรียก OpenAI Responses API ให้ส่ง MCP server ในอาร์เรย์ tools ด้วย type: "mcp":

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": "..."
  }'

เมื่อต้องการเครื่องมือที่ยืนยันตัวตน ให้ใส่ฟิลด์ headers ในนิยามเครื่องมือ:

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

เอกสารทางการ: คู่มือ OpenAI MCP tools และ เอกสารอ้างอิง OpenAI Responses API

Windsurf

ใน Windsurf ให้กำหนดค่าเซิร์ฟเวอร์ภายใต้ mcpServers โดยใช้ฟิลด์ serverUrl:

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

เมื่อต้องการเครื่องมือที่ยืนยันตัวตน ให้เพิ่มออบเจกต์ headers พร้อม API key ของคุณ:

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

Windsurf ยังรองรับการอ้างอิงตัวแปรสภาพแวดล้อม เช่น "x-api-key": "${env:BLOCKVECTRA_API_KEY}"

เอกสารทางการ: เอกสาร Windsurf MCP

Claude Desktop และ claude.ai

Custom connector กำหนดค่าผ่านส่วนติดต่อผู้ใช้:

• claude.ai: ไปที่ Customize > Connectors คลิก + Add เลือก Add custom connector แล้วป้อน URL:

  คัดลอกข้อความ

  https://docs.blockvectra.com/mcp

• Claude Desktop: เปิดเมนูการตั้งค่าบัญชีและกำหนดค่า custom connector ผ่านส่วนติดต่อ connectors

เมื่อเชื่อมต่อกับ URL แล้ว Claude จะค้นหาคู่มือ อ่านเอกสาร Markdown ตรวจสอบเชนที่รองรับ ตรวจสอบสถานะเครือข่าย และคำนวณการประมาณราคาได้โดยไม่ต้องใช้ข้อมูลประจำตัว

เอกสารทางการ: คู่มือ Claude custom connectors

ตรวจสอบการเชื่อมต่อและแก้ไขปัญหา

ใน Claude Code claude mcp list แสดงสถานะของแต่ละเซิร์ฟเวอร์ หากต้องการจำนวนเครื่องมือที่ลงทะเบียนจริง ให้รันหนึ่งครั้งด้วยเอาต์พุตแบบสตรีมแล้วอ่านเหตุการณ์ init หรืออ่านบันทึกดีบัก:

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

การเชื่อมต่อที่ทำงานได้จะแสดง "status": "connected" และเครื่องมือ mcp__blockvectra-docs__* (เช่น list_chains และ rpc_call) ในเหตุการณ์ init ในบันทึกดีบัก ให้มองหาบรรทัดเกี่ยวกับ blockvectra-docs เช่น Successfully connected และ Failed to fetch tools หากเซิร์ฟเวอร์เป็น connected แต่ไม่มีเครื่องมือปรากฏ ให้อ่านสาเหตุที่บันทึกดีบัก (--debug mcp) รายงานหลัง Failed to fetch tools หากต้องการตรวจสอบว่าเซิร์ฟเวอร์เองทำงานปกติ ให้ใช้การเรียก curl ด้านล่าง

เรียก MCP endpoint โดยไม่ใช้ไคลเอนต์

endpoint คือ JSON-RPC 2.0 ผ่าน HTTP POST ดังนั้นไคลเอนต์ HTTP ใดก็เรียกได้:

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":[]}}}'

การเรียกแรกส่งกลับรายการเครื่องมือ; การเรียกที่สองส่งกลับการตอบกลับ JSON-RPC ใน result.structuredContent ตัวระบุเชนคือ slug เช่น base_mainnet; ดูได้จาก list_chains เครื่องมือที่ต้องใช้คีย์ต้องมีส่วนหัว x-api-key; การเรียกนี้อ่านบัญชีของคุณด้วยคีย์จากตัวแปรสภาพแวดล้อม:

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

ส่งกลับ key_id, plan, balance_units, balance_cu และขีดจำกัดอัตราของคีย์ใน result.structuredContent หาก agent ของคุณรันคำสั่งผ่านเชลล์ที่ควบคุมสิทธิ์ การขยายตัวแปรนั้นอาจถูกบล็อก; ให้กำหนดส่วนหัวในไคลเอนต์ MCP แทน

คำถามที่พบบ่อย

BlockVectra MCP server ต้องใช้ API key หรือไม่

ไม่ต้อง การเชื่อมต่อไม่ต้องใช้คีย์ และเครื่องมือ 10 รายการจากทั้งหมด 15 รายการไม่ต้องใช้คีย์เลย rpc_call และ send_raw_transaction ทำงานโดยไม่ใช้คีย์ได้เฉพาะเมธอดใน public.methods ของเชน (อ่านได้ด้วย list_chains) data_api_get, get_account และ get_deposit_address ต้องมีส่วนหัว x-api-key

MCP server สร้างหรือเพิกถอน API key ได้หรือไม่

ไม่ได้ ไม่มีเครื่องมือใดที่สร้าง แสดงรายการ หรือเพิกถอน API key how_to_get_api_key ส่งกลับเฉพาะขั้นตอน; agent สร้างคีย์ผ่าน HTTP โดยทำตามการลงทะเบียนแบบเป็นโปรแกรม ส่วนคนทั่วไปสร้างในคอนโซล คีย์ไม่ผ่านอาร์กิวเมนต์ของเครื่องมือเลย

agent ส่งธุรกรรมผ่าน MCP server ได้หรือไม่

broadcast ได้ แต่ลงนามไม่ได้ rpc_call ปฏิเสธเมธอดเขียน เช่น eth_sendRawTransaction, eth_sendTransaction, eth_sign และ personal_* send_raw_transaction broadcast ธุรกรรมที่คุณลงนามในเครื่องแล้วด้วย eth_sendRawTransaction; เซิร์ฟเวอร์ไม่เคยถือหรือเห็น private key

จะเกิดอะไรขึ้นเมื่อการเรียกล้มเหลว

ข้อผิดพลาดของเครื่องมือส่งกลับ isError: true พร้อมเหตุผลที่มีโครงสร้าง ใช้ explain_error หรือเอกสารอ้างอิงรหัสข้อผิดพลาดเพื่อดูว่าความล้มเหลวนั้นถูกเรียกเก็บเงินหรือไม่ และควรลองใหม่หรือไม่

ที่เกี่ยวข้อง

• เชื่อมต่อ AI Agent: ไฟล์ที่เครื่องอ่านได้ endpoint JSON สาธารณะ และเวิร์กโฟลว์การเลือกเชน
• การลงทะเบียนแบบเป็นโปรแกรม: สร้าง API key ด้วยลายเซ็นกระเป๋าเงินโดยไม่ต้องใช้เบราว์เซอร์
• สูตรสำหรับเฟรมเวิร์ก agent: ElizaOS, viem, wagmi และ Coinbase AgentKit
• รหัสข้อผิดพลาด: ทุกข้อผิดพลาดพร้อมกฎการเรียกเก็บเงินและการลองใหม่