Omnara MCP Server

什么是 Omnara MCP Server？

Omnara MCP Server 通过 MCP 提供 Omnara API，让 Claude Code、Codex、Cursor 或 Claude 能够以你在控制台中的权限启动 Omnara 智能体、给它们发消息、跟踪进度，并管理 profile、密钥和机器。

Omnara 是一个开源（Apache 2.0）平台，用于为你的用户和团队部署和运行有状态的 AI 智能体，定位为 Claude Managed Agents 的替代方案。智能体可以运行在任何模型上（自带 OpenAI、Anthropic、OpenRouter、Bedrock 或自托管模型的 key），运行在 Omnara 托管的沙箱或你自己的机器上，并配有内置工具、MCP 服务器、技能、记忆存储、子智能体和审批控制。MCP 服务器与 REST API、TypeScript SDK 和 CLI 一起成为操作该平台的方式之一；它在官方 MCP Registry 中的名称为 com.omnara/omnara。

如何使用 Omnara MCP Server？

你需要一个 Omnara 账号。支持 MCP 授权规范的 MCP 客户端会自动发现 Omnara 的 OAuth 端点并通过浏览器为你登录，因此无需粘贴 token。首次使用时，客户端会打开 Authorize access to Omnara 页面；批准后，客户端会自行保存并刷新短期 token。

https://app.omnara.com/mcp

Claude Code

来自 Omnara 文档：

claude mcp add --transport http omnara https://app.omnara.com/mcp

然后通过 /mcp 登录。

Claude Desktop 和 claude.ai

从 Claude 的连接器目录中添加 Omnara，或者进入 Settings → Connectors → Add custom connector 粘贴 URL，然后在浏览器中批准访问。

Cursor

Omnara 提供的通用 mcp.json 条目可用于 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "omnara": {
      "type": "http",
      "url": "https://app.omnara.com/mcp"
    }
  }
}

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "omnara": {
      "type": "http",
      "url": "https://app.omnara.com/mcp"
    }
  }
}

Codex

codex mcp add omnara --url https://app.omnara.com/mcp
codex mcp login omnara

不支持 OAuth 的客户端可以改为在 Authorization: Bearer 请求头中发送个人访问令牌或组织 API key。

Omnara MCP Server 的主要功能

• Omnara API 的官方服务器，支持 OAuth 登录和自动刷新 token。
• 从另一个智能体启动 Omnara 智能体并给它们发送消息。
• 不离开编码工具即可跟踪智能体进度。
• 以你在控制台中的同等权限管理 profile、密钥和机器。
• 登录后的客户端在你所属的所有组织中代表你操作；使用 member 角色的组织 API key 可以将其限制在特定项目。
• 可与 Omnara 的设置技能（omnara.com/SKILL.md）配合使用，该技能会指示编码智能体在 MCP 工具可用时优先使用它们。

Omnara MCP Server 的使用场景

• 在编辑器中部署智能体：“阅读 omnara.com/SKILL.md，为客服分流设置一个 Omnara 智能体。”
• 委派长任务：“启动一个 Omnara 智能体研究这个 bug 并汇报结果。”
• 查看运行中的工作：“我今天早上启动的智能体现在是什么状态？”
• 配置基础设施：“为 SRE 智能体创建一个 profile，并附加 AWS 只读密钥。”
• 管理机器：“列出我的 Omnara 机器，告诉我哪些处于空闲状态。”

Omnara MCP Server 常见问题排查

• 工具因授权错误而失败。 在客户端中完成该 MCP 服务器的浏览器授权；Omnara 的技能会让智能体反复调用 whoami 直到成功。
• 需要 Slack、Discord 或 GitHub 集成。 MCP 服务器没有集成相关的工具；这些步骤请登录 Omnara CLI（npx omnara login）完成。
• 希望客户端只访问一个项目。 使用仅在该项目上拥有角色的 member 角色组织 API key，而不是登录会话。
• token 泄露了。 在 Personal tokens 页面撤销它；撤销是永久性的。