Orcha

Orcha MCP 服务

Orcha 是 AI 工具和 Agent 的统一上下文层，用于存储、索引和提供组织、团队或个人知识。文件、结构化数据库和已连接的数据源都位于同一工作区中，Agent 可通过 Model Context Protocol (MCP)、带虚拟文件系统的命令行或 REST API 访问这些内容，并获得权限控制、引用和来源信息。

本仓库是 Orcha 托管 MCP 服务的公开连接指南和注册信息。服务运行于：

https://app.tryorcha.com/mcp

传输方式为 Streamable HTTP。应用源代码为私有；使用此服务无需从本仓库安装或构建任何内容。

服务提供的功能

涵盖以下内容的 30 个工具：

• Agent 可自行阅读的使用指南（get_usage_guide），涵盖工具选择、搜索优化、引用、写回和故障排除
• 对所有已索引工作区内容进行排序搜索（search_context），支持快速、均衡和最新路由模式，并为每条结果提供引用
• 读取、创建、更新、整理和删除文件与文件夹，操作范围仅限连接获准访问的内容
• 附带使用指南的精选记忆（list_memories、get_memory），包括由 Agent 端整理的记忆（create_memory、update_memory），涵盖文件、文件夹、同步文档和数据库视图
• 使用类型化查询访问结构化数据库（list_databases、query_database、记录 CRUD）
• 直接访问已连接的只读数据源（query_source、fetch_source_document、list_source_documents）
• 采用文件系统形式浏览（browse_context）：可在工作区的虚拟目录树中使用 ls、tree、find、cat、grep 和 stat
• ChatGPT 的双工具检索约定（search、fetch），供聊天、深度研究和公司知识功能在开发者模式之外使用

每个连接都限定于获授权的组织、工作区、权限和可选文件夹范围。

该服务还将使用指南作为 Agent Skills 提供，遵循草案 io.modelcontextprotocol/skills 扩展：skills/list 会列出这些指南，每个文件都可通过 skill://orcha/<name>/<path> 读取。不支持 skills 的客户端可通过 get_usage_guide 工具获取相同内容。

使用 OAuth 连接（推荐）

将服务器 URL 添加到任何支持 OAuth 的 MCP 客户端。客户端会自动发现 Orcha 的授权服务器，并引导你完成授权；授权范围仅限于你批准的组织和工作区。

Claude Code：

claude mcp add --transport http orcha "https://app.tryorcha.com/mcp"

claude.ai 和 Claude Desktop：依次选择 Settings、Connectors、Add custom connector，然后输入 https://app.tryorcha.com/mcp。

Codex 使用 TOML 而非 JSON。将以下内容添加到 ~/.codex/config.toml，或受信任项目中的 .codex/config.toml：

[mcp_servers.orcha]
url = "https://app.tryorcha.com/mcp"
auth = "oauth"

Codex 也会从仓库中的 .agents/skills/ 或全局目录 ~/.agents/skills/ 读取 Agent Skills，因此可以在其中安装 Orcha 的四个使用指南。通过 get_usage_guide 即可获取这些指南，无需安装。

Cursor 和其他支持 OAuth 的客户端：添加具有相同 URL 的远程 MCP 服务，并按提示登录。

Claude Code、ChatGPT 和 Codex 用户也可以改为安装下方的插件， 这些插件会完成相同的连接，并将使用指南作为 skills 添加。

使用 bearer token 连接（无头客户端和 CI 客户端）

1. 在 app.tryorcha.com/signup 创建 Orcha 账号和工作区。
2. 创建一个限定于该工作区的 API token，并且只授予客户端所需的权限。Token 以 orca_ 开头。
3. 为客户端配置 Authorization 标头：

{
  "mcpServers": {
    "orcha": {
      "url": "https://app.tryorcha.com/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer orca_your_token"
      }
    }
  }
}

示例提示词

• “在我的工作区中搜索当前的身份验证要求，并附上源文件名进行总结。”
• “显示与我们的部署运行手册最相关的五个文件。”
• “检查哪些 Orcha 记忆适用于此任务，并将最匹配的内容作为事实依据。”
• “根据这些发布要求创建一个名为 launch-checklist.md 的 Markdown 文件。”
• “获取 engineering-onboarding 记忆，并找出其中是否有相互冲突的指导。”

Claude Code 插件

Claude Code 可以同时安装连接和使用指南：

/plugin marketplace add westonhancock/orcha-mcp
/plugin install orcha@orcha

该插件自带服务配置，因此它会替代上文的 claude mcp add 步骤，而不是在该步骤之后执行。它还会将四份使用指南安装为技能，让 Claude 在任务需要时加载相关指南。详情请参阅 plugins/orcha。

OpenAI 插件（ChatGPT 和 Codex）

同一个 plugins/orcha 目录也是一个可移植的 OpenAI 插件：根目录下的 plugin.json、使用 OAuth 动态客户端注册来指定服务的 mcp.json、四份作为技能的使用指南，以及一个在安装后运行以确认已连接工作区的 setup 技能。将其列入 ChatGPT 和 Codex 共享插件目录后，即可从那里安装。目前 Codex 可以直接从此代码库安装：

codex plugin marketplace add westonhancock/orcha-mcp

然后打开 /plugins，选择 orcha 市场并进行安装。市场文件位于 .agents/plugins/marketplace.json。

这两个插件是为各自客户端提供的便捷方式。其他所有客户端都可以通过 get_usage_guide 从服务获取相同的指导。

注册表条目

该服务已作为 io.github.westonhancock/orcha 发布在 官方 MCP 注册表中。清单文件 server.json 与注册表条目保持一致。机器可读的服务卡位于 https://app.tryorcha.com/.well-known/mcp/server-card.json。

链接

• 产品：tryorcha.com/product
• 文档：tryorcha.com/docs/reference/mcp
• 隐私：tryorcha.com/privacy
• 条款：tryorcha.com/terms
• 支持：[email protected]