Orq.ai MCP Server

Orq.ai MCP Server とは？

Orq.ai MCP Server は Orq.ai 公式のリモート MCP サーバーです。Claude Code、Claude Desktop、Cursor、VS Code、Codex、Warp を Orq.ai のワークスペースにつなぎ、エディターを離れずにエージェント、データセット、実験、評価器、トレースを管理できます。

Orq.ai は LLM アプリケーションの構築と運用のためのプラットフォームで、複数のモデルプロバイダーにまたがる AI ゲートウェイ、マネージドエージェント、評価と実験、オブザーバビリティ、ナレッジベース、ガバナンスを備えています。MCP サーバーは Orq.ai 4.4 でベータとして最初に公開され、現在は 11 カテゴリ 38 個のツールを提供しています。サードパーティの MCP サーバーを Orq のエージェントにつなぐ MCP Portal や MCP Gateway とは別物です。

Orq.ai MCP Server の使い方

Orq.ai のアカウントが必要です。エンドポイントは 2 つの認証方法に対応しています。

• OAuth：Authorization ヘッダーなしでエンドポイントを追加します。OAuth 対応のクライアントがブラウザで Orq.ai のサインインフローを開き、ワークスペースへのアクセスを要求します。
• API キー：Orq.ai ワークスペースのキーを使い、ヘッダー Authorization: Bearer YOUR_ORQ_API_KEY を設定します。

https://my.orq.ai/v2/mcp

Claude Code

Orq.ai のドキュメントより（OAuth）：

claude mcp add --transport http orq https://my.orq.ai/v2/mcp

代わりに API キーを使う場合は --header "Authorization: Bearer YOUR_ORQ_API_KEY" を追加します。

Claude Desktop と claude.ai

Settings → Connectors → Add custom connector を開き、名前を「Orq.ai」にして URL を貼り付け、Orq.ai のサインインを完了します。

Cursor

Orq.ai のドキュメントでは、エンドポイントをリモート HTTP サーバーとして追加し、OAuth の場合はヘッダーを空にするよう案内しています。~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "orq": {
      "url": "https://my.orq.ai/v2/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "orq": {
      "type": "http",
      "url": "https://my.orq.ai/v2/mcp"
    }
  }
}

クライアントに求められたら、ブラウザで OAuth を完了します。

Orq.ai MCP Server の主な機能

• OAuth サインインまたは API キー認証に対応した Orq.ai 公式サーバー。
• エージェント管理：作成、更新（セマンティックバージョニング付き）、呼び出し、レスポンスの取得。
• データセット：データセットの作成と、データポイントの追加・編集・削除（一度に最大 100 件、合成テストデータを含む）。
• 実験：データセットからの実行の作成、実行の一覧、JSON・JSONL・CSV での結果エクスポート。
• 評価器：LLM-as-a-Judge と Python の評価器の作成と更新。
• オブザーバビリティ：フィルター付きのトレースとスパンの一覧、コスト・レイテンシ・トークン・エラーに関するワークスペース分析の照会。
• プロジェクト、プロンプト、エージェントなどのエンティティの横断検索と、ドキュメント検索ツール。
• 同じセッションでのスキルとデプロイメントの管理。

Orq.ai MCP Server のユースケース

• チャットからのエージェント作成：「当社の SaaS 製品に関する質問に答える Support Bot というカスタマーサポートエージェントを、簡潔でプロフェッショナルな口調で作成して。」
• 回帰テスト：「失敗したこの 20 個のプロンプトからデータセットを作り、2 つのモデルを比較する実験を実行して。」
• 本番環境のデバッグ：「昨日から 500 エラーを出しているトレースは？」
• ナレッジベースの不足：「ナレッジベースから何も取得できなかったクエリをすべて一覧して。」
• コスト監視：「リクエストあたりの平均コストは上がっている？どのモデルが支出を押し上げている？」
• 品質ゲート：「回答に価格のでっち上げがないか確認する LLM-as-a-Judge 評価器を追加して。」

Orq.ai MCP Server のトラブルシューティング

• ツールが「API key lacks permission」で失敗する。 API キーを使う場合、各呼び出しはそのキーの権限で実行されます。必要な権限を付与するか、サインインしたユーザーとして実行される OAuth を使ってください。
• 読み取り専用キーなのにデータが書き込まれた。 Orq.ai は、権限チェックがまだすべての書き込みツールをカバーしていないため、読み取り専用キーだけでは完全な安全策にならないと説明しています。エージェントが呼び出せるツールを確認してください。
• update_agent が拒否される。 更新のたびに versionIncrement（major、minor、patch）と versionDescription が必要です。
• MCP ツールでカバーされていない操作が必要。 Orq.ai の CLI はより広い範囲（プロンプト、予算、Webhook など）をカバーし、スクリプトや CI にも向いています。