Ragora

Ragora MCP サーバー

Model Context Protocolを使用して、あらゆる AI アシスタントからナレッジベースを検索できます。

Ragora の MCP サーバーはホスト型クラウドサービスです。ローカルへのインストールは不要です。AI ツールにサーバー URL と API キーを設定するだけで利用できます。

サーバー URL： https://mcp.ragora.app/mcp

クイックスタート

1. API キーを取得する

ragora.appで登録し、Settings > API Keysで API キーを作成します。

2. AI ツールを接続する

Claude Desktop

オプション 1：CLI（推奨）

claude mcp add --transport http ragora https://mcp.ragora.app/mcp \
  --header "Authorization: Bearer sk_live_your_key_here"

オプション 2：設定ファイル

~/Library/Application Support/Claude/claude_desktop_config.json（Mac）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "ragora": {
      "type": "http",
      "url": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add --transport http ragora https://mcp.ragora.app/mcp \
  --header "Authorization: Bearer sk_live_your_key_here"

Cursor

プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "ragora": {
      "type": "http",
      "url": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

VS Code / GitHub Copilot

プロジェクトのルートにある .vscode/mcp.json に追加します。

{
  "mcpServers": {
    "ragora": {
      "type": "http",
      "url": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "ragora": {
      "serverUrl": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

任意の MCP クライアント

Ragora はStreamable HTTPトランスポートを使用します。MCP 互換の任意のクライアントを次のように設定します。

• URL： https://mcp.ragora.app/mcp
• メソッド： POST
• ヘッダー： Authorization: Bearer sk_live_your_key_here

利用可能なツール

ツール	説明
discover_collections	アクセス可能なすべてのナレッジベースを、説明、統計情報、使用例とともに一覧表示します
search	すべてのナレッジベースを一度に検索します
search_collection	タグやメタデータによる任意のフィルターを指定して、名前で特定のコレクションを検索します

ツールのパラメーター

search(query, top_k?)

• query（必須）：自然言語の検索クエリ
• top_k（任意）：返す結果の数（デフォルト：5）

search_collection(collection_name, query, top_k?, custom_tags?, filters?)

• collection_name（必須）：コレクション名またはスラッグ（名前を確認するには discover_collections を使用します）
• query（必須）：自然言語の検索クエリ
• top_k（任意）：結果の数（デフォルト：5）
• custom_tags（任意）：検索対象を絞り込むタグ
• filters（任意）：メタデータフィルター

動的コレクションツール

アクセス可能な各コレクションに対して、そのスラッグを使用した専用ツールが生成されます。

• search_{slug} — バージョン、タグ、フィルターを任意で指定できるセマンティック検索
• get_topic_{slug} — 特定のトピックに関する情報を取得
• list_versions_{slug} — 利用可能なドキュメントのバージョンを一覧表示

たとえば、「Employee Handbook」というコレクションには次のツールが作成されます。

• search_employee_handbook
• get_topic_employee_handbook
• list_versions_employee_handbook

Ragora ダッシュボードの Collection > MCP Settings で、ツール名と説明を設定できます。

使用例

すべてのコレクションを検索：

「ドキュメントから Webhook イベントの処理について検索して」

特定のコレクションを検索：

「従業員ハンドブックで返金ポリシーを調べて」

利用可能なものを確認：

「利用できるワークスペースと、その内容を教えて」

仕組み

Your AI Tool                        Ragora Cloud
┌──────────────────┐               ┌──────────────────┐
│ Claude / Cursor  │   HTTP POST   │  MCP Server      │
│ / VS Code / etc  │──────────────>│  (Streamable HTTP)│
└──────────────────┘    /mcp       └────────┬─────────┘
                                            │
                                   ┌────────▼─────────┐
                                   │  Gateway API      │
                                   │  (Auth + Search)  │
                                   └────────┬─────────┘
                                       ┌────┴────┐
                                       ▼         ▼
                                   Postgres    Qdrant
                                   (metadata)  (vectors)

• ローカルインストール不要 — HTTP 経由で直接接続します
• マルチテナント — アクセス可能なコレクションは API キーによって決まります
• 動的ツール — アクセス可能なコレクションに基づいてツールが生成されます
• ハイブリッド検索 — 高密度検索（E5-Large）と疎検索（BM25）を相互順位融合で組み合わせます

セキュリティ

• すべてのリクエストは Authorization: Bearer ヘッダーを使用して API キーで認証されます
• 各 API キーのアクセス範囲は、ユーザーが所有または購入したコレクションに限定されます
• テナントをまたぐデータアクセスは不可能です。すべてのクエリはアクセス可能なコレクション ID でフィルタリングされます
• API キーをバージョン管理システムにコミットしないでください

トラブルシューティング

問題	解決方法
"Tool not found"	設定を変更した後、AI アプリを再起動してください。API キーが sk_live_ で始まることを確認してください
"Unauthorized"	Authorization: Bearer ヘッダーの形式を確認してください。キーの有効期限が切れていないことを確認してください
結果がありません	ドキュメントがアップロードされ、処理が完了していることを確認してください。より幅広いクエリを試してください
接続がタイムアウトします	インターネット接続を確認してください。https://mcp.ragora.app/health でサーバーの状態を確認してください

リンク

• Ragora — ナレッジベースへの登録と管理
• MCP Integration Guide — ドキュメント全文
• API Keys — API キーの作成
• Model Context Protocol — MCP の仕様

ライセンス

MIT