Chuyển đến nội dung chính
Hướng dẫn AI

Kết nối Claude với ORC8R Cloud bằng Plugin ORC8R MCP

Hướng dẫn này giải thích cách cài đặt plugin ORC8R cho Claude, xác thực thông qua máy chủ MCP từ xa, kiểm soát quyền đọc và ghi, sử dụng kỹ năng quản lý đi kèm và kết nối với máy chủ ORC8R tự lưu trữ.

Kết nối Claude với ORC8R Cloud bằng Plugin ORC8R MCP

Plugin ORC8R cho Claude thực hiện những gì

Plugin ORC8R kết nối Claude với ORC8R Cloud thông qua máy chủ Model Context Protocol (MCP) từ xa tại https://orc8r.com/mcp.

Sau khi xác thực, Claude có thể làm việc với các tài nguyên ORC8R của bạn bằng quyền truy cập được cấp cho tài khoản. Plugin cũng bao gồm một kỹ năng ngắn giúp Claude tìm các thao tác, kiểm tra thông tin đầu vào và báo cáo kết quả.

Plugin được phân phối từ kho GitHub công khai này dưới dạng nguồn plugin. Đây không phải là danh sách plugin của Anthropic.

Tính năng chính

  • Kết nối Claude với ORC8R Cloud thông qua máy chủ MCP từ xa.
  • Hỗ trợ cài đặt trong Claude.ai, Claude Desktop và Claude Code.
  • Bao gồm trình kết nối orc8r và kỹ năng quản lý ORC8R.
  • Sử dụng đăng nhập và chấp thuận OAuth thay vì lưu khóa API hoặc thông tin đăng nhập người dùng trong plugin.
  • Mặc định hỗ trợ quyền đọc và cho phép tùy chọn quyền ghi thông qua màn hình chấp thuận.
  • Có thể cấu hình cho máy chủ ORC8R tự lưu trữ bằng trình kết nối MCP tùy chỉnh.

Cài đặt Plugin trong Claude.ai hoặc Claude Desktop

  1. Mở Tùy chỉnh → Plugin → Thêm → Thêm marketplace.
  2. Nhập URL kho lưu trữ: https://github.com/admte/orc-claude-plugin.
  3. Thêm plugin ORC8R từ marketplace.
  4. Mở tab Trình kết nối của plugin.
  5. Thêm hoặc kết nối orc8r.
  6. Đăng nhập vào ORC8R và chấp thuận các phạm vi OAuth bạn muốn cấp.

Trong các gói Team và Enterprise, Chủ sở hữu có thể cần thêm trình kết nối cho tổ chức trước khi người dùng có thể kết nối.

Cài đặt Plugin trong Claude Code

Sử dụng CLI của Claude Code để thêm marketplace và cài đặt plugin:

claude plugin marketplace add admte/orc-claude-plugin
claude plugin install orc8r@orc-claude-plugin

Bắt đầu một phiên Claude Code mới. Chạy /mcp, sau đó xác thực plugin:orc8r:orc8r khi được nhắc.

Xác thực và kiểm soát quyền truy cập

ORC8R yêu cầu mỗi người dùng đăng nhập và chấp thuận quyền truy cập. Trang chấp thuận luôn cấp orc:read, cho phép thực hiện các thao tác đọc. Để cho phép thay đổi, hãy chọn thêm orc:write.

Quyền truy cập cũng bị giới hạn bởi các quyền hiện có trong tổ chức của bạn. Nói cách khác, plugin không vượt qua các quyền đã được gán cho tài khoản ORC8R của bạn.

Plugin không chứa khóa API hoặc thông tin đăng nhập người dùng.

Sử dụng cơ bản

Hỏi về tài nguyên ORC8R

Sau khi trình kết nối được xác thực, bạn có thể hỏi Claude về các tài nguyên ORC8R của mình. Ví dụ:

Tôi có thể truy cập những tài nguyên ORC8R nào?

Claude có thể sử dụng các công cụ ORC8R đã kết nối để tìm hiểu các tài nguyên khả dụng cho tài khoản đã xác thực của bạn, tùy thuộc vào phạm vi đã chấp thuận và quyền trong tổ chức.

Chạy kỹ năng quản lý ORC8R

Trong Claude Code, chạy kỹ năng quản lý đi kèm bằng lệnh:

/orc8r:manage-orc8r

Kỹ năng này giúp Claude tìm các thao tác khả dụng, kiểm tra thông tin đầu vào mà các thao tác đó yêu cầu và báo cáo kết quả.

Thiết lập nâng cao cho ORC8R tự lưu trữ

Theo mặc định, plugin này kết nối với ORC8R Cloud tại https://orc8r.com/mcp. Nếu bạn vận hành máy chủ ORC8R tự lưu trữ, không sử dụng điểm cuối đám mây. Thay vào đó, hãy thêm điểm cuối MCP của máy chủ dưới dạng trình kết nối tùy chỉnh:

https://<your-server>/mcp

Thay <your-server> bằng tên máy chủ của hệ thống ORC8R, sau đó xác thực thông qua trình kết nối theo cấu hình máy chủ của bạn.

Mẹo thực tế

  • Bắt đầu với quyền chỉ đọc bằng cách chỉ chấp thuận orc:read, đặc biệt khi lần đầu kiểm tra kết nối.
  • Chỉ cấp orc:write khi Claude cần thực hiện thay đổi.
  • Sử dụng /mcp trong Claude Code để xem xét và xác thực kết nối MCP.
  • Đối với các triển khai tổ chức, hãy yêu cầu Chủ sở hữu thêm trình kết nối nếu không gian làm việc Team hoặc Enterprise của bạn yêu cầu.
  • Xem tài liệu ORC8R MCP để biết các công cụ, phạm vi khả dụng và hướng dẫn thu hồi kết nối.
  • Đọc trang Quyền riêng tư ORC8R để hiểu cách ORC8R xử lý dữ liệu được gửi qua dịch vụ.

Cấu trúc kho lưu trữ

  • plugins/orc8r/ chứa plugin Claude có thể cài đặt, bao gồm cấu hình MCP và kỹ năng.
  • .claude-plugin/marketplace.json cung cấp danh mục marketplace được sử dụng để cài đặt plugin từ kho lưu trữ này.

Kết luận

Plugin ORC8R cho Claude cung cấp cách thức trực tiếp để kết nối Claude với ORC8R thông qua MCP. Hãy cài đặt plugin từ kho lưu trữ, xác thực trình kết nối orc8r và sử dụng Claude để kiểm tra tài nguyên hoặc chạy quy trình quản lý đi kèm. Để kiểm soát quyền truy cập an toàn hơn, hãy bắt đầu với quyền đọc và chỉ thêm quyền ghi khi cần.