Calypso Multimodal RAG

Calypso MCP Server

Claude Desktop、Cursor、エージェントのワークフロー向けのホスト型マルチモーダル RAGを、1つの npx コマンドで。

PDF、スクリーンショット、グラフ、図にまたがって質問し、新しい資料をアップロードできます。ベクトルストアやDockerスタック、OCRパイプラインを実行する必要はありません。回答には確認可能な引用が付いています。

このサーバーは Calypso Context のインターフェースです。WhatsApp上のCalypsoを支えるものと同じナレッジレイヤーを、MCPクライアントに公開します。各要素の関係を見る →

• コマンド1つでセットアップ：npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-your-key-here
• 真のマルチモーダルRAG：Gemini File Searchを通じて、テキストとビジュアルをネイティブに処理します
• アップロードとクエリ：永続的なナレッジファイルと一括アップロードに特化したツール
• 複数ターンの会話：/new でリセットできる、コンテキストを考慮した回答
• 見つけやすいワークフロー：安全なRAG、アップロード、取り込みのフロー向けのリソースとプロンプト

GitHub | ドキュメント | Smithery | 公式MCPレジストリ

タグ：multimodal-rag、gemini-rag、hosted-rag-mcp、mcp-server

エージェントやワークフローごとに使い捨てのドキュメント検索スタックを接続する代わりに、このMCPをエージェント向けの単一の再利用可能な回答レイヤーへの入口として利用できます。資料を一度アップロードすれば、テキストとビジュアルの両方から情報を取得し、ユーザーが検証できる根拠とともに回答を返します。

クイックスタート

# One-liner with npx
npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-your-key-here"

または、環境変数を使用します。

CALYPSO_API_KEY="sk-..." npx -y @calypsohq/multimodal-rag-mcp-server

その後、以下の設定例を使って、同じコマンドをClaude Desktop、Cursor、またはSmitheryに追加します。

Calypsoを選ぶ理由

ローカルのベクトルストアも、Docker Composeも、エージェントが根拠のある質問をする前に別途用意するOCRやビジョンのパイプラインも不要です。サーバーにCalypso APIキーを設定すると、接続時にチームのエージェントとナレッジバケットが自動的に検出されます。

• インフラ不要：npx コマンドを1つ実行するだけで、ホストや運用は不要です。
• 追加のパイプラインなしでマルチモーダルに対応：テキストとビジュアルをまとめてインデックス化するため、グラフやスクリーンショットも段落と同じように検索できます。
• 根拠付きの回答：回答にはソースへの参照と検索メタデータが含まれます。
• 読み取りと書き込み：同じサーバーから、ファイル、一括データ、ウェブサイトを対象にナレッジを検索し、追加できます。

利用できる機能

• 複数ターンのメモリを備えた、本番用のマルチモーダルCalypsoエージェント
• 単一ファイルとナレッジの一括アップロードに対応した組み込みのアップロードツール
• チームのRAGバリアントとナレッジバケットの自動検出
• ソースへの参照と検索メタデータを含む、検証可能な引用
• 安全なワークフロー向けの読み取り専用リソースと再利用可能なプロンプト

マルチモーダルを最優先する RAG の理由

企業のナレッジの大半は、テキストだけではありません。答えは、設定画面のスクリーンショット、PDF の表、製品図、ヘルプセンターのページ、レポート内のグラフなどにまたがっていることがよくあります。Calypso は、こうしたナレッジ全体を単一の検索レイヤーにまとめるため、エージェントは汎用的なモデルの記憶から推測することなく、根拠に基づいた質問ができます。

• ユーザーが実際に利用する形式を検索：ドキュメント、PDF、スクリーンショット、グラフ、図、製品画像、サポート記事、マニュアル、ポリシー、FAQ、レポート。
• モデルが回答を作成する前に根拠を示す：Gemini File Search がまず関連するテキストと視覚的なコンテキストを取得し、その後、Calypso エージェントがその資料に基づいて回答します。
• 根拠を確認できるようにする：回答には、信頼する前に確認できるよう、ソースへの参照、ページを考慮した根拠、検索メタデータを含められます。
• メタデータで検索範囲を絞る：ワークスペース、チーム、顧客、言語、ファイル形式、ステータスなどのメタデータを使うことで、ナレッジベースを重複させずに回答の関連性を保てます。
• 同じナレッジレイヤーをどこでも再利用：Cursor、Claude Desktop、AI エージェント、n8n ワークフロー、製品 UI、サポートフロー、ウェブサイトでの利用体験を、同じソースに基づくレイヤーに接続できます。

実際には、エージェントは次のような質問に回答できます。

• 「この設定画面のスクリーンショットと添付のポリシー PDF を説明してください。サポート担当者は次に何をすべきですか？」
• 「このオンボーディング PDF には、承認ルールについて何と書かれていますか？」
• 「この設定画面が失敗するのはなぜですか？」
• 「料金表とプランのドキュメントを比較し、適切なプランをおすすめしてください。」
• 「このサポートチケットに適用されるポリシーを要約してください。」
• 「料金に関するドキュメントに基づくと、この顧客に適した製品プランはどれですか？」
• 「図に示された取り込みフローと検索フローを比較してください。」

この MCP の機能

calypso-agent を使うと、次のことができます。

• 設定済みの Calypso ナレッジベースに基づいた質問をする
• 省略可能な model 引数を使って、検出されたチーム RAG の任意のバリアントを選択する
• ネイティブの /v1/responses 会話モデルを介して複数ターンの会話を続ける
• /new で会話のコンテキストをリセットする
• calypso-agent が使用するものと同じ OpenAI 互換の Responses エンドポイントを使う
• 対応する Calypso ワークフロー用の組み込みリソースとプロンプトを検出する

要件

• Node.js 18+
• サーバーは、API 呼び出しと SDK との互換性のために Web Fetch API のプリミティブ（fetch、Headers、Request、Response、FormData、Blob、File）を使用します。このパッケージは、Node 18+ の Web API の一部のみを公開する MCP ランタイム向けに、起動時に不足しているグローバルを初期化します。
• 次のエンドポイントを公開する Calypso API：
  • POST /v1/responses
  • GET /v1/rag-agent/models
  • GET /v1/knowledge/buckets
  • POST /v1/knowledge/files/upload-session
  • POST /v1/knowledge/files/upload-session/{session_id}/finalize
  • POST /v1/knowledge/files:batch/upload-session
  • POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize
  • GET /v1/knowledge/batches/{batch_id}
• Calypso API キー（sk-...）

設定

環境変数：

• CALYPSO_API_KEY（必須）
• CALYPSO_API_BASE_URL（省略可能。デフォルトは https://api.calypso.so/v1）

CLI フラグ：

• --api-key
• --api-base-url

設定の優先順位：

1. CLI フラグ／Smithery が指定するコマンド引数
2. 環境変数
3. デフォルトのベース URL（https://api.calypso.so/v1）

npx で実行

npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-..."

環境変数を使って実行

env CALYPSO_API_KEY="sk-..." CALYPSO_API_BASE_URL="https://api.calypso.so/v1" npx -y @calypsohq/multimodal-rag-mcp-server

Cursor で設定

次のように、新しい MCP サーバー（コマンドタイプ）を追加します。

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Claude Desktop で設定

1. Claude Desktop の MCP 設定を開く

Claude Desktop で：

Claude -> Settings -> Developer -> Edit Config

macOS では、通常、ファイルは次の場所にあります。

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop は、デスクトップの MCP サーバーに claude_desktop_config.json を使用します。Claude Code では、~/.claude.json やプロジェクトレベルの .mcp.json など、別の設定場所を使用します。

2. Calypso MCP サーバーを追加する

claude_desktop_config.json に以下を貼り付けます。

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    }
  }
}

次の値を置き換えます。

• sk-your-calypso-api-key

実際の Calypso API キーに置き換えてください。

3. Claude Desktop を完全に再起動する

Claude Desktop を完全に終了してから、再度開きます。

ウィンドウを閉じるだけでは不十分です。macOS の場合：

Cmd + Q

再起動後、Claude に次のツールを利用できる MCP が表示されます。

• calypso-agent
• calypso-list-buckets
• calypso-upload-file
• calypso-upload-files-batch

任意：Claude のアーティファクトを Mac に保存する

Calypso は、ホスト型のマルチモーダル RAG ツールを提供します。生成されたレポート、要約、CSV、JSON ファイル、ウェブ検索のアーティファクトをローカルコンピューターに直接書き込むことはありません。

Claude Desktop が生成ファイルをローカルに保存できるようにするには、Calypso と併せて標準のファイルシステム MCP サーバーを追加し、専用の安全なフォルダーにアクセスを制限します。

まず、フォルダーを作成します。

mkdir -p ~/Claude

次に、両方のサーバーを claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Claude"
      ]
    }
  }
}

設定を変更した後は、Claude Desktop を完全に終了してから再度開きます。

プロンプトの例：

Use Calypso for the grounded RAG answer, then save the final report as /Users/yourname/Claude/report.md using the filesystem tool.

安全のため、ホームディレクトリ全体ではなく、~/Claude のような専用フォルダーにのみファイルシステムへのアクセスを許可してください。

懸念事項	最適な担当
ソースに基づく RAG の回答	Calypso MCP
Calypso へのファイルのアップロード	Calypso MCP
.md、.pdf、.json、.csv などを Mac に書き込む	ファイルシステム MCP
Claude によるウェブ検索のアーティファクト	Claude とファイルシステム MCP のプロンプト

Smithery

このサーバーは Smithery で利用でき、デスクトップクライアントで使われるものと同じ npx パッケージのパスから起動します。

Smithery のユーザー設定：

• calypsoApiKey（必須）
• calypsoApiBaseUrl（任意。既定値は https://api.calypso.so/v1）

Smithery の起動方法は、次の方法と同等です。

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

セルフホストの Calypso 互換デプロイを対象とする場合にのみ、calypsoApiBaseUrl を使用してください。クラウドの既定値では、上書きは不要です。

トラブルシューティング

• API キーがない：--api-key または CALYPSO_API_KEY を指定してください
• API ホストが誤っている：--api-base-url／CALYPSO_API_BASE_URL が /v1 で終わっていることを確認してください
• セルフホストのデプロイ：https://api.calypso.so/v1 を使用していない場合にのみ、ベース URL を上書きしてください
• Smithery の起動方法が一致しない：新しいクローンから node dist/index.js を実行するのではなく、パッケージ化された npx -y @calypsohq/multimodal-rag-mcp-server のパスを使用してください
• FormData is not defined または Headers is not defined：最新のパッケージにアップグレードしてください。MCP サーバーは、アップロードツールの実行前に不足している Web Fetch API のグローバルを初期化します。
• /mnt/user-data/uploads/... で ENOENT が発生する：このパスはホスト型エージェントまたは添付ファイルのサンドボックスに属しており、MCP サーバーからアクセスできるとは限りません。filePath ではなく contentBase64 を使って再試行してください。
• ローカルへのアーティファクト保存：Calypso の回答は Claude Desktop のファイルシステム MCP サーバーと併用できますが、最終出力を許可されたローカルパスに保存するよう、Claude に明示的に指示する必要があります。

filePath と contentBase64 の選び方

Claude Desktop や、次のようなローカルコマンドでこのパッケージを起動する Cursor の設定など、ローカル MCP のインストールでは filePath を使用してください。

npx -y @calypsohq/multimodal-rag-mcp-server

この設定では、MCP サーバーのプロセスがマシン上で実行され、同じユーザーアカウントから利用できるパスを読み取れます。ローカルパスをそのまま渡してください。サーバーが生のバイトデータを読み取り、Calypso のアップロードセッション URL を通じてアップロードします。ローカルファイルを Base64 エンコードする必要はありません。

Smithery でホストされるサーバー、ブラウザー／クラウドのランタイム、生成されたメモリ内コンテンツ、エージェントのコンテナーなど、ホスト型またはリモートの MCP クライアントでは contentBase64 を使用してください。こうした環境では、Mac やワークステーション上のパスを MCP サーバーのプロセスから読み取れません。

パスが /mnt/user-data/uploads、/mnt/data、/mnt/attachments、またはその他のホスト型サンドボックスのプレフィックスで始まる場合、この MCP サーバーが同じサンドボックス内で実行されていない限り、filePath として送信しないでください。代わりに contentBase64 またはその他のインラインのバイトデータソースを使用してください。

利用可能なツール

calypso-agent

Calypso エージェントに直接アクセスします。

注意：

• 他のペルソナやエージェントへの自動ルーティングは行いません。
• 起動時に、API キーで利用可能な calypso-agent のバリアントを自動的に検出します。
• model 引数を指定すると、calypso-agent:pricing などの名前付きバリアントを選択できます。
• 各モデルバリアントは独自の MCP 会話チェーンを保持するため、バリアントを切り替えても別のスレッドが誤って継続されることはありません。
• POST /v1/chat/completions ではなく、POST /v1/responses を使用します。
• 最初のターンで名前付きの会話を作成し、後続のターンは previous_response_id で連結します。
• 検索対象を限定した質問には、オプションの fileIds を指定できます。新しいファイルをアップロードする場合は、永続的なナレッジアップロードツールを使用し、質問する前にインデックス作成が完了するのを待ってください。
• MCP の会話をリセットするには、プロンプトとして /new を使用します。

calypso-search

ナレッジを直接検索し、エージェントに回答を作成させずに、一致する箇所を返します。

文章ではなく根拠が必要な場合に使用します。たとえば、何かがインデックスに登録されているかどうかの確認、意思決定前の情報源の収集、呼び出し元のエージェントが該当箇所を独自に推論する場合などです。

注意：

• POST /v1/search を使用します。
• query は必須です。
• agent を指定すると、検索対象を特定のエージェントバリアントのナレッジに限定できます。buckets を指定すると、対象を特定のバケットに絞り込めます。
• maxResults は 1～20 の範囲に制限されます。

例：

{
  "query": "annual plan refund window",
  "buckets": ["support-handbook"],
  "maxResults": 5
}

calypso-list-buckets

設定された Calypso API キーに関連付けられたチームのバケットを一覧表示します。

注意：

• GET /v1/knowledge/buckets を使用します。
• team_id は受け付けません。チームの範囲は Calypso が API キーから判断します。
• バケット ID、スラッグ、名前、ステータス、メンバー数、ソース数、バケットストアの準備状況を返します。
• デフォルトではアクティブなバケットのみを返します。監査やクリーンアップのためにアーカイブ済みのバケットが必要な場合は、includeArchived: true を指定してください。
• アップロード先のバケットを選ぶ必要がある場合は、calypso-upload-file または calypso-upload-files-batch の前に使用してください。
• calypso://rag-agent-models は各 RAG バリアントに紐付けられたバケットを示します。calypso-list-buckets は API キーのチームに存在するバケットを示します。

例：

{
  "includeArchived": false
}

calypso-get-file

ファイル ID を指定して、1 つのナレッジファイルのメタデータとインデックス作成ステータスを取得します。

注意：

• GET /v1/knowledge/files/{file_id} を使用します。
• calypso-list-buckets の不透明な fileIds を、ファイル名、MIME タイプ、サイズ、インデックス作成ステータス、バケットごとの同期状態に解決します。
• プロバイダーと照合するには、verify: true を指定します（?verify=gemini）。処理は遅くなりますが、ステータスが古いように見える場合に正確な情報を確認できます。

例：

{
  "fileId": "file_123",
  "verify": true
}

calypso-add-website

ウェブサイトをナレッジバケットに取り込み、ページの内容をアップロード済みファイルと同様に検索できるようにします。

注意：

• POST /v1/knowledge/websites を使用します。
• url は必須で、保存先も必要です。bucketIds、bucketSlugs、bucket のいずれかを指定してください。
• オプションの title、tagsHint、preferredLanguage を指定すると、ソースの分類に役立ちます。
• 再試行を安全に行うには、idempotencyKey を指定します。この値は Idempotency-Key ヘッダーとして送信されます。
• ファイルのアップロードと同様に、受け付けられたことと検索可能になったことは同じではありません。ページのインデックス作成が完了する必要があります。

例：

{
  "url": "https://example.com/pricing",
  "bucket": "pricing",
  "title": "Public pricing page",
  "idempotencyKey": "pricing-page-2026-08"
}

calypso-create-bucket

作成してから内容を追加するワークフロー用に、空のバケットを作成します。

注意：

• POST /v1/knowledge/buckets を使用します（このエンドポイントがデプロイされ、API キーに knowledge:bucket:create の機能が必要です）。
• サーバーがスラッグを正規化します。重複がある場合は、型付きエラー bucket_slug_exists が返されます。
• idempotencyKey を使ったリクエストの再送ではエラーにならず、既存のバケットが返されます。
• bucketSlugs と createMissingBuckets を使ったアップロードでも、バケットを暗黙的に作成できます。このツールは、先に保存先を作成するためのものです。

例：

{
  "name": "Product docs",
  "slug": "product-docs",
  "idempotencyKey": "create-product-docs-1"
}

calypso-create-agent

1つ以上のバケットに紐づく Calypso エージェントのバリアントを作成します。

注意事項：

• POST /v1/rag-agent/agents を使用します（このエンドポイントがデプロイされており、API キーに rag:agent:create 機能があるバックエンドが必要です）。
• 成功時のペイロードでは先頭に model が含まれます。そのまま calypso-agent に渡してください。
• バケットへの紐付けはサーバー側で検証されます。不明またはアーカイブ済みのバケットでは bucket_not_found が返され、エージェント ID の重複では agent_id_exists が返されます。プランのエージェント上限に達した場合は agent_limit_reached が返されます。
• エージェントを作成するとモデルカタログが更新され、MCP の tools/list_changed と resources/list_changed 通知が送信されるため、再接続せずに新しいバリアントを使用できます。

例：

{
  "agentId": "support",
  "name": "Support agent",
  "bucketSlugs": ["product-docs"],
  "idempotencyKey": "create-support-agent-1"
}

calypso-upload-file

ファイルを永続的なバケットベースのナレッジストアとインデックス作成パイプラインにアップロードします。

注意事項：

• POST /v1/knowledge/files/upload-session を使用して、バイトデータをストレージに直接アップロードした後、POST /v1/knowledge/files/upload-session/{session_id}/finalize で確定します。
• アップロードでは JSON セッションリクエストと署名付きバイナリ PUT を使用し、マルチパートフォームアップロードは使用しません。
• チャット添付ファイルの file_id ではなく、ファイルとタスクのメタデータを返します。
• bucketIds、bucketSlugs、または bucket で、アップロード先のバケットを1つ指定する必要があります。
• サーバーがパスを読み取れるローカルの Claude Desktop／Cursor MCP インストールでは filePath を使用します。ローカルパスを読み取れないホステッドまたはリモートの MCP クライアントでは contentBase64 を使用します。
• エージェントに /mnt/user-data/uploads/file.pdf のようなパスが表示されても、それを filePath として送信してはいけません。ファイルのバイトデータを contentBase64 として送信してください。
• title、tags、metadata、idempotencyKey を任意で指定できます。
• bucketIds または bucketSlugs で既存のバケットにアップロードするか、単一のスラッグを指定するショートカットとして bucket を使用します。
• アップロード時に Calypso に不足している保存先を作成させる場合は、バケットスラッグとともに createMissingBuckets: true を渡します。
• 返される前にインデックス作成が準備完了状態になるまで、任意で待機できます。

例：

{
  "filename": "handbook.pdf",
  "mimeType": "application/pdf",
  "filePath": "/Users/me/Documents/handbook.pdf",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "waitForIndexing": true
}

calypso-upload-files-batch

永続的なナレッジストアに、1回のリクエストで1～100個のファイルをアップロードします。

注意事項：

• POST /v1/knowledge/files:batch/upload-session を使用して、受け付けられた各アイテムをストレージに直接アップロードした後、POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize で確定します。
• アップロードでは JSON セッションリクエストと署名付きバイナリ PUT を使用し、マルチパートフォームアップロードは使用しません。
• batchIdempotencyKey が必須です。Calypso はこれを使用して、再試行時に永続的なバッチ ID を導出します。
• すべてのアイテムがそれぞれアップロード先のバケットを指定する場合を除き、bucketIds、bucketSlugs、または bucket で共通のアップロード先バケットを指定する必要があります。
• 共通のデフォルト値として bucketIds、bucketSlugs、bucket、createMissingBuckets を指定でき、アイテムごとの上書きにも対応しています。
• サーバーが各パスを読み取れるローカルの Claude Desktop／Cursor MCP インストールでは、アイテムごとに filePath を使用します。ローカルパスを読み取れないホステッドまたはリモートの MCP クライアントでは、アイテムごとに contentBase64 を使用します。
• clientFileId が省略された場合、Firestore で安全に使用できる client_file_id 値を生成します。
• accepted または queued は、アップロードが永続化されたことを示しますが、必ずしもクエリ可能な状態であることを意味しません。waitForBatchReady: true を使用して、GET /v1/knowledge/batches/{batch_id}?include_items=true をポーリングしてください。
• アイテムごとのステータス、bucketSyncStatus、bucketSync を確認すると、インデックス済みのコンテンツとバケット対応済みの検索結果を区別できます。

例：

{
  "batchIdempotencyKey": "kb-seed-2026-06-04",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "items": [
    {
      "filename": "faq.txt",
      "mimeType": "text/plain",
      "filePath": "/Users/me/Documents/faq.txt"
    }
  ],
  "waitForBatchReady": true
}

利用可能なリソース

calypso://server-info

パッケージバージョン、API ベース URL、トランスポート、認証モデル、公開されている機能など、読み取り専用のサーバーメタデータです。

calypso://rag-agent-models

設定された API キーから検出された、チームスコープの calypso-agent モデルバリアントの読み取り専用ランタイムカタログです。各バリアントの有効な buckets、bucket_ids、missing_bucket_ids が含まれます。検出できない場合、このリソースはベースの calypso-agent にフォールバックします。

calypso://buckets

設定済みの API キーに関連付けられたチームのナレッジバケットを、読み取り専用で一覧表示します。バケット ID／スラッグの確認や、アップロード前のバケットストアの準備状況の確認に使用します。

calypso://workflows

対応している RAG とファイルアップロードのワークフローを簡潔に説明します。

calypso://security

API キー、ローカルファイルの読み取り、アップロード、ログ記録に関する運用上のセキュリティ情報です。

利用可能なプロンプト

• calypso-question：calypso-agent 向けに、ナレッジベースに基づく質問を作成します
• calypso-ingestion：永続的なナレッジストアへのアップロードと、その後のクエリを準備します
• calypso-reset-conversation：/new を使って、新しい RAG スレッドを開始します

よく使うワークフロー（コピーして貼り付け）

ナレッジの検索

• トピックを要約する：
  • Summarize the knowledge base guidance for campaign approvals
• 具体的な回答を尋ねる：
  • What does our documentation say about indexing retries?
• 2 つの概念を比較する：
  • Compare file indexing with retrieval execution in the current architecture
• 新しいスレッドを開始する：
  • /new

複数ターンでのフォローアップ

• 前の回答を絞り込む：
  • Focus only on the ingestion path and ignore retrieval
• 出典や根拠を尋ねる：
  • Explain which documented components are involved and why

ナレッジストアへのファイル登録フロー

• バケットを確認する：
  • 登録先を選ぶ前に、calypso-list-buckets を呼び出すか、calypso://buckets を読み取ります
• 永続的なナレッジをアップロードする：
  • ファイルのペイロードと、任意の title、tags、metadata を指定して calypso-upload-file を呼び出します
  • ローカルの Claude Desktop／Cursor MCP インストールでは filePath を使用してください。ローカルパスを読み取れないホスト型またはリモートの MCP クライアントでは contentBase64 を使用してください
• ナレッジをバケットに振り分ける：
  • 1 つの登録先には bucket: "support-handbook"、複数のスラッグベースの登録先には bucketSlugs、安定したバケット ID がすでに分かっている場合は bucketIds を使用します
• 必要に応じてバケットの登録先を作成する：
  • スラッグベースのバケット割り当てを使用し、登録先がまだ存在しない可能性がある場合は、createMissingBuckets: true を追加します
• インデックス作成を待つ：
  • ナレッジファイルのインデックス作成が完了するまでツールの処理を待機させる場合は、waitForIndexing: true を指定します

ナレッジストアへの一括登録フロー

• 複数の永続ファイルをアップロードする：
  • items、batchIdempotencyKey、およびローカル MCP インストールの場合は各項目の filePath を指定して calypso-upload-files-batch を呼び出します。ホスト型またはリモートの MCP クライアントでは、各項目に contentBase64 を使用します
• 一括登録の内容をバケットに振り分ける：
  • ツール呼び出しに共有の bucket、bucketSlugs、bucketIds、または createMissingBuckets を指定し、必要な場合にのみ項目ごとに上書きします
• クエリの準備完了を待つ：
  • waitForBatchReady: true を使用し、最新のコンテンツをクエリする前に、返された項目のステータスとバケットの同期フィールドを確認します

ヒント

• 最初からやり直す：/new を使用すると、MCP の会話をリセットできます（新しい conversation_id と、クリアされた応答チェーンが作成されます）。

バージョン履歴

バージョン	備考
3.0.0	破壊的変更。 レガシーの calypso-rag-agent モデル ID のサポートを削除しました。認識されない ID は正規のファミリーに書き換えられず、エラーになります。calypso-search と calypso-add-website を文書化し、calypso-add-website が抜けていた calypso://server-info を修正しました。
2.4.0	質問ツールの名前を calypso-rag-agent から calypso-agent に変更しました。モデルカタログのデフォルト値は、ハードコードされた定数ではなく、検出結果から取得するようになりました。
2.3.x	検索のリリースと、その後の修正です。

詳細は CHANGELOG.md を参照してください。

3.0.0 へのアップグレード

2.4.0 と 3.0.0 にかけて、2 つの名称変更が行われました。どちらも別名は用意されていません。

• ask ツールは calypso-agent です（以前は calypso-rag-agent）。MCP クライアントは次回の tools/list でこれを取得しますが、ツール名を文字列で指定している保存済みのプロンプト、エージェントへの指示、ドキュメントは更新が必要です。
• モデル ID は正規の形式で指定する必要があります。 calypso-rag-agent と calypso-rag-agent:{id} が calypso-agent[:{id}] に書き換えられることはなくなりました。これらを渡すと Unknown Calypso agent model エラーが発生し、有効な ID の確認先として calypso://rag-agent-models が示されます。そのリソースを読み込むか、検出されたデフォルトを使用するには model を省略してください。

calypso://rag-agent-models リソース URI は意図的に変更されていません。これは公開されたアドレスであり、互換性を保つための仕組みではありません。