Orcha

Orcha MCP サーバー

Orcha は、AI ツールとエージェント向けの統合コンテキストレイヤーです。組織、チーム、個人のナレッジを保存、インデックス化し、公開します。ファイル、構造化データベース、接続済みのソースを1つのワークスペースにまとめ、エージェントは権限、引用、来歴情報を伴って、Model Context Protocol（MCP）、仮想ファイルシステムを備えた CLI、または REST API を通じてアクセスできます。

このリポジトリは、Orcha のホスト型 MCP サーバー向けの公開接続ガイドおよびレジストリ掲載情報です。サービスは以下で稼働しています。

https://app.tryorcha.com/mcp

トランスポートは Streamable HTTP です。アプリケーションのソースコードは非公開です。このサーバーの利用にあたり、このリポジトリからインストールやビルドを行う必要はありません。

サーバーが提供する機能

以下の30個のツールを提供します。

• エージェント自身が参照できる利用ガイド（get_usage_guide）。ツールの選択、検索の調整、引用、書き戻し、トラブルシューティングを網羅しています
• インデックス化されたすべてのワークスペースコンテンツを対象とした、順位付けされた検索（search_context）。高速、バランス、新鮮さ重視のルーティングモードに対応し、すべての結果に引用が付属します
• 接続に許可された範囲内での、ファイルやフォルダーの読み取り、作成、更新、整理、削除
• 利用方法のガイダンスを含む厳選されたメモリ（list_memories、get_memory）。ファイル、フォルダー、同期されたドキュメント、データベースビューを対象とした、エージェント側での整理（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 の2ツール検索コントラクト（search、fetch）。開発者モード以外で、チャット、ディープリサーチ、企業ナレッジが使用します

各接続は、その接続に付与された組織、ワークスペース、権限、任意のフォルダースコープに限定されます。

また、サーバーは草案段階の io.modelcontextprotocol/skills 拡張を使って、利用ガイドを Agent Skills として提供します。skills/list で一覧を取得でき、各ファイルは skill://orcha/<name>/<path> から読み取れます。Skills に対応していないクライアントでも、get_usage_guide ツールから同じ内容を取得できます。

OAuth で接続する（推奨）

OAuth 対応の MCP クライアントにサーバー URL を追加してください。クライアントが 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 では JSON ではなく TOML を使います。信頼できるプロジェクトでは ~/.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 の4つの利用ガイドをそこにインストールできます。これらは get_usage_guide からインストール不要で利用できます。

Cursor やその他の OAuth 対応クライアント：同じ URL を使ってリモート MCP サーバーを追加し、サインインの案内に従ってください。

Claude Code、ChatGPT、Codex のユーザーは、代わりに以下のプラグインをインストールできます。接続方法は同じで、利用ガイドがスキルとして追加されます。

ベアラートークンで接続する（ヘッドレスクライアントおよび CI クライアント向け）

1. app.tryorcha.com/signup で Orcha アカウントとワークスペースを作成します。
2. そのワークスペースをスコープとし、クライアントが必要とする権限だけを付与した API トークンを作成します。トークンの先頭には orca_ が付きます。
3. Authorization ヘッダーを使ってクライアントを設定します。

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

プロンプトの例

• "ワークスペースを検索して、現在の認証要件を見つけ、ソースファイル名とともに要約してください。"
• "デプロイ手順書に最も関連するファイルを5つ表示してください。"
• "このタスクに該当するOrchaのメモリを確認し、最も適切なものを信頼できる情報源として使用してください。"
• "これらのリリース要件から、launch-checklist.mdという名前のMarkdownファイルを作成してください。"
• "engineering-onboardingメモリを取得し、矛盾するガイダンスがないか確認してください。"

Claude Codeプラグイン

Claude Codeでは、接続設定と使用ガイドをまとめてインストールできます。

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

プラグインには独自のサーバー設定が含まれているため、上記のclaude mcp addの手順を実行する代わりに使用します。また、4つの使用ガイドをスキルとしてインストールするため、タスクに応じてClaudeが該当するガイドを読み込みます。詳細はplugins/orchaを参照してください。

OpenAIプラグイン（ChatGPTとCodex）

同じplugins/orchaディレクトリは、移植可能なOpenAIプラグインでもあります。ルートのplugin.json、OAuth動的クライアント登録でサーバーを指定するmcp.json、スキルとしての4つの使用ガイド、そしてインストール後に実行され、接続済みのワークスペースを確認するsetupスキルが含まれています。共有のChatGPTおよびCodexプラグインディレクトリに登録されたら、そこからインストールしてください。Codexでは、現在このリポジトリからインストールできます。

codex plugin marketplace add westonhancock/orcha-mcp

次に/pluginsを開き、orchaマーケットプレイスを選択してインストールします。マーケットプレイスファイルは.agents/plugins/marketplace.jsonです。

どちらのプラグインも、それぞれのクライアントでの利用を簡単にするものです。それ以外のクライアントも、get_usage_guideを通じてサーバーから同じガイダンスを取得できます。

レジストリへの掲載

このサーバーは、Official MCP Registryにio.github.westonhancock/orchaとして公開されています。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]