跳到主要内容
AI教程

使用 ORC8R MCP 插件将 Claude 连接到 ORC8R Cloud

本教程介绍如何安装 ORC8R Claude 插件、通过其远程 MCP 服务器进行身份验证、控制读写权限、使用内置管理技能,以及连接自托管的 ORC8R 服务器。

使用 ORC8R MCP 插件将 Claude 连接到 ORC8R Cloud

ORC8R Claude 插件的功能

ORC8R 插件通过位于 https://orc8r.com/mcp 的远程模型上下文协议(MCP)服务器,将 Claude 连接到 ORC8R Cloud。

完成身份验证后,Claude 可以使用授予你账户的权限来操作 ORC8R 资源。该插件还包含一项简短技能,可帮助 Claude 查找操作、检查其输入并报告结果。

该插件作为插件源发布在这个公开的 GitHub 仓库中,并非 Anthropic 目录中的条目。

主要功能

  • 通过远程 MCP 服务器将 Claude 连接到 ORC8R Cloud。
  • 支持在 Claude.ai、Claude Desktop 和 Claude Code 中安装。
  • 包含 orc8r 连接器和 ORC8R 管理技能。
  • 使用 OAuth 登录和授权,不会在插件中存储 API 密钥或用户凭据。
  • 默认支持读取权限,也可通过授权页面选择性启用写入权限。
  • 可通过自定义 MCP 连接器配置为连接自托管的 ORC8R 服务器。

在 Claude.ai 或 Claude Desktop 中安装插件

  1. 打开自定义 → 插件 → 添加 → 添加市场。
  2. 输入仓库 URL:https://github.com/admte/orc-claude-plugin。
  3. 从市场中添加ORC8R插件。
  4. 打开插件的连接器选项卡。
  5. 添加或连接 orc8r。
  6. 登录 ORC8R,并批准要授予的 OAuth 权限范围。

在 Team 和 Enterprise 计划中,Owner 可能需要先为组织添加该连接器,用户才能进行连接。

在 Claude Code 中安装插件

使用 Claude Code CLI 添加市场并安装插件:

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

启动新的 Claude Code 会话。运行 /mcp,然后在提示时为 plugin:orc8r:orc8r 完成身份验证。

进行身份验证并控制访问权限

ORC8R 要求每位用户登录并批准访问权限。授权页面始终授予 orc:read,允许执行读取操作。如需允许更改,还应选择 orc:write。

访问权限还受你现有的组织权限限制。换言之,该插件不会绕过已分配给 ORC8R 账户的权限。

插件中不包含 API 密钥或用户凭据。

基本用法

询问有关 ORC8R 资源的问题

连接器完成身份验证后,你可以询问 Claude 有关 ORC8R 资源的信息。例如:

我可以访问哪些 ORC8R 资源?

Claude 可以使用已连接的 ORC8R 工具来调查经过身份验证的账户可用的资源,但仍受已批准的权限范围和组织权限限制。

运行 ORC8R 管理技能

在 Claude Code 中,使用以下命令运行内置管理技能:

/orc8r:manage-orc8r

该技能旨在帮助 Claude 查找可用操作、检查这些操作所需的输入,并报告操作结果。

自托管 ORC8R 的高级配置

默认情况下,此插件连接到位于 https://orc8r.com/mcp 的 ORC8R Cloud。如果你运行的是自托管 ORC8R 服务器,请勿使用云端点。请改为将服务器的 MCP 端点添加为自定义连接器:

https://<your-server>/mcp

将 <your-server> 替换为 ORC8R 安装实例的主机名,然后根据服务器配置通过连接器完成身份验证。

实用提示

  • 首先仅批准 orc:read 以使用只读访问权限,尤其是在首次测试连接时。
  • 仅在 Claude 需要进行更改时授予 orc:write。
  • 在 Claude Code 中使用 /mcp 检查并验证 MCP 连接。
  • 对于组织部署,如果 Team 或 Enterprise 工作区有此要求,请联系 Owner 添加连接器。
  • 查看 ORC8R MCP 文档,了解可用工具、权限范围以及撤销连接的说明。
  • 阅读 ORC8R 隐私页面,了解 ORC8R 如何处理通过其服务发送的数据。

仓库结构

  • plugins/orc8r/ 包含可安装的 Claude 插件,包括其 MCP 配置和技能。
  • .claude-plugin/marketplace.json 提供用于从此仓库安装插件的市场目录。

结论

ORC8R Claude 插件提供了通过 MCP 将 Claude 直接连接到 ORC8R 的方式。从仓库安装插件,验证 orc8r 连接器,然后使用 Claude 检查资源或运行内置管理工作流。为实现更安全的访问控制,请先使用读取权限,仅在需要时添加写入权限。