MCP cho trợ lý AI

Máy chủ Model Context Protocol của Nextfarm cho Claude, ChatGPT hay trợ lý riêng đọc dữ liệu trại bằng chính khoá API. Trợ lý làm được gì là do phạm vi của khoá quyết định.

	Địa chỉ
Production	`https://api-prod.nextfarm.vn/api/v1/mcp`
Sandbox	`https://api-dev.nextfarm.vn/api/v1/mcp`

1. Tạo khoá

Ở Quản lý › Khoá API, tạo một khoá riêng cho trợ lý với phạm vi chỉ đọc cần thiết.

2. Nối trợ lý

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "nextfarm": {
      "url": "https://api-prod.nextfarm.vn/api/v1/mcp",
      "headers": { "Authorization": "Bearer nfk_..." }
    }
  }
}

Claude Code

claude mcp add --transport http nextfarm https://api-prod.nextfarm.vn/api/v1/mcp \
  --header "Authorization: Bearer nfk_..."

Công cụ

Công cụ	Làm gì	Phạm vi
`farm_search`	Tìm nhanh thửa, mùa vụ, nông dân, thiết bị, lô, tem QR, chứng nhận	`theo phạm vi từng phần`
`farm_list_parcels · farm_get_parcel`	Thửa đất	`gis.parcels.view`
`farm_list_seasons`	Mùa vụ theo năm	`gis.parcels.view`
`iot_list_devices`	Thiết bị và trạng thái kết nối	`iot.devices.view`
`iot_latest_readings · iot_readings_history`	Số đo cảm biến	`iot.telemetry.view`
`iot_list_alerts`	Cảnh báo	`iot.alerts.view`
`harvest_list_records`	Bản ghi thu hoạch	`farm-harvest.harvest.view`
`trace_list_lots · trace_get_lot`	Truy xuất nguồn gốc	`farm-harvest.trace.view`
`cert_list_expiring`	Chứng nhận sắp hết hạn	`farm-harvest.certification.view`
`book_list_tables · book_query_records`	Đọc sổ nông trại	`office.base.record.view`
`book_add_record`	GHI: thêm dòng sổ	`office.base.record.manage`

Không có công cụ điều khiển thiết bị. Khoá thiếu phạm vi cho một công cụ thì công cụ trả lời rõ "khoá thiếu phạm vi (cần …)" để trợ lý nói lại với bạn, thay vì đoán.

Máy chủ không giữ trạng thái và không lưu khoá: mỗi yêu cầu dùng đúng khoá bạn gửi, mọi luật phạm vi áp như gọi API trực tiếp.

Luật bảo mật đầy đủ cho đối tác: Bảo mật →