Máy chủ PandaNpc MCP kết nối một agent lập trình tương thích MCP với cơ sở tri thức PandaNote, nhật ký công việc, tác vụ theo lịch, cấu hình mô hình và Agent Service Center của bạn. Nó hữu ích khi một agent cần ngữ cảnh dự án bền vững thay vì bắt đầu từ một cuộc trò chuyện trống mỗi lần.
Máy chủ chạy cục bộ qua giao thức đầu vào/đầu ra chuẩn của MCP. MCP client của bạn khởi động tiến trình pandanpc-mcp khi một phiên mở; bạn không cần mở cổng hoặc chạy một máy chủ web riêng.
Trước khi cài đặt
Bạn cần:
- Node.js và npm có sẵn trong cùng môi trường nơi MCP client chạy.
- Một tài khoản PandaNpc có quyền truy cập vào địa chỉ email dùng để xác minh.
- Claude Code, OpenAI Codex, Cursor, hoặc một client khác hỗ trợ máy chủ MCP stdio cục bộ.
Nếu bạn muốn agent lên lịch công việc trên một trong các máy tính của mình, hãy cài đặt và kết nối PandaPaw trước. Các công cụ ghi chú và không gian làm việc không yêu cầu thiết bị PandaPaw trực tuyến.
Cài đặt hoặc cập nhật máy chủ MCP
Cài đặt gói trên toàn hệ thống trên macOS, Linux hoặc Windows:
npm install -g @pandanpc/mcp-serverXác nhận rằng tệp thực thi có thể được shell của bạn thấy:
pandanpc-mcp --helpChạy lại lệnh npm tương tự bất cứ khi nào bạn muốn cập nhật. Khởi động lại MCP client sau khi cập nhật vì một client đang chạy giữ phiên bản tiến trình mà nó đã khởi chạy ban đầu.
Kiểm tra lịch sử phiên bản máy chủ MCP khi một công cụ hoặc hành vi của nó khác với ảnh chụp màn hình hoặc hướng dẫn cũ.
Thêm PandaNpc vào Claude Code
Phương pháp đáng tin cậy nhất là lệnh cấu hình của chính Claude Code. Sử dụng phạm vi user nếu bạn muốn PandaNpc khả dụng trong mọi dự án:
claude mcp add --scope user pandanpc -- pandanpc-mcpSử dụng --scope project khi cấu hình cần được chia sẻ qua kho lưu trữ hiện tại, hoặc --scope local khi nó chỉ áp dụng cho bạn trong dự án hiện tại.
Kiểm tra máy chủ đã đăng ký:
claude mcp get pandanpc
claude mcp listBạn cũng có thể cấu hình máy chủ stdio theo cách thủ công trong cấu hình MCP được sử dụng bởi bản cài đặt Claude Code của bạn:
{
"mcpServers": {
"pandanpc": {
"command": "pandanpc-mcp"
}
}
}Thêm PandaNpc vào OpenAI Codex
Codex có thể đăng ký cùng tiến trình cục bộ từ dòng lệnh:
codex mcp add pandanpc -- pandanpc-mcpXác minh cấu hình đã lưu:
codex mcp get pandanpc
codex mcp listMục tương đương trong ~/.codex/config.toml là:
[mcp_servers.pandanpc]
command = "pandanpc-mcp"Khởi động lại Codex hoặc mở phiên mới sau khi thêm máy chủ. Nếu bạn duy trì một tệp cấu hình Codex tùy chỉnh, hãy đặt bảng MCP trong tệp đó thay vì sao chép nó qua nhiều tệp.
Cấu hình Cursor và các MCP client khác
Đối với Cursor, thêm một máy chủ cục bộ vào ~/.cursor/mcp.json bằng cùng định dạng JSON như đã hiển thị cho Claude Code. Đối với Windsurf và các client khác, tạo một máy chủ MCP stdio có lệnh là pandanpc-mcp và danh sách tham số trống.
Tệp thực thi phải nằm trong PATH mà ứng dụng đồ họa kế thừa. Nếu nó hoạt động trong terminal nhưng client trên máy tính để bàn báo “command not found”, hãy sử dụng đường dẫn tuyệt đối của tệp thực thi được trả về bởi lệnh sau:
command -v pandanpc-mcpTrên Windows PowerShell, sử dụng:
Get-Command pandanpc-mcpĐăng nhập từ agent
PandaNpc sử dụng quy trình xác minh email hai bước. Yêu cầu agent thực hiện các thao tác sau theo thứ tự:
- Gọi
note_loginvới địa chỉ email của bạn. PandaNpc sẽ gửi mã xác minh. - Gọi
note_loginlần nữa với cùng địa chỉ email và mã xác minh.
Thông tin đăng nhập cục bộ được lưu vào bộ nhớ đệm, vì vậy bạn không cần đăng nhập trong mỗi phiên. Không bao giờ dán mã xác minh vào bản ghi công khai hoặc prompt dùng chung.
Xác minh kết nối MCP
Chạy một bài kiểm tra chỉ đọc nhỏ trước khi cho phép agent tạo hoặc chỉnh sửa dữ liệu:
- Yêu cầu nó gọi
list_workspaces. - Yêu cầu nó gọi
list_notescho một workspace. - Yêu cầu nó tìm kiếm một từ khóa vô hại bằng
search_notes.
Phản hồi thành công chứng minh rằng MCP client đã khởi động tiến trình, xác thực hoàn tất và API tài khoản có thể truy cập. Đối với bài kiểm tra ghi, hãy tạo một ghi chú dùng một lần rồi xóa mềm nó.
Danh sách công cụ chính xác được hiển thị bởi MCP client của bạn là nguồn tham chiếu cho phiên bản đã cài đặt. Các công cụ được nhóm theo các quy trình làm việc sau:
| Quy trình | Công cụ điển hình | Hành vi quan trọng |
|---|---|---|
| Ghi chú | list_notes, create_note, read_note, update_note, search_notes |
update_note thay thế toàn bộ nội dung; đọc trước khi chỉnh sửa |
| Nhật ký công việc | save_done |
Tự động lưu công việc đã hoàn thành vào thư mục dự án của ngày hôm nay |
| Không gian làm việc | list_workspaces, create_workspace, update_workspace |
Đường dẫn dự án được liên kết giúp máy chủ tìm đúng workspace |
| Công việc theo lịch | list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs |
Máy PandaPaw phải trực tuyến; biểu thức cron sử dụng sáu trường |
| Nhà cung cấp và mô hình | list_providers, list_models, công cụ tạo/cập nhật/xóa |
Liệt kê trước để sử dụng ID hiện tại và loại mô hình hợp lệ |
| Quy tắc và kỹ năng | sync_rules |
Đồng bộ hóa các hướng dẫn dự án được hỗ trợ trong khi bỏ qua các tệp không thay đổi |
Để biết định nghĩa trường nhà cung cấp và mô hình, xem Nhà cung cấp AI tùy chỉnh và API key. Để biết ranh giới tài khoản và thanh toán, xem Tài khoản, gói và chi phí API PandaNpc.
Các phương pháp vận hành an toàn
- Bắt đầu bằng các công cụ list, read hoặc search trước khi tạo, cập nhật, xóa hoặc lên lịch hành động.
- Đọc ghi chú trước khi cập nhật vì việc cập nhật ghi chú thay thế toàn bộ tài liệu Markdown thay vì áp dụng một bản vá.
- Xem các prompt theo lịch như các yêu cầu thực thi mã: xác nhận máy đích, thư mục làm việc, múi giờ và biểu thức cron sáu trường.
- Giữ API key của nhà cung cấp ngoài prompts và ghi chú. Chỉ nhập bí mật thông qua quy trình cấu hình nhà cung cấp đã định.
- Xem lại thẻ phê duyệt công cụ MCP trước khi cho phép các hành động phá hủy hoặc bên ngoài.
- Sử dụng
save_donecho nhật ký công việc thay vì tự đoán đúng workspace và thư mục ngày.
Xử lý sự cố
Client báo không tìm thấy `pandanpc-mcp`
Mở một terminal mới sau khi cài đặt và kiểm tra đường dẫn tệp thực thi. Các ứng dụng desktop đôi khi kế thừa một PATH cũ hơn; hãy cấ hình đường dẫn tuyệt đối hoặc khởi động lại ứng dụng. Nếu npm được cài đặt thông qua trình quản lý phiên bản, hãy đảm bảo MCP client khởi động dưới cùng người dùng và môi trường.
Máy chủ đã đăng ký nhưng không có công cụ nào xuất hiện
Khởi động lại client, sau đó kiểm tra claude mcp get pandanpc hoặc codex mcp get pandanpc. Xóa và thêm lại mục nếu lệnh sai. Cũng kiểm tra rằng bạn không cấu hình tiến trình stdio cục bộ như một URL HTTP.
Các công cụ báo bạn chưa xác thực
Lặp lại hai lần gọi note_login. Sử dụng mã xác minh mới nhất, kiểm tra thư mục spam và xác nhận rằng cả hai lần gọi đều dùng cùng một địa chỉ email.
Tác vụ theo lịch không thể tìm thấy máy
Gọi list_scheduled_bridges trước. Nếu nó trả về không có thiết bị khả dụng, hãy xác minh trạng thái PandaPaw và kết nối thiết bị trên máy đích. Một máy đang tắt nguồn, ngủ, đăng xuất hoặc ngắt kết nối không thể bắt đầu một lần chạy theo lịch.
Cập nhật ghi chú đã xóa văn bản hiện có
update_note chấp nhận toàn bộ nội dung thay thế. Khôi phục ghi chú từ lịch sử hoặc thùng rác nếu có, sau đó đọc nội dung hiện tại và gửi tài liệu đã kết hợp.
Cần trợ giúp cụ thể cho tài khoản? Liên hệ support@pandanpc.com và cung cấp tên MCP client, hệ điều hành, phiên bản gói và thông báo lỗi chính xác mà không chứa bí mật.