MCP server

Nexevo는 MCP(Model Context Protocol) 서버를 노출하므로, MCP 클라이언트(Claude Desktop, Cursor 또는 MCP 지원 호스트)가 귀하의 워크스페이스 도구 중 안전한 하위 집합을 호출할 수 있습니다. 여기에는 귀하의 자체 knowledge 검색도 포함됩니다.

엔드포인트

단일 JSON-RPC 2.0 엔드포인트(MCP revision 2025-03-26, 스트리밍 가능 HTTP):

POSThttps://nexevo.ai/v1/mcp

MCP 서버는 관리자가 Settings에서 활성화해야 응답합니다. 그 전까지는 404를 반환합니다. 이는 공개 표면이기 때문에 의도된 go-live 스위치입니다(Tools API와 동일).

인증

REST API와 동일한 워크스페이스 API 키를 Authorization 헤더에 사용하세요. 키는 연결을 하나의 워크스페이스에 바인딩하므로 클라이언트는 해당 워크스페이스의 도구와 데이터만 보게 됩니다.

http

Authorization: Bearer sk-ws-...

노출되는 것

MCP를 통해 사용 가능한 것은 agent 도구 모음의 안전한, 읽기 / 연산 전용 하위 집합뿐입니다(워크스페이스의 정확한 목록은 tools/list로 확인):

웹 리서치 — web_search, url_reader, advanced_scrape, document_read, ocr_extract.
오픈 데이터 — arxiv_search, sec_edgar, world_bank, oecd, financial_data, currency_convert, weather, rss_read.
귀하의 워크스페이스 knowledge — 장기 메모리와 업로드된 knowledge에 대한 rag_search, 그리고 spreadsheet_analyze.
연산 — calculator, convert, current_time, base64, random_choice.

생성(이미지 / 비디오 / 음성), 고객 서비스 액션, 이메일, 브라우저 / 데스크톱, connector 및 SQL은 MCP를 통해 노출되지 않습니다. 따라서 연결된 클라이언트는 읽고 추론할 수는 있지만, 비용을 많이 들이거나 무언가를 변경할 수는 없습니다.

메서드

표준 MCP: initialize, notifications/initialized 알림, tools/list, tools/call, ping.

curl로 시도하기

사용 가능한 도구를 나열하세요:

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

하나를 호출하세요. 워크스페이스 knowledge를 검색:

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

MCP 클라이언트 연결

사용자 지정 헤더를 지원하는 원격 스트리밍 HTTP 서버를 지원하는 모든 MCP 호스트에서, 엔드포인트를 가리키고 키를 전달하세요. 형태는 클라이언트마다 다르지만, 모든 클라이언트에 필요한 두 가지는 URL과 Authorization 헤더입니다:

json

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

MCP를 통한 도구 호출은 agent가 사용하는 것과 동일한 호출당 요율로 과금됩니다(대부분의 읽기 전용 도구는 무료). 응답은 정제되며, MCP 클라이언트는 원시 내부 오류를 결코 보지 못합니다.