←Home/Docs
⌕

Cài đặt MCP

@crawlpipe/mcp là một stdio MCP server bọc các endpoint /v1/legal/* tương tự như trong Tài liệu tham khảo API — mỗi cuộc gọi công cụ bên dưới là một yêu cầu REST thật được tính phí, do đó mức sử dụng sẽ xuất hiện tại mục Mức sử dụng giống hệt cuộc gọi API trực tiếp.

Chạy server

npx @crawlpipe/mcp

Không cần bước cài đặt đối với hầu hết các MCP client — chúng sẽ gọi npx theo yêu cầu.

Cấu hình

Server đọc hai biến môi trường:

BiếnBắt buộcÝ nghĩa
CRAWLPIPE_API_KEYCóKhóa API lấy từ mục Khóa API trong portal (cp_live_…)
CRAWLPIPE_BASE_URLKhôngGhi đè URL gốc của API (mặc định là https://api.crawlpipe.com) — hữu ích khi phát triển tại địa phương với http://localhost:8000

Ví dụ cấu hình cho Claude Desktop / Claude Code:

{
  "mcpServers": {
    "crawlpipe": {
      "command": "npx",
      "args": ["-y", "@crawlpipe/mcp"],
      "env": {
        "CRAWLPIPE_API_KEY": "cp_live_a1b2c3d4e5f6…"
      }
    }
  }
}

Hoặc qua Claude Code CLI:

claude mcp add crawlpipe -e CRAWLPIPE_API_KEY=cp_live_... -- npx -y @crawlpipe/mcp

Cấu hình cho Cursor / Codex / VS Code Extensions (Roo Code, Cline):

Thêm vào file cấu hình MCP của client (ví dụ cline_mcp_settings.json hoặc cài đặt Cursor MCP):

{
  "mcpServers": {
    "crawlpipe": {
      "command": "npx",
      "args": ["-y", "@crawlpipe/mcp"],
      "env": {
        "CRAWLPIPE_API_KEY": "cp_live_a1b2c3d4e5f6…"
      }
    }
  }
}

Cấu hình cho ChatGPT:

  • ChatGPT Desktop App / MCP Client: Dùng cấu hình mcpServers định dạng JSON ở trên cho ứng dụng Desktop hỗ trợ MCP.
  • ChatGPT Web / Custom GPT Actions: Nhập trực tiếp cấu hình OpenAPI specification tại https://api.crawlpipe.com/openapi.json và thêm Header xác thực X-API-Key: cp_live_a1b2c3d4e5f6….

Các công cụ (Tools)

Công cụÁp dụng REST
legal_search(q, mode?, filters?)GET /v1/legal/search
legal_get_document(id, at?, include?)GET /v1/legal/documents/{id}
legal_get_effectivity(id, at?)GET /v1/legal/documents/{id}/effectivity
legal_get_relations(id, direction?, types?)GET /v1/legal/documents/{id}/relations
legal_changes(since, filters?)GET /v1/legal/changes
crawlpipe_usage()GET /v1/usage

Mô tả công cụ được viết cho AI agent tiêu thụ — chúng bao gồm các danh mục từ vựng (doc_type, eff_status, relation_type, …) và hướng dẫn trích dẫn tương tự RAG với API tìm kiếm, giúp agent khi gọi legal_search có ngay kết quả sẵn sàng trích dẫn mà không cần nhắc thêm.

Tính phí (Metering)

Do MCP server gọi cùng một REST API với khóa của bạn, mỗi lần gọi công cụ đều được tính phí chính xác như cuộc gọi REST tương đương — legal_search với mode: "hybrid" cũng tốn 2 đơn vị qua MCP. Không có bảng giá hay hạn mức MCP riêng biệt.

Cài đặt MCP — CrawlPipe Docs