Pelayan MCP

Nexevo mendedahkan pelayan Model Context Protocol (MCP), jadi klien MCP — Claude Desktop, Cursor, atau mana-mana hos berkemampuan-MCP — boleh memanggil subset selamat alat workspace anda, termasuk menggelintar pengetahuan anda sendiri.

Endpoint

Satu endpoint JSON-RPC 2.0 (semakan MCP 2025-03-26, HTTP boleh-strim):

POSThttps://nexevo.ai/v1/mcp

Pelayan MCP mesti didayakan oleh pentadbir dalam Settings sebelum ia memberi respons — ia memberikan 404 sehingga itu. Ini ialah suis mula-hidup yang disengajakan (sama dengan Tools API), kerana ia permukaan awam.

Pengesahan

Gunakan kunci API workspace yang sama seperti REST API, dalam pengepala Authorization. Kunci mengikat sambungan kepada satu workspace — klien hanya melihat alat dan data workspace itu sahaja.

http

Authorization: Bearer sk-ws-...

Apa yang didedahkan

Hanya subset selamat, baca / kira-sahaja set alat agent tersedia melalui MCP (panggil tools/list untuk melihat senarai tepat bagi workspace anda):

Penyelidikan web — web_search, url_reader, advanced_scrape, document_read, ocr_extract.
Data terbuka — arxiv_search, sec_edgar, world_bank, oecd, financial_data, currency_convert, weather, rss_read.
Pengetahuan workspace anda — rag_search ke atas ingatan jangka panjang dan pengetahuan dimuat naiknya, serta spreadsheet_analyze.
Kira — calculator, convert, current_time, base64, random_choice.

Penjanaan (imej / video / pertuturan), tindakan perkhidmatan-pelanggan, e-mel, pelayar / desktop, penyambung dan SQL tidak didedahkan melalui MCP — jadi klien yang disambung boleh membaca dan menaakul, tetapi tidak boleh berbelanja berat atau mengubah apa-apa.

Kaedah

MCP standard: initialize, pemberitahuan notifications/initialized, tools/list, tools/call, dan ping.

Cuba dengan curl

Senaraikan alat tersedia:

bash

curl https://nexevo.ai/v1/mcp \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Panggil satu — gelintar pengetahuan workspace anda:

bash

curl https://nexevo.ai/v1/mcp \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"rag_search","arguments":{"query":"our refund policy"}}}'

Menyambung klien MCP

Dalam mana-mana hos MCP yang menyokong pelayan HTTP-boleh-strim jauh dengan pengepala tersuai, halakan ke endpoint dan hantar kunci anda. Bentuk berbeza mengikut klien, tetapi dua perkara yang setiap klien perlukan ialah URL dan pengepala Authorization:

json

{
  "mcpServers": {
    "nexevo": {
      "url": "https://nexevo.ai/v1/mcp",
      "headers": { "Authorization": "Bearer sk-ws-..." }
    }
  }
}

Panggilan alat melalui MCP dibil pada kadar setiap-panggilan yang sama seperti agent (kebanyakan alat baca-sahaja adalah percuma). Respons disterilkan — klien MCP tidak pernah melihat ralat dalaman mentah.