Omnara MCP Server

Omnara MCP Server とは？

Omnara MCP Server は Omnara API を MCP 経由で公開するサーバーです。Claude Code、Codex、Cursor、Claude から、ダッシュボードと同じ権限で Omnara のエージェントを起動し、メッセージを送り、進捗を追い、プロファイル・シークレット・マシンを管理できます。

Omnara は、ユーザーやチームのためにステートフルな AI エージェントをデプロイして実行するオープンソース（Apache 2.0）のプラットフォームで、Claude Managed Agents の代替として位置付けられています。エージェントは任意のモデル（OpenAI、Anthropic、OpenRouter、Bedrock、セルフホストのキーを持ち込み）で、Omnara 管理のサンドボックスまたは自前のマシン上で動き、組み込みツール、MCP サーバー、スキル、メモリストア、サブエージェント、承認コントロールを備えています。MCP サーバーは REST API、TypeScript SDK、CLI と並ぶプラットフォームの操作手段で、公式 MCP Registry に com.omnara/omnara として登録されています。

Omnara MCP Server の使い方

Omnara のアカウントが必要です。MCP の認可仕様に対応したクライアントは Omnara の OAuth エンドポイントを自動で見つけ、ブラウザでサインインさせるため、トークンを貼り付ける必要はありません。初回利用時にクライアントが Authorize access to Omnara ページを開くので承認すると、クライアントは短期トークンを保存し、バックグラウンドで更新します。

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 に対応していないクライアントは、代わりに個人アクセストークンまたは組織 API キーを Authorization: Bearer ヘッダーで送信できます。

Omnara MCP Server の主な機能

• OAuth サインインとトークン自動更新に対応した Omnara API の公式サーバー。
• 別のエージェントから Omnara のエージェントを起動し、メッセージを送信。
• コーディングツールを離れずにエージェントの進捗を追跡。
• ダッシュボードと同じ権限でプロファイル、シークレット、マシンを管理。
• サインインしたクライアントは所属するすべての組織であなたとして動作します。member ロールの組織 API キーを使えば特定のプロジェクトに限定できます。
• Omnara のセットアップスキル（omnara.com/SKILL.md）と連携し、MCP ツールが接続されていればそれを使うようコーディングエージェントに指示します。

Omnara MCP Server のユースケース

• エディターからのエージェントのデプロイ：「omnara.com/SKILL.md を読んで、サポートの振り分け用に Omnara エージェントをセットアップして。」
• 長時間タスクの委任：「このバグを調査して報告する Omnara エージェントを起動して。」
• 実行中の作業の確認：「今朝起動したエージェントの状況は？」
• インフラの設定：「SRE エージェント用のプロファイルを作成して、AWS の読み取り専用シークレットを付けて。」
• マシンの管理：「Omnara のマシンを一覧して、アイドル状態のものを教えて。」

Omnara MCP Server のトラブルシューティング

• ツールが認可エラーで失敗する。 クライアントでこの MCP サーバーのブラウザ認可を完了してください。Omnara のスキルは、成功するまで whoami を呼ぶようエージェントに指示しています。
• Slack、Discord、GitHub の連携が必要。 MCP サーバーには連携用のツールがありません。これらの手順では Omnara CLI（npx omnara login）にサインインしてください。
• クライアントに 1 つのプロジェクトだけを操作させたい。 サインインのセッションではなく、そのプロジェクトにだけロールを持つ member ロールの組織 API キーを使ってください。
• トークンが漏えいした。 Personal tokens ページから取り消してください。取り消しは元に戻せません。