Máy chủ MCP

Perch có thể kết nối với hệ thống bên ngoài qua Model Context Protocol, hay MCP. Điều này cho phép Perch truy cập dữ liệu và công cụ không phải tệp trên ổ đĩa của bạn: cơ sở dữ liệu pháp lý, tự động hóa trình duyệt, API nội bộ, bất kỳ hệ thống nào dùng MCP. Công cụ từ các máy chủ đã kết nối xuất hiện bên cạnh công cụ tích hợp của Perch, và mô hình có thể gọi trực tiếp.

Những gì đi kèm mặc định

Khi bạn khởi chạy Perch Terminal Desktop lần đầu, nó tạo tệp cấu hình tại ~/.perch/mcp.json với hai máy chủ đã được cấu hình:

• CourtListener. Máy chủ nghiên cứu pháp lý có thể tìm kiếm án lệ, tra cứu trích dẫn, truy xuất văn bản ý kiến của tòa, tìm vụ án liên quan và lấy các mục trong sổ theo dõi vụ án. Nó kết nối với cơ sở dữ liệu CourtListener, bao phủ các tòa án liên bang và tiểu bang. Có token API đi kèm, nên hoạt động ngay lần khởi chạy đầu tiên mà không cần cấu hình.
• Playwright. Máy chủ tự động hóa trình duyệt được cố định ở một phiên bản @playwright/mcp đã kiểm thử. Đây là nền tảng cho việc bàn giao qua trình duyệt của Perch: điều hướng trang, nhấp phần tử, nhập vào trường và đọc nội dung trên màn hình.

Bạn không cần cài đặt hay cấu hình máy chủ nào trong hai máy chủ này. Chúng tự kết nối khi Perch khởi động.

Cách công cụ được đưa đến mô hình

Khi máy chủ MCP kết nối, Perch đọc danh sách công cụ của nó và chuyển từng công cụ thành định nghĩa dành cho mô hình. Quy ước đặt tên là mcp__<serverName>__<toolName>. Ví dụ, công cụ tìm kiếm vụ án của CourtListener trở thành mcp__courtlistener__search_cases và xuất hiện bên cạnh các công cụ tích hợp như readLocalFile hoặc webSearch.

Mô hình coi những công cụ này là công cụ chính thức. Nó có thể gọi chúng trong cùng vòng lặp như mọi công cụ khác, và kết quả trả về dưới dạng nội dung có cấu trúc mà Perch có thể trích dẫn và dùng để hành động.

Cấu hình toàn cục và theo thư mục

Máy chủ MCP có thể được cấu hình ở hai cấp:

• Toàn cục. Tệp tại ~/.perch/mcp.json áp dụng cho mọi phiên Perch trên máy tính của bạn. Đây là nơi cấu hình các máy chủ mặc định.
• Theo thư mục. Tệp .perch/mcp.json trong thư mục không gian làm việc chỉ áp dụng khi bạn làm việc trong thư mục đó. Cấu hình thư mục ghi đè cấu hình toàn cục theo tên máy chủ, để bạn có thể thay máy chủ toàn cục bằng máy chủ khác cho một dự án cụ thể.

Có hỗ trợ thay thế biến môi trường bằng giá trị. Nếu máy chủ cần khóa API, bạn có thể tham chiếu bằng ${YOUR_API_KEY} trong cấu hình và Perch sẽ lấy giá trị từ môi trường của bạn.

Thêm máy chủ của riêng bạn

Để thêm máy chủ MCP, sửa ~/.perch/mcp.json (cho cấu hình toàn cục) hoặc .perch/mcp.json trong thư mục không gian làm việc (cho một dự án cụ thể). Cấu trúc như sau:

{
  "servers": {
    "my-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@some-org/some-mcp-server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

Có ba loại truyền tải được hỗ trợ:

• stdio. Chạy một tiến trình cục bộ. Cần command, với args và env tùy chọn.
• http. Kết nối với điểm cuối HTTP từ xa. Cần url, với headers tùy chọn.
• sse. Kết nối với điểm cuối SSE từ xa. Cần url, với headers tùy chọn.

Sau khi sửa cấu hình, khởi động lại Perch hoặc chạy lệnh kết nối lại. Máy chủ mới kết nối ở lần khởi chạy tiếp theo.

Vai trò của MCP

MCP dành cho các hệ thống đang hoạt động không thể biểu diễn bằng tệp trong thư mục. Nếu dữ liệu đã nằm trên ổ đĩa của bạn dưới dạng bảng tính, PDF hoặc CSV, Perch đọc trực tiếp qua cầu nối thư mục. MCP dành cho những thứ còn lại: cơ sở dữ liệu bên ngoài, API và dịch vụ cần tiến trình đang chạy hoặc xác thực.

Operator và các agent→

Cách Perch vượt ra ngoài chat để đọc tệp, chạy phân tích và phối hợp các agent thực thi.

Bảo mật và dữ liệu→

Cách Perch xử lý tệp, dữ liệu của bạn và những gì được xử lý bên ngoài thiết bị.