Tài liệu MCP Server

Kết nối AI của bạn với dữ liệu Nhịp Số

Claude, ChatGPT, Cursor và mọi MCP client truy vấn trực tiếp thời tiết, giá vàng, giá bạc, xăng dầu, ngoại tệ, lãi suất, bóng đá, ô tô, chứng khoán, thể thao, tập dữ liệu — qua một endpoint duy nhất.

Endpoint

https://mcp.nhipso.vn/v1

Xác thực bằng Secret key (nhipso-sk-…) qua header x-api-key. Tạo key tại trang tài khoản.

Claude Code

claude mcp add --transport http nhipso https://mcp.nhipso.vn/v1 \
  --header "x-api-key: nhipso-sk-your-key"

Claude Desktop / MCP client khác

Thêm vào claude_desktop_config.json (hoặc cấu hình MCP tương ứng của client bạn dùng):

{
  "mcpServers": {
    "nhipso": {
      "url": "https://mcp.nhipso.vn/v1",
      "type": "http",
      "headers": { "x-api-key": "nhipso-sk-your-key" }
    }
  }
}

Claude web / mobile (Connectors)

Ứng dụng claude.ai (web và mobile) kết nối qua Custom Connector và không gửi được header tùy chỉnh — thay vào đó, nhúng Secret key vào URL khi thêm connector (Settings → Connectors → Add custom connector):

https://mcp.nhipso.vn/v1?apiKey=nhipso-sk-your-key

Connector thêm trên web sẽ tự đồng bộ sang ứng dụng mobile.

Endpoint theo từng lĩnh vực

Ngoài endpoint /v1 gộp toàn bộ tool, mỗi lĩnh vực còn có endpoint riêng với tập tool nhỏ gọn — hữu ích cho connector claude.ai (tool-search sẽ bỏ sót khi một connector có quá nhiều tool). Xác thực và cách nhúng key giống hệt endpoint chính.

  • Thời tiếtmcp.nhipso.vn/v1/weather
  • Giá vàngmcp.nhipso.vn/v1/gold
  • Giá bạcmcp.nhipso.vn/v1/silver
  • Xăng dầumcp.nhipso.vn/v1/fuel
  • Ngoại tệmcp.nhipso.vn/v1/forex
  • Lãi suấtmcp.nhipso.vn/v1/savings
  • Bóng đámcp.nhipso.vn/v1/football
  • Ô tômcp.nhipso.vn/v1/car
  • Chứng khoánmcp.nhipso.vn/v1/stock
  • Thể thaomcp.nhipso.vn/v1/sports
  • Tập dữ liệumcp.nhipso.vn/v1/datasets

Tool và tính phí

Mỗi endpoint dữ liệu REST tương ứng một tool nhipso_* (ví dụ nhipso_gold_representative — giá vàng đại diện). Mọi request đều yêu cầu Secret key hợp lệ và chịu giới hạn tần suất theo gói; riêng lượt gọi tool (tools/call) mới trừ vào quota tháng — kết nối và liệt kê tool không tốn quota. Danh sách endpoint đầy đủ xem tại tài liệu REST API.